google-api-python-client 2.107.0__py2.py3-none-any.whl → 2.109.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/cloudtasks.v2.json

@@ -563,6 +563,41 @@
               "resources": {
                 "tasks": {
                   "methods": {
+                    "buffer": {
+                      "description": "Creates and buffers a new task without the need to explicitly define a Task message. The queue must have HTTP target. To create the task with a custom ID, use the following format and set TASK_ID to your desired ID: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID:buffer To create the task with an automatically generated ID, use the following format: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks:buffer.",
+                      "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks/{taskId}:buffer",
+                      "httpMethod": "POST",
+                      "id": "cloudtasks.projects.locations.queues.tasks.buffer",
+                      "parameterOrder": [
+                        "queue",
+                        "taskId"
+                      ],
+                      "parameters": {
+                        "queue": {
+                          "description": "Required. The parent queue name. For example: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` The queue must already exist.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/locations/[^/]+/queues/[^/]+$",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "taskId": {
+                          "description": "Optional. Task ID for the task being created. If not provided, Cloud Tasks generates an ID for the task.",
+                          "location": "path",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "path": "v2/{+queue}/tasks/{taskId}:buffer",
+                      "request": {
+                        "$ref": "BufferTaskRequest"
+                      },
+                      "response": {
+                        "$ref": "BufferTaskResponse"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform"
+                      ]
+                    },
                     "create": {
                       "description": "Creates a task and adds it to a queue. Tasks cannot be updated after creation; there is no UpdateTask command. * The maximum task size is 100KB.",
                       "flatPath": "v2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}/tasks",
@@ -744,7 +779,7 @@
       }
     }
   },
-  "revision": "20231018",
+  "revision": "20231103",
   "rootUrl": "https://cloudtasks.googleapis.com/",
   "schemas": {
     "AppEngineHttpRequest": {
@@ -869,6 +904,28 @@
       },
       "type": "object"
     },
+    "BufferTaskRequest": {
+      "description": "Request message for BufferTask.",
+      "id": "BufferTaskRequest",
+      "properties": {
+        "body": {
+          "$ref": "HttpBody",
+          "description": "Optional. Body of the HTTP request. The body can take any generic value. The value is written to the HttpRequest of the [Task]."
+        }
+      },
+      "type": "object"
+    },
+    "BufferTaskResponse": {
+      "description": "Response message for BufferTask.",
+      "id": "BufferTaskResponse",
+      "properties": {
+        "task": {
+          "$ref": "Task",
+          "description": "The created task."
+        }
+      },
+      "type": "object"
+    },
     "CmekConfig": {
       "description": "Describes the customer-managed encryption key (CMEK) configuration associated with a project and location.",
       "id": "CmekConfig",
@@ -962,6 +1019,59 @@
       },
       "type": "object"
     },
+    "Header": {
+      "description": "Defines a header message. A header can have a key and a value.",
+      "id": "Header",
+      "properties": {
+        "key": {
+          "description": "The Key of the header.",
+          "type": "string"
+        },
+        "value": {
+          "description": "The Value of the header.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "HeaderOverride": {
+      "description": "Wraps the Header object.",
+      "id": "HeaderOverride",
+      "properties": {
+        "header": {
+          "$ref": "Header",
+          "description": "header embodying a key and a value."
+        }
+      },
+      "type": "object"
+    },
+    "HttpBody": {
+      "description": "Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page. This message can be used both in streaming and non-streaming API methods in the request as well as the response. It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body. Example: message GetResourceRequest { // A unique request id. string request_id = 1; // The raw HTTP body is bound to this field. google.api.HttpBody http_body = 2; } service ResourceService { rpc GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); } Example with streaming methods: service CaldavService { rpc GetCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream google.api.HttpBody) returns (stream google.api.HttpBody); } Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.",
+      "id": "HttpBody",
+      "properties": {
+        "contentType": {
+          "description": "The HTTP Content-Type header value specifying the content type of the body.",
+          "type": "string"
+        },
+        "data": {
+          "description": "The HTTP request/response body as raw binary.",
+          "format": "byte",
+          "type": "string"
+        },
+        "extensions": {
+          "description": "Application specific response metadata. Must be set in the first response for streaming APIs.",
+          "items": {
+            "additionalProperties": {
+              "description": "Properties of the object. Contains field @type with type URL.",
+              "type": "any"
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "HttpRequest": {
       "description": "HTTP request. The task will be pushed to the worker as an HTTP request. If the worker or the redirected worker acknowledges the task by returning a successful HTTP response code ([`200` - `299`]), the task will be removed from the queue. If any other HTTP response code is returned or no response is received, the task will be retried according to the following: * User-specified throttling: retry configuration, rate limits, and the queue's state. * System throttling: To prevent the worker from overloading, Cloud Tasks may temporarily reduce the queue's effective rate. User-specified settings will not be changed. System throttling happens because: * Cloud Tasks backs off on all errors. Normally the backoff specified in rate limits will be used. But if the worker returns `429` (Too Many Requests), `503` (Service Unavailable), or the rate of errors is high, Cloud Tasks will use a higher backoff rate. The retry specified in the `Retry-After` HTTP response header is considered. * To prevent traffic spikes and to smooth sudden increases in traffic, dispatches ramp up slowly when the queue is newly created or idle and if large numbers of tasks suddenly become available to dispatch (due to spikes in create task rates, the queue being unpaused, or many tasks that are scheduled at the same time).",
       "id": "HttpRequest",
@@ -1017,6 +1127,56 @@
       },
       "type": "object"
     },
+    "HttpTarget": {
+      "description": "HTTP target. When specified as a Queue, all the tasks with [HttpRequest] will be overridden according to the target.",
+      "id": "HttpTarget",
+      "properties": {
+        "headerOverrides": {
+          "description": "HTTP target headers. This map contains the header field names and values. Headers will be set when running the CreateTask and/or BufferTask. These headers represent a subset of the headers that will be configured for the task's HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: * Several predefined headers, prefixed with \"X-CloudTasks-\", can be used to define properties of the task. * Host: This will be computed by Cloud Tasks and derived from HttpRequest.url. * Content-Length: This will be computed by Cloud Tasks. `Content-Type` won't be set by Cloud Tasks. You can explicitly set `Content-Type` to a media type when the task is created. For example,`Content-Type` can be set to `\"application/octet-stream\"` or `\"application/json\"`. The default value is set to \"application/json\"`. * User-Agent: This will be set to `\"Google-Cloud-Tasks\"`. Headers which can have multiple values (according to RFC2616) can be specified using comma-separated values. The size of the headers must be less than 80KB. Queue-level headers to override headers of all the tasks in the queue.",
+          "items": {
+            "$ref": "HeaderOverride"
+          },
+          "type": "array"
+        },
+        "httpMethod": {
+          "description": "The HTTP method to use for the request. When specified, it overrides HttpRequest for the task. Note that if the value is set to HttpMethod the HttpRequest of the task will be ignored at execution time.",
+          "enum": [
+            "HTTP_METHOD_UNSPECIFIED",
+            "POST",
+            "GET",
+            "HEAD",
+            "PUT",
+            "DELETE",
+            "PATCH",
+            "OPTIONS"
+          ],
+          "enumDescriptions": [
+            "HTTP method unspecified",
+            "HTTP POST",
+            "HTTP GET",
+            "HTTP HEAD",
+            "HTTP PUT",
+            "HTTP DELETE",
+            "HTTP PATCH",
+            "HTTP OPTIONS"
+          ],
+          "type": "string"
+        },
+        "oauthToken": {
+          "$ref": "OAuthToken",
+          "description": "If specified, an [OAuth token](https://developers.google.com/identity/protocols/OAuth2) will be generated and attached as the `Authorization` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com."
+        },
+        "oidcToken": {
+          "$ref": "OidcToken",
+          "description": "If specified, an [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect) token will be generated and attached as an `Authorization` header in the HTTP request. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself."
+        },
+        "uriOverride": {
+          "$ref": "UriOverride",
+          "description": "URI override. When specified, overrides the execution URI for all the tasks in the queue."
+        }
+      },
+      "type": "object"
+    },
     "ListLocationsResponse": {
       "description": "The response message for Locations.ListLocations.",
       "id": "ListLocationsResponse",
@@ -1135,6 +1295,17 @@
       },
       "type": "object"
     },
+    "PathOverride": {
+      "description": "PathOverride. Path message defines path override for HTTP targets.",
+      "id": "PathOverride",
+      "properties": {
+        "path": {
+          "description": "The URI path (e.g., /users/1234). Default is an empty string.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "PauseQueueRequest": {
       "description": "Request message for PauseQueue.",
       "id": "PauseQueueRequest",
@@ -1171,6 +1342,17 @@
       "properties": {},
       "type": "object"
     },
+    "QueryOverride": {
+      "description": "QueryOverride. Query message defines query override for HTTP targets.",
+      "id": "QueryOverride",
+      "properties": {
+        "queryParams": {
+          "description": "The query parameters (e.g., qparam1=123&qparam2=456). Default is an empty string.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "Queue": {
       "description": "A queue is a container of related tasks. Queues are configured to manage how those tasks are dispatched. Configurable properties include rate limits, retry options, queue types, and others.",
       "id": "Queue",
@@ -1179,6 +1361,10 @@
           "$ref": "AppEngineRouting",
           "description": "Overrides for task-level app_engine_routing. These settings apply only to App Engine tasks in this queue. Http tasks are not affected. If set, `app_engine_routing_override` is used for all App Engine tasks in the queue, no matter what the setting is for the task-level app_engine_routing."
         },
+        "httpTarget": {
+          "$ref": "HttpTarget",
+          "description": "Modifies HTTP target for HTTP tasks."
+        },
         "name": {
           "description": "Caller-specified and required in CreateQueue, after which it becomes output only. The queue name. The queue name must have the following format: `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) * `LOCATION_ID` is the canonical ID for the queue's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/about/locations/. * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters.",
           "type": "string"
@@ -1443,6 +1629,58 @@
         }
       },
       "type": "object"
+    },
+    "UriOverride": {
+      "description": "URI Override. When specified, all the HTTP tasks inside the queue will be partially or fully overridden depending on the configured values.",
+      "id": "UriOverride",
+      "properties": {
+        "host": {
+          "description": "Host override. When specified, replaces the host part of the task URL. For example, if the task URL is \"https://www.google.com,\" and host value is set to \"example.net\", the overridden URI will be changed to \"https://example.net.\" Host value cannot be an empty string (INVALID_ARGUMENT).",
+          "type": "string"
+        },
+        "pathOverride": {
+          "$ref": "PathOverride",
+          "description": "URI path. When specified, replaces the existing path of the task URL. Setting the path value to an empty string clears the URI path segment."
+        },
+        "port": {
+          "description": "Port override. When specified, replaces the port part of the task URI. For instance, for a URI http://www.google.com/foo and port=123, the overridden URI becomes http://www.google.com:123/foo. Note that the port value must be a positive integer. Setting the port to 0 (Zero) clears the URI port.",
+          "format": "int64",
+          "type": "string"
+        },
+        "queryOverride": {
+          "$ref": "QueryOverride",
+          "description": "URI query. When specified, replaces the query part of the task URI. Setting the query value to an empty string clears the URI query segment."
+        },
+        "scheme": {
+          "description": "Scheme override. When specified, the task URI scheme is replaced by the provided value (HTTP or HTTPS).",
+          "enum": [
+            "SCHEME_UNSPECIFIED",
+            "HTTP",
+            "HTTPS"
+          ],
+          "enumDescriptions": [
+            "Scheme unspecified. Defaults to HTTPS.",
+            "Convert the scheme to HTTP, e.g., https://www.google.ca will change to http://www.google.ca.",
+            "Convert the scheme to HTTPS, e.g., http://www.google.ca will change to https://www.google.ca."
+          ],
+          "type": "string"
+        },
+        "uriOverrideEnforceMode": {
+          "description": "URI Override Enforce Mode When specified, determines the Target UriOverride mode. If not specified, it defaults to ALWAYS.",
+          "enum": [
+            "URI_OVERRIDE_ENFORCE_MODE_UNSPECIFIED",
+            "IF_NOT_EXISTS",
+            "ALWAYS"
+          ],
+          "enumDescriptions": [
+            "UriOverrideEnforceMode Unspecified. Defaults to ALWAYS.",
+            "In the IF_NOT_EXISTS mode, queue-level configuration is only applied where task-level configuration does not exist.",
+            "In the ALWAYS mode, queue-level configuration overrides all task-level configuration"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
     }
   },
   "servicePath": "",

googleapiclient/discovery_cache/documents/cloudtasks.v2beta2.json

@@ -935,7 +935,7 @@
       }
     }
   },
-  "revision": "20231018",
+  "revision": "20231103",
   "rootUrl": "https://cloudtasks.googleapis.com/",
   "schemas": {
     "AcknowledgeTaskRequest": {

googleapiclient/discovery_cache/documents/cloudtasks.v2beta3.json

@@ -791,7 +791,7 @@
       }
     }
   },
-  "revision": "20231018",
+  "revision": "20231103",
   "rootUrl": "https://cloudtasks.googleapis.com/",
   "schemas": {
     "AppEngineHttpQueue": {

googleapiclient/discovery_cache/documents/cloudtrace.v1.json

@@ -257,7 +257,7 @@
       }
     }
   },
-  "revision": "20231031",
+  "revision": "20231109",
   "rootUrl": "https://cloudtrace.googleapis.com/",
   "schemas": {
     "Empty": {

googleapiclient/discovery_cache/documents/cloudtrace.v2.json

@@ -181,7 +181,7 @@
       }
     }
   },
-  "revision": "20231031",
+  "revision": "20231109",
   "rootUrl": "https://cloudtrace.googleapis.com/",
   "schemas": {
     "Annotation": {

googleapiclient/discovery_cache/documents/cloudtrace.v2beta1.json

@@ -273,7 +273,7 @@
       }
     }
   },
-  "revision": "20231031",
+  "revision": "20231109",
   "rootUrl": "https://cloudtrace.googleapis.com/",
   "schemas": {
     "Empty": {

googleapiclient/discovery_cache/documents/composer.v1.json

@@ -599,7 +599,7 @@
       }
     }
   },
-  "revision": "20231029",
+  "revision": "20231105",
   "rootUrl": "https://composer.googleapis.com/",
   "schemas": {
     "AllowedIpRange": {

googleapiclient/discovery_cache/documents/composer.v1beta1.json

@@ -655,7 +655,7 @@
       }
     }
   },
-  "revision": "20231029",
+  "revision": "20231105",
   "rootUrl": "https://composer.googleapis.com/",
   "schemas": {
     "AllowedIpRange": {

googleapiclient/discovery_cache/documents/compute.alpha.json

@@ -11328,6 +11328,11 @@
               "required": true,
               "type": "string"
             },
+            "noGracefulShutdown": {
+              "description": "If true, skips Graceful Shutdown.",
+              "location": "query",
+              "type": "boolean"
+            },
             "project": {
               "description": "Project ID for this request.",
               "location": "path",
@@ -13385,6 +13390,11 @@
               "required": true,
               "type": "string"
             },
+            "noGracefulShutdown": {
+              "description": "If true, skips Graceful Shutdown.",
+              "location": "query",
+              "type": "boolean"
+            },
             "project": {
               "description": "Project ID for this request.",
               "location": "path",
@@ -43542,7 +43552,7 @@
       }
     }
   },
-  "revision": "20231024",
+  "revision": "20231110",
   "rootUrl": "https://compute.googleapis.com/",
   "schemas": {
     "AWSV4Signature": {
@@ -52704,7 +52714,7 @@
           "type": "string"
         },
         "allPorts": {
-          "description": "This field can only be used: - If IPProtocol is one of TCP, UDP, or SCTP. - By internal TCP/UDP load balancers, backend service-based 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 ports, port_range, and allPorts fields are mutually exclusive.",
+          "description": "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 requires allPorts be set to true. ",
           "type": "boolean"
         },
         "allowGlobalAccess": {
@@ -52843,11 +52853,11 @@
           "type": "boolean"
         },
         "portRange": {
-          "description": "This field can only be used: - If IPProtocol is one of TCP, UDP, or SCTP. - By backend service-based network load balancers, target pool-based network load balancers, internal proxy load balancers, external proxy load balancers, Traffic Director, external protocol forwarding, and Classic VPN. Some products have restrictions on what ports can be used. See port specifications for details. Only packets addressed to ports in the specified range will be forwarded to the backends configured with this forwarding rule. The ports, port_range, and allPorts fields are mutually exclusive. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot 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+)?",
+          "description": "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, and cannot 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+)?",
           "type": "string"
         },
         "ports": {
-          "description": "This field can only be used: - If IPProtocol is one of TCP, UDP, or SCTP. - By internal TCP/UDP load balancers, backend service-based 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. Only packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. For external forwarding rules, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot share any values defined in ports. For internal forwarding rules within the same VPC network, two or more forwarding rules cannot use the same [IPAddress, IPProtocol] pair, and cannot share any values defined in ports. The ports, port_range, and allPorts fields are mutually exclusive. @pattern: \\\\d+(?:-\\\\d+)?",
+          "description": "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 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+)?",
           "items": {
             "type": "string"
           },
@@ -58253,13 +58263,11 @@
           "description": "The unit of measure for the target size.",
           "enum": [
             "INSTANCE",
-            "VCPU",
-            "VM"
+            "VCPU"
           ],
           "enumDescriptions": [
             "[Default] TargetSize is the target number of instances.",
-            "TargetSize is the target count of vCPUs of VMs.",
-            "TargetSize is the target number of VMs. Deprecated in favor of 'INSTANCE'."
+            "TargetSize is the target count of vCPUs of VMs."
           ],
           "type": "string"
         },
@@ -58864,7 +58872,7 @@
         },
         "requestedRunDuration": {
           "$ref": "Duration",
-          "description": "Requested run duration for instances that will be created by this request. If specified, the instance termination action will be performed at the end of the run duration."
+          "description": "Requested run duration for instances that will be created by this request. At 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 target size will be increased by this number.",
@@ -74208,7 +74216,7 @@
           "type": "string"
         },
         "managedProtectionTier": {
-          "description": "[Output Only] The Cloud Armor Managed Protection (CAMP) tier for this project. It can be one of the following values: CA_STANDARD, CAMP_PLUS_MONTHLY. If this field is not specified, it is assumed to be CA_STANDARD.",
+          "description": "[Output Only] The Cloud Armor Managed Protection (CAMP) tier for this project. It can be one of the following values: CA_STANDARD, CAMP_PLUS_PAYGO. If this field is not specified, it is assumed to be CA_STANDARD.",
           "enum": [
             "CAMP_PLUS_ANNUAL",
             "CAMP_PLUS_PAYGO",
@@ -79675,6 +79683,13 @@
           },
           "description": "[Output Only] Represents the status of the service integration specs defined by the user in instance.serviceIntegrationSpecs.",
           "type": "object"
+        },
+        "shutdownDetails": {
+          "$ref": "ResourceStatusShutdownDetails",
+          "description": "[Output Only] Details about stopping state of instance"
+        },
+        "upcomingMaintenance": {
+          "$ref": "UpcomingMaintenance"
         }
       },
       "type": "object"
@@ -79697,7 +79712,6 @@
             "PREEMPTED",
             "SCHEDULED_STOP",
             "SHUTDOWN_DUE_TO_MAINTENANCE",
-            "UNSPECIFIED_TERMINATION_REASON",
             "USER_TERMINATED"
           ],
           "enumDescriptions": [
@@ -79713,7 +79727,6 @@
             "Terminated due to preemption",
             "Terminated due to scheduled stop",
             "Terminated due to maintenance",
-            "The termination reason is not specified",
             "Terminated by user"
           ],
           "type": "string"
@@ -79775,6 +79788,45 @@
       },
       "type": "object"
     },
+    "ResourceStatusShutdownDetails": {
+      "description": "Specifies if the instance is in `SHUTTING_DOWN` state or there is a instance stopping scheduled.",
+      "id": "ResourceStatusShutdownDetails",
+      "properties": {
+        "maxDuration": {
+          "$ref": "Duration",
+          "description": "Duration for graceful shutdown. Only applicable when `stop_state=SHUTTING_DOWN`."
+        },
+        "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": [
+            "SHUTTING_DOWN",
+            "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"
+    },
     "RolloutPolicy": {
       "description": "A rollout policy configuration.",
       "id": "RolloutPolicy",
@@ -82488,6 +82540,9 @@
           "format": "int64",
           "type": "string"
         },
+        "gracefulShutdown": {
+          "$ref": "SchedulingGracefulShutdown"
+        },
         "hostErrorTimeoutSeconds": {
           "description": "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.",
           "format": "int32",
@@ -82589,6 +82644,21 @@
       },
       "type": "object"
     },
+    "SchedulingGracefulShutdown": {
+      "description": "Configuration for gracefully shutting down the instance.",
+      "id": "SchedulingGracefulShutdown",
+      "properties": {
+        "enabled": {
+          "description": "Opts-in for graceful shutdown.",
+          "type": "boolean"
+        },
+        "maxDuration": {
+          "$ref": "Duration",
+          "description": "Specifies time needed to gracefully shut down the instance. After that time, the instance goes to STOPPING even if graceful shutdown is not completed."
+        }
+      },
+      "type": "object"
+    },
     "SchedulingNodeAffinity": {
       "description": "Node Affinity: the configuration of desired nodes onto which this Instance could be scheduled.",
       "id": "SchedulingNodeAffinity",