Debian Codegraph @

docs/dyn/compute_alpha.instanceGroupManagers.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.instanceGroupManagers.html">instanceGroupManagers</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#abandonInstances">abandonInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Flags the specified instances to be removed from the</p>
80 <p class="toc_element">
81 <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Retrieves the list of managed instance groups and groups them by zone.</p>
83 <p class="toc_element">
84 <code><a href="#aggregatedList_next">aggregatedList_next()</a></code></p>
85 <p class="firstline">Retrieves the next page of results.</p>
86 <p class="toc_element">
87 <code><a href="#applyUpdatesToInstances">applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Applies changes to selected instances on the managed instance group.</p>
89 <p class="toc_element">
90 <code><a href="#close">close()</a></code></p>
91 <p class="firstline">Close httplib2 connections.</p>
92 <p class="toc_element">
93 <code><a href="#configureAcceleratorTopologies">configureAcceleratorTopologies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Updates the accelerator topologies configuration.</p>
95 <p class="toc_element">
96 <code><a href="#createInstances">createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Creates instances with per-instance configurations in this managed instance</p>
98 <p class="toc_element">
99 <code><a href="#delete">delete(project, zone, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Deletes the specified managed instance group and all of the instances</p>
101 <p class="toc_element">
102 <code><a href="#deleteInstances">deleteInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Flags the specified instances in the managed instance group for immediate</p>
104 <p class="toc_element">
105 <code><a href="#deletePerInstanceConfigs">deletePerInstanceConfigs(project, zone, instanceGroupManager, body=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Deletes selected per-instance configurations for the managed instance</p>
107 <p class="toc_element">
108 <code><a href="#get">get(project, zone, instanceGroupManager, x__xgafv=None)</a></code></p>
109 <p class="firstline">Returns all of the details about the specified managed instance group.</p>
110 <p class="toc_element">
111 <code><a href="#getAvailableAcceleratorTopologies">getAvailableAcceleratorTopologies(project, zone, resourceId, x__xgafv=None)</a></code></p>
112 <p class="firstline">Returns information about available accelerator topologies for a given MIG.</p>
113 <p class="toc_element">
114 <code><a href="#insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Creates a managed instance group using the information that you specify</p>
116 <p class="toc_element">
117 <code><a href="#list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Retrieves a list of managed instance groups that are contained within the</p>
119 <p class="toc_element">
120 <code><a href="#listErrors">listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
121 <p class="firstline">Lists all errors thrown by actions on instances for a given managed</p>
122 <p class="toc_element">
123 <code><a href="#listErrors_next">listErrors_next()</a></code></p>
124 <p class="firstline">Retrieves the next page of results.</p>
125 <p class="toc_element">
126 <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
127 <p class="firstline">Lists all of the instances in the managed instance group. Each instance</p>
128 <p class="toc_element">
129 <code><a href="#listManagedInstances_next">listManagedInstances_next()</a></code></p>
130 <p class="firstline">Retrieves the next page of results.</p>
131 <p class="toc_element">
132 <code><a href="#listPerInstanceConfigs">listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
133 <p class="firstline">Lists all of the per-instance configurations defined for the managed</p>
134 <p class="toc_element">
135 <code><a href="#listPerInstanceConfigs_next">listPerInstanceConfigs_next()</a></code></p>
136 <p class="firstline">Retrieves the next page of results.</p>
137 <p class="toc_element">
138 <code><a href="#list_next">list_next()</a></code></p>
139 <p class="firstline">Retrieves the next page of results.</p>
140 <p class="toc_element">
141 <code><a href="#patch">patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
142 <p class="firstline">Updates a managed instance group using the information that you specify</p>
143 <p class="toc_element">
144 <code><a href="#patchPerInstanceConfigs">patchPerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
145 <p class="firstline">Inserts or patches per-instance configurations for the managed instance</p>
146 <p class="toc_element">
147 <code><a href="#recreateInstances">recreateInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
148 <p class="firstline">Flags the specified VM instances in the managed instance group to be</p>
149 <p class="toc_element">
150 <code><a href="#resize">resize(project, zone, instanceGroupManager, size, requestId=None, x__xgafv=None)</a></code></p>
151 <p class="firstline">Resizes the managed instance group. If you increase the size, the group</p>
152 <p class="toc_element">
153 <code><a href="#resizeAdvanced">resizeAdvanced(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
154 <p class="firstline">Resizes the managed instance group with advanced configuration options like</p>
155 <p class="toc_element">
156 <code><a href="#resumeInstances">resumeInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
157 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
158 <p class="toc_element">
159 <code><a href="#setAutoHealingPolicies">setAutoHealingPolicies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
160 <p class="firstline">Motifies the autohealing policy for the instances in this managed</p>
161 <p class="toc_element">
162 <code><a href="#setInstanceTemplate">setInstanceTemplate(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
163 <p class="firstline">Specifies the instance template to use when creating new instances in this</p>
164 <p class="toc_element">
165 <code><a href="#setTargetPools">setTargetPools(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
166 <p class="firstline">Modifies the target pools to which all instances in this managed instance</p>
167 <p class="toc_element">
168 <code><a href="#startInstances">startInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
169 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
170 <p class="toc_element">
171 <code><a href="#stopInstances">stopInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
172 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
173 <p class="toc_element">
174 <code><a href="#suspendInstances">suspendInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
175 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
176 <p class="toc_element">
177 <code><a href="#testIamPermissions">testIamPermissions(project, zone, resource, body=None, x__xgafv=None)</a></code></p>
178 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
179 <p class="toc_element">
180 <code><a href="#update">update(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
181 <p class="firstline">Updates a managed instance group using the information that you specify</p>
182 <p class="toc_element">
183 <code><a href="#updatePerInstanceConfigs">updatePerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
184 <p class="firstline">Inserts or updates per-instance configurations for the managed instance</p>
185 <h3>Method Details</h3>
186 <div class="method">
187 <code class="details" id="abandonInstances">abandonInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
188 <pre>Flags the specified instances to be removed from the
189 managed instance group. Abandoning an instance does not delete the
190 instance, but it does remove the instance from any target pools that are
191 applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
192 number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
193 not yet been removed from the group. You must separately verify the
194 status of the abandoning action with thelistmanagedinstances
195 method.
196
197 If the group is part of a backend
198 service that has enabled
199 connection draining, it can take up to 60 seconds after the connection
200 draining duration has elapsed before the VM instance is removed or deleted.
201
202 You can specify a maximum of 1000 instances with this method per request.
203
204 Args:
205 project: string, Project ID for this request. (required)
206 zone: string, The name of thezone where the managed
207 instance group is located. (required)
208 instanceGroupManager: string, The name of the managed instance group. (required)
209 body: object, The request body.
210 The object takes the form of:
211
212 {
213 &quot;instances&quot;: [ # The URLs of one or more instances to abandon. This can be a full URL or
214 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
215 &quot;A String&quot;,
216 ],
217 }
218
219 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
220 that if you must retry your request, the server will know to ignore the
221 request if it has already been completed.
222
223 For example, consider a situation where you make an initial request and
224 the request times out. If you make the request again with the same
225 request ID, the server can check if original operation with the same
226 request ID was received, and if so, will ignore the second request. This
227 prevents clients from accidentally creating duplicate commitments.
228
229 The request ID must be
230 a valid UUID with the exception that zero UUID is not supported
231 (00000000-0000-0000-0000-000000000000).
232 x__xgafv: string, V1 error format.
233 Allowed values
234 1 - v1 error format
235 2 - v2 error format
236
237 Returns:
238 An object of the form:
239
240 { # Represents an Operation resource.
241 #
242 # Google Compute Engine has three Operation resources:
243 #
244 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
245 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
246 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
247 #
248 # You can use an operation resource to manage asynchronous API requests.
249 # For more information, readHandling
250 # API responses.
251 #
252 # Operations can be global, regional or zonal.
253 #
254 # - For global operations, use the `globalOperations`
255 # resource.
256 # - For regional operations, use the
257 # `regionOperations` resource.
258 # - For zonal operations, use
259 # the `zoneOperations` resource.
260 #
261 #
262 #
263 # For more information, read
264 # Global, Regional, and Zonal Resources.
265 #
266 # Note that completed Operation resources have a limited
267 # retention period.
268 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
269 # Not present otherwise.
270 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
271 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
272 # set when the operation is created.
273 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
274 # text format.
275 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
276 # this field will be populated.
277 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
278 # operation.
279 {
280 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
281 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
282 # details. There is a set of defined message types to use for providing
283 # details.The syntax depends on the error code. For example,
284 # QuotaExceededInfo will have details when the error code is
285 # QUOTA_EXCEEDED.
286 {
287 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
288 #
289 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
290 # is not enabled:
291 #
292 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
293 # &quot;domain&quot;: &quot;googleapis.com&quot;
294 # &quot;metadata&quot;: {
295 # &quot;resource&quot;: &quot;projects/123&quot;,
296 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
297 # }
298 # }
299 #
300 # This response indicates that the pubsub.googleapis.com API is not enabled.
301 #
302 # Example of an error that is returned when attempting to create a Spanner
303 # instance in a region that is out of stock:
304 #
305 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
306 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
307 # &quot;metadata&quot;: {
308 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
309 # }
310 # }
311 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
312 # is typically the registered service name of the tool or product that
313 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
314 # generated by some common infrastructure, the error domain must be a
315 # globally unique value that identifies the infrastructure. For Google API
316 # infrastructure, the error domain is &quot;googleapis.com&quot;.
317 &quot;metadatas&quot;: { # Additional structured details about this error.
318 #
319 # Keys must match a regular expression of `a-z+` but should
320 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
321 # length. When identifying the current value of an exceeded limit, the units
322 # should be contained in the key, not the value. For example, rather than
323 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
324 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
325 # instances that can be created in a single (batch) request.
326 &quot;a_key&quot;: &quot;A String&quot;,
327 },
328 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
329 # proximate cause of the error. Error reasons are unique within a particular
330 # domain of errors. This should be at most 63 characters and match a
331 # regular expression of `A-Z+[A-Z0-9]`, which represents
332 # UPPER_SNAKE_CASE.
333 },
334 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
335 #
336 # For example, if a quota check failed with an error indicating the calling
337 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
338 # directly to the right place in the developer console to flip the bit.
339 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
340 { # Describes a URL link.
341 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
342 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
343 },
344 ],
345 },
346 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
347 # which can be attached to an RPC error.
348 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
349 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
350 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
351 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
352 },
353 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
354 &quot;dimensions&quot;: { # The map holding related quota dimensions.
355 &quot;a_key&quot;: &quot;A String&quot;,
356 },
357 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
358 # type or metric.
359 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
360 # or metric.
361 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
362 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
363 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
364 },
365 },
366 ],
367 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
368 # This property is optional.
369 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
370 },
371 ],
372 },
373 &quot;getVersionOperationMetadata&quot;: {
374 &quot;inlineSbomInfo&quot;: {
375 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
376 # appropriate identifiers.
377 &quot;a_key&quot;: &quot;A String&quot;,
378 },
379 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
380 # identifiers.
381 &quot;a_key&quot;: &quot;A String&quot;,
382 },
383 },
384 },
385 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
386 # message that was returned, such as `NOT FOUND`.
387 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
388 # status code that was returned. For example, a `404` means the
389 # resource was not found.
390 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
391 # defined by the server.
392 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
393 # This value is inRFC3339
394 # text format.
395 &quot;instancesBulkInsertOperationMetadata&quot;: {
396 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
397 # Example key: zones/us-central1-a
398 &quot;a_key&quot;: {
399 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
400 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
401 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
402 # error.
403 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
404 # if the flow is rolling forward or rolling back.
405 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
406 },
407 },
408 },
409 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
410 # Operation resources.
411 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
412 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
413 # group of operations results from a `bulkInsert` API request.
414 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
415 # `update`, or `delete`, and so on.
416 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
417 # There is no requirement that this be linear or support any granularity of
418 # operations. This should not be used to guess when the operation will be
419 # complete. This number should monotonically increase as the operation
420 # progresses.
421 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
422 # applicable when performing regional operations.
423 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
424 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
425 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
426 # this field will contain information on all underlying zonal actions and
427 # their state.
428 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
429 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
430 # Example key: zones/us-central1-a
431 &quot;a_key&quot;: {
432 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
433 # populated.
434 # different programming environments, including REST APIs and RPC APIs. It is
435 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
436 # three pieces of data: error code, error message, and error details.
437 #
438 # You can find out more about this error model and how to work with it in the
439 # [API Design Guide](https://cloud.google.com/apis/design/errors).
440 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
441 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
442 # message types for APIs to use.
443 {
444 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
445 },
446 ],
447 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
448 # user-facing error message should be localized and sent in the
449 # google.rpc.Status.details field, or localized by the client.
450 },
451 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
452 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
453 },
454 },
455 },
456 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
457 # This value is inRFC3339
458 # text format.
459 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
460 # following:
461 # `PENDING`, `RUNNING`, or `DONE`.
462 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
463 # operation.
464 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
465 # of the target resource.
466 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
467 # operations related to creating a snapshot, this points to the disk
468 # that the snapshot was created from.
469 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
470 # `[email protected]` or
471 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
472 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
473 # operation, this field will be populated.
474 {
475 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
476 # Engine returns NO_RESULTS_ON_PAGE if there
477 # are no results in the response.
478 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
479 # value format. For example:
480 #
481 # &quot;data&quot;: [
482 # {
483 # &quot;key&quot;: &quot;scope&quot;,
484 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
485 # }
486 {
487 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
488 # returned. For example, for warnings where there are no results in a list
489 # request for a particular zone, this key might be scope and
490 # the key value might be the zone name. Other examples might be a key
491 # indicating a deprecated resource and a suggested replacement, or a
492 # warning about invalid network settings (for example, if an instance
493 # attempts to perform IP forwarding but is not enabled for IP forwarding).
494 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
495 },
496 ],
497 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
498 },
499 ],
500 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
501 # applicable when performing per-zone operations.
502 }</pre>
503 </div>
504
505 <div class="method">
506 <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</code>
507 <pre>Retrieves the list of managed instance groups and groups them by zone.
508
509 To prevent failure, Google recommends that you set the
510 `returnPartialSuccess` parameter to `true`.
511
512 Args:
513 project: string, Project ID for this request. (required)
514 filter: string, A filter expression that filters resources listed in the response. Most
515 Compute resources support two types of filter expressions:
516 expressions that support regular expressions and expressions that follow
517 API improvement proposal AIP-160.
518 These two types of filter expressions cannot be mixed in one request.
519
520 If you want to use AIP-160, your expression must specify the field name, an
521 operator, and the value that you want to use for filtering. The value
522 must be a string, a number, or a boolean. The operator
523 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
524
525 For example, if you are filtering Compute Engine instances, you can
526 exclude instances named `example-instance` by specifying
527 `name != example-instance`.
528
529 The `:*` comparison can be used to test whether a key has been defined.
530 For example, to find all objects with `owner` label use:
531 ```
532 labels.owner:*
533 ```
534
535 You can also filter nested fields. For example, you could specify
536 `scheduling.automaticRestart = false` to include instances only
537 if they are not scheduled for automatic restarts. You can use filtering
538 on nested fields to filter based onresource labels.
539
540 To filter on multiple expressions, provide each separate expression within
541 parentheses. For example:
542 ```
543 (scheduling.automaticRestart = true)
544 (cpuPlatform = &quot;Intel Skylake&quot;)
545 ```
546 By default, each expression is an `AND` expression. However, you
547 can include `AND` and `OR` expressions explicitly.
548 For example:
549 ```
550 (cpuPlatform = &quot;Intel Skylake&quot;) OR
551 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
552 (scheduling.automaticRestart = true)
553 ```
554
555 If you want to use a regular expression, use the `eq` (equal) or `ne`
556 (not equal) operator against a single un-parenthesized expression with or
557 without quotes or against multiple parenthesized expressions. Examples:
558
559 `fieldname eq unquoted literal`
560 `fieldname eq &#x27;single quoted literal&#x27;`
561 `fieldname eq &quot;double quoted literal&quot;`
562 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
563
564 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
565 The literal value must match the entire field.
566
567 For example, to filter for instances that do not end with name &quot;instance&quot;,
568 you would use `name ne .*instance`.
569
570 You cannot combine constraints on multiple fields using regular
571 expressions.
572 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
573 global) should be included in the response. For new resource types added
574 after this field, the flag has no effect as new resource types will always
575 include every visible scope for each scope type in response. For resource
576 types which predate this field, if this flag is omitted or false, only
577 scopes of the scope types where the resource type is expected to be found
578 will be included.
579 maxResults: integer, The maximum number of results per page that should be returned.
580 If the number of available results is larger than `maxResults`,
581 Compute Engine returns a `nextPageToken` that can be used to get
582 the next page of results in subsequent list requests. Acceptable values are
583 `0` to `500`, inclusive. (Default: `500`)
584 orderBy: string, Sorts list results by a certain order. By default, results
585 are returned in alphanumerical order based on the resource name.
586
587 You can also sort results in descending order based on the creation
588 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
589 results based on the `creationTimestamp` field in
590 reverse chronological order (newest result first). Use this to sort
591 resources like operations so that the newest operation is returned first.
592
593 Currently, only sorting by `name` or
594 `creationTimestamp desc` is supported.
595 pageToken: string, Specifies a page token to use. Set `pageToken` to the
596 `nextPageToken` returned by a previous list request to get
597 the next page of results.
598 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
599 of failure. The default value is false.
600
601 For example, when partial success behavior is enabled, aggregatedList for a
602 single zone scope either returns all resources in the zone or no resources,
603 with an error code.
604 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
605 aggregated list request is invoked for subnetworks list-usable api.
606 x__xgafv: string, V1 error format.
607 Allowed values
608 1 - v1 error format
609 2 - v2 error format
610
611 Returns:
612 An object of the form:
613
614 {
615 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
616 &quot;items&quot;: { # A list of InstanceGroupManagersScopedList resources.
617 &quot;a_key&quot;: { # Output only. The name of the scope that contains this set of managed instance groups.
618 &quot;instanceGroupManagers&quot;: [ # Output only. The list of managed instance groups that are contained in the specified
619 # project and zone.
620 { # Represents a Managed Instance Group resource.
621 #
622 # An instance group is a collection of VM instances that you can manage as a
623 # single entity. For more information, readInstance groups.
624 #
625 # For zonal Managed Instance Group, use the instanceGroupManagers
626 # resource.
627 #
628 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
629 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
630 # for the group.
631 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
632 #
633 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
634 # instances to apply the configuration. To apply the configuration, set the
635 # group&#x27;s updatePolicy.type field to use proactive updates or
636 # use the applyUpdatesToInstances method.
637 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
638 &quot;a_key&quot;: &quot;A String&quot;,
639 },
640 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
641 # more information, see Project and
642 # instance metadata.
643 &quot;a_key&quot;: &quot;A String&quot;,
644 },
645 },
646 },
647 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
648 # only one value.
649 {
650 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
651 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
652 # this field controls whether to trigger VM autohealing based on a failed
653 # health check. Valid values are:
654 #
655 # - ON (default): The group recreates running VMs that
656 # fail the application-based health check.
657 # - OFF: When set to OFF, you can still observe instance
658 # health state, but the group does not recreate VMs that fail the
659 # application-based health check. This is useful for troubleshooting and
660 # setting up your health check configuration.
661 },
662 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
663 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
664 # initialize and run its startup script. During a VM&#x27;s initial delay
665 # period, the MIG ignores unsuccessful health checks because the VM might
666 # be in the startup process. This prevents the MIG from prematurely
667 # recreating a VM. If the health check receives a healthy response during
668 # the initial delay, it indicates that the startup process is complete and
669 # the VM is ready. The value of initial delay must be between 0 and 3600
670 # seconds. The default value is 0.
671 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
672 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
673 # The instance is considered available if all of the following conditions
674 # are satisfied:
675 # 1. Instance&#x27;s status is RUNNING.
676 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
677 # check result was observed to be HEALTHY at least once as it passed
678 # VERIFYING).
679 # 3. There is no outgoing action on an instance triggered by IGM.
680 #
681 # By default, number of concurrently autohealed instances is smaller than
682 # the managed instance group target size. However, if a zonal managed
683 # instance group has only one instance, or a regional managed instance
684 # group has only one instance per zone, autohealing will recreate these
685 # instances when they become unhealthy.
686 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
687 #
688 #
689 #
690 # - If the value is fixed, then the calculated
691 # value is equal to the fixed value.
692 # - If the value is a percent, then the
693 # calculated
694 # value is percent/100 * targetSize. For example,
695 # the calculated value of a 80% of a managed instance group
696 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
697 # is a remainder, the number is rounded.
698 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
699 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
700 # example, specify 80 for 80%.
701 },
702 },
703 ],
704 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
705 # all VMs in a MIG. The maximum character length is 58 and the name must
706 # comply with RFC1035 format.
707 #
708 # When a VM is created in the group, the MIG appends a hyphen and a random
709 # four-character string to the base instance name. If you want the MIG to
710 # assign sequential numbers instead of a random string, then end the base
711 # instance name with a hyphen followed by one or more hash symbols. The hash
712 # symbols indicate the number of digits. For example, a base instance name of
713 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
714 # @pattern
715 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
716 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
717 # text format.
718 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
719 # in this managed instance group that are scheduled for each of those
720 # actions.
721 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
722 # that are scheduled to be abandoned. Abandoning an instance removes it
723 # from the managed instance group without deleting it.
724 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
725 # are scheduled to be adopted or are currently being adopted.
726 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
727 # are scheduled to be created or are currently being created. If the group
728 # fails to create any of these instances, it tries again until it creates
729 # the instance successfully.
730 #
731 # If you have disabled creation retries, this field will not be populated;
732 # instead, the creatingWithoutRetries field will be populated.
733 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
734 # will attempt to create atomically, in a batch mode. If the desired count
735 # of instances can not be created, entire batch will be deleted and the
736 # group will decrease its targetSize value accordingly.
737 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
738 # will attempt to create. The group attempts to create each instance
739 # only once. If the group fails to create any of these instances, it
740 # decreases the group&#x27;s targetSize value accordingly.
741 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
742 # are scheduled to be deleted or are currently being deleted.
743 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
744 # are running and have no scheduled actions.
745 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
746 # is currently queuing.
747 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
748 # are scheduled to be recreated or are currently being being recreated.
749 # Recreating an instance deletes the existing root persistent disk
750 # and creates a new disk from the image that is defined in the
751 # instance template.
752 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
753 # are being reconfigured with properties that do not require a restart
754 # or a recreate action. For example, setting or removing target
755 # pools for the instance.
756 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
757 # are scheduled to be restarted or are currently being restarted.
758 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
759 # are scheduled to be restarted or are currently being restarted.
760 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
761 # are scheduled to be resumed or are currently being resumed.
762 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
763 # are scheduled to be started or are currently being started.
764 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
765 # are scheduled to be stopped or are currently being stopped.
766 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
767 # are scheduled to be suspended or are currently being suspended.
768 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
769 # are being verified. See the managedInstances[].currentAction
770 # property in the listManagedInstances method documentation.
771 },
772 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
773 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
774 # zones in a regional managed instance group.
775 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
776 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
777 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
778 # its instances.
779 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
780 # instances, even if an AI zone is available in the specified region. To
781 # create instances in an AI zone in the selected region, you must explicitly
782 # specify it in the distribution policy together with the other preferred
783 # zones.
784 {
785 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
786 # The zone must exist in the region where the managed instance group is
787 # located.
788 },
789 ],
790 },
791 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
792 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
793 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
794 # fingerprint must be provided in order to update the InstanceGroupManager,
795 # otherwise the request will fail with error412 conditionNotMet.
796 #
797 # To see the latest fingerprint, make a get() request to
798 # retrieve an InstanceGroupManager.
799 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
800 # generates this identifier.
801 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
802 # types of machines.
803 # Instance flexibility configuration on MIG overrides instance
804 # template configuration.
805 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
806 # when creating new VMs.
807 &quot;a_key&quot;: {
808 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
809 # selection.
810 { # An instance-attached disk resource.
811 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
812 # or X86_64.
813 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
814 # deleted (but not when the disk is detached from the instance).
815 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
816 # partition of the disk for its root filesystem.
817 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
818 # running within the instance. This name can be used to reference the device
819 # for mounting, resizing, and so on, from within the instance.
820 #
821 # If not specified, the server chooses a default device name to apply to this
822 # disk, in the form persistent-disk-x, where x is a number
823 # assigned by Google Compute Engine. This field is only applicable for
824 # persistent disks.
825 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
826 # encryption key.
827 #
828 # If you are creating a new disk, this field encrypts the new disk using
829 # an encryption key that you provide. If you are attaching an existing
830 # disk that is already encrypted, this field decrypts the disk using
831 # the customer-supplied encryption key.
832 #
833 # If you encrypt a disk using a customer-supplied key, you must provide the
834 # same key again when you attempt to use this resource at a later time. For
835 # example, you must provide the key when you create a snapshot or an image
836 # from the disk or when you attach the disk to a virtual machine instance.
837 #
838 # If you do not provide an encryption key, then the disk will be encrypted
839 # using an automatically generated key and you do not need to provide a key
840 # to use the disk later.
841 #
842 # Note:
843 #
844 # Instance templates do not storecustomer-supplied
845 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
846 #
847 # You cannot create VMs that have disks with customer-supplied keys using
848 # the bulk
849 # insert method.
850 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
851 # For example:
852 #
853 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
854 # key_region/cryptoKeys/key
855 #
856 # The fully-qualifed key name may be returned for resource GET requests. For
857 # example:
858 #
859 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
860 # key_region/cryptoKeys/key
861 # /cryptoKeyVersions/1
862 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
863 # key. If absent, the Compute Engine default service account is used.
864 # For example:
865 #
866 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
867 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
868 # encryption key, encoded in RFC
869 # 4648 base64 to either encrypt or decrypt this resource. You can
870 # provide either the rawKey or thersaEncryptedKey.
871 # For example:
872 #
873 # &quot;rawKey&quot;:
874 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
875 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
876 # customer-supplied encryption key to either encrypt or decrypt this
877 # resource. You can provide either the rawKey or thersaEncryptedKey.
878 # For example:
879 #
880 # &quot;rsaEncryptedKey&quot;:
881 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
882 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
883 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
884 #
885 # The key must meet the following requirements before you can provide it to
886 # Compute Engine:
887 #
888 # 1. The key is wrapped using a RSA public key certificate provided by
889 # Google.
890 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
891 # encoding.
892 #
893 # Gets the RSA public key certificate provided by Google at:
894 #
895 #
896 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
897 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
898 # 4648 base64 encoded SHA-256 hash of the customer-supplied
899 # encryption key that protects this resource.
900 },
901 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
902 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
903 # currently attached to another instance. If you try to force attach a zonal
904 # disk to an instance, you will receive an error.
905 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
906 # only for bootable images. Read
907 # Enabling guest operating system features to see a list of available
908 # options.
909 { # Guest OS features.
910 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
911 # separate values. Set to one or more of the following values:
912 #
913 # - VIRTIO_SCSI_MULTIQUEUE
914 # - WINDOWS
915 # - MULTI_IP_SUBNET
916 # - UEFI_COMPATIBLE
917 # - GVNIC
918 # - SEV_CAPABLE
919 # - SUSPEND_RESUME_COMPATIBLE
920 # - SEV_LIVE_MIGRATABLE_V2
921 # - SEV_SNP_CAPABLE
922 # - TDX_CAPABLE
923 # - IDPF
924 # - SNP_SVSM_CAPABLE
925 # - CCA_CAPABLE
926 #
927 #
928 # For more information, see
929 # Enabling guest operating system features.
930 },
931 ],
932 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
933 # boot disk. If you have many disks attached to an instance, each
934 # disk would have a unique index number.
935 &quot;initializeParams&quot;: { # [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
936 # alongside the new instance. Use initialization parameters to create boot
937 # disks or local SSDs attached to the new instance.
938 #
939 # This property is mutually exclusive with the source property;
940 # you can only define one or the other, but not both.
941 # alongside the new instance. Use initialization parameters to create boot
942 # disks or local SSDs attached to the new instance.
943 #
944 # This field is persisted and returned for instanceTemplate and not returned
945 # in the context of instance.
946 #
947 # This property is mutually exclusive with the source property;
948 # you can only define one or the other, but not both.
949 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
950 # arm64 or x86_64.
951 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
952 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
953 # of the instance. If a disk with the same name already exists in the given
954 # region, the existing disk is attached to the new instance and the
955 # new disk is not created.
956 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
957 # 10 GB. If you specify a sourceImage, which is required for
958 # boot disks, the default size is the size of the sourceImage.
959 # If you do not specify a sourceImage, the default disk size
960 # is 500 GB.
961 &quot;diskType&quot;: &quot;A String&quot;,
962 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
963 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
964 # only for bootable images. Read
965 # Enabling guest operating system features to see a list of available
966 # options.
967 #
968 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
969 { # Guest OS features.
970 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
971 # separate values. Set to one or more of the following values:
972 #
973 # - VIRTIO_SCSI_MULTIQUEUE
974 # - WINDOWS
975 # - MULTI_IP_SUBNET
976 # - UEFI_COMPATIBLE
977 # - GVNIC
978 # - SEV_CAPABLE
979 # - SUSPEND_RESUME_COMPATIBLE
980 # - SEV_LIVE_MIGRATABLE_V2
981 # - SEV_SNP_CAPABLE
982 # - TDX_CAPABLE
983 # - IDPF
984 # - SNP_SVSM_CAPABLE
985 # - CCA_CAPABLE
986 #
987 #
988 # For more information, see
989 # Enabling guest operating system features.
990 },
991 ],
992 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
993 # which is either SCSI or NVME. The default isSCSI.
994 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
995 # persistent disks.
996 &quot;a_key&quot;: &quot;A String&quot;,
997 },
998 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
999 # disk.
1000 &quot;A String&quot;,
1001 ],
1002 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
1003 &quot;A String&quot;,
1004 ],
1005 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
1006 # more than one instance.
1007 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
1008 # is to use the existing disk.
1009 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
1010 # of I/O operations per second that the disk can handle. Values must be
1011 # between 10,000 and 120,000. For more details, see theExtreme persistent
1012 # disk documentation.
1013 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
1014 # number of throughput mb per second that the disk can handle. Values must
1015 # greater than or equal to 1.
1016 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
1017 # the URLs of the zones where the disk should be replicated to.
1018 # You must provide exactly two replica zones, and one zone must be the same
1019 # as the instance zone.
1020 &quot;A String&quot;,
1021 ],
1022 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
1023 # have the same definition as resource
1024 # manager tags. Keys and values can be either in numeric format,
1025 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1026 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1027 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
1028 # empty.
1029 &quot;a_key&quot;: &quot;A String&quot;,
1030 },
1031 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
1032 # Specified using the full or partial URL. For instance template, specify
1033 # only the resource policy name.
1034 &quot;A String&quot;,
1035 ],
1036 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
1037 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1038 # is required.
1039 #
1040 # To create a disk with one of the public operating system
1041 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
1042 #
1043 # projects/debian-cloud/global/images/family/debian-9
1044 #
1045 #
1046 # Alternatively, use a specific version of a public operating system image:
1047 #
1048 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
1049 #
1050 #
1051 # To create a disk with a custom image that you created, specify the
1052 # image name in the following format:
1053 #
1054 # global/images/my-custom-image
1055 #
1056 #
1057 # You can also specify a custom image by its image family, which returns
1058 # the latest version of the image in that family. Replace the image name
1059 # with family/family-name:
1060 #
1061 # global/images/family/my-image-family
1062 #
1063 #
1064 # If the source image is deleted later, this field will not be set.
1065 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
1066 # encryption key of the source image. Required if the source image is
1067 # protected by a customer-supplied encryption key.
1068 #
1069 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
1070 # encryption keys, so you cannot create disks for instances in a managed instance group if the
1071 # source images are encrypted with your own keys.
1072 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1073 # For example:
1074 #
1075 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1076 # key_region/cryptoKeys/key
1077 #
1078 # The fully-qualifed key name may be returned for resource GET requests. For
1079 # example:
1080 #
1081 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1082 # key_region/cryptoKeys/key
1083 # /cryptoKeyVersions/1
1084 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1085 # key. If absent, the Compute Engine default service account is used.
1086 # For example:
1087 #
1088 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1089 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1090 # encryption key, encoded in RFC
1091 # 4648 base64 to either encrypt or decrypt this resource. You can
1092 # provide either the rawKey or thersaEncryptedKey.
1093 # For example:
1094 #
1095 # &quot;rawKey&quot;:
1096 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1097 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1098 # customer-supplied encryption key to either encrypt or decrypt this
1099 # resource. You can provide either the rawKey or thersaEncryptedKey.
1100 # For example:
1101 #
1102 # &quot;rsaEncryptedKey&quot;:
1103 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1104 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1105 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1106 #
1107 # The key must meet the following requirements before you can provide it to
1108 # Compute Engine:
1109 #
1110 # 1. The key is wrapped using a RSA public key certificate provided by
1111 # Google.
1112 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1113 # encoding.
1114 #
1115 # Gets the RSA public key certificate provided by Google at:
1116 #
1117 #
1118 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1119 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1120 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1121 # encryption key that protects this resource.
1122 },
1123 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
1124 # instance boot disk, one of initializeParams.sourceSnapshot
1125 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
1126 # is required.
1127 #
1128 # To create a disk with a snapshot that you created, specify the
1129 # snapshot name in the following format:
1130 #
1131 # us-central1-a/instantSnapshots/my-backup
1132 #
1133 #
1134 # If the source instant-snapshot is deleted later, this field will not be
1135 # set.
1136 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
1137 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
1138 # is required.
1139 #
1140 # To create a disk with a snapshot that you created, specify the
1141 # snapshot name in the following format:
1142 #
1143 # global/snapshots/my-backup
1144 #
1145 #
1146 # If the source snapshot is deleted later, this field will not be set.
1147 #
1148 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
1149 # an image instead when you create VMs using
1150 # the bulk
1151 # insert method.
1152 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1153 # encryption key of the source snapshot.
1154 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1155 # For example:
1156 #
1157 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1158 # key_region/cryptoKeys/key
1159 #
1160 # The fully-qualifed key name may be returned for resource GET requests. For
1161 # example:
1162 #
1163 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1164 # key_region/cryptoKeys/key
1165 # /cryptoKeyVersions/1
1166 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1167 # key. If absent, the Compute Engine default service account is used.
1168 # For example:
1169 #
1170 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1171 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1172 # encryption key, encoded in RFC
1173 # 4648 base64 to either encrypt or decrypt this resource. You can
1174 # provide either the rawKey or thersaEncryptedKey.
1175 # For example:
1176 #
1177 # &quot;rawKey&quot;:
1178 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1179 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1180 # customer-supplied encryption key to either encrypt or decrypt this
1181 # resource. You can provide either the rawKey or thersaEncryptedKey.
1182 # For example:
1183 #
1184 # &quot;rsaEncryptedKey&quot;:
1185 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1186 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1187 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1188 #
1189 # The key must meet the following requirements before you can provide it to
1190 # Compute Engine:
1191 #
1192 # 1. The key is wrapped using a RSA public key certificate provided by
1193 # Google.
1194 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1195 # encoding.
1196 #
1197 # Gets the RSA public key certificate provided by Google at:
1198 #
1199 #
1200 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1201 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1202 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1203 # encryption key that protects this resource.
1204 },
1205 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1206 # this as a partial or full URL to the resource. For example, the following
1207 # are valid values:
1208 #
1209 #
1210 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1211 # - projects/project/zones/zone/storagePools/storagePool
1212 # - zones/zone/storagePools/storagePool
1213 },
1214 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1215 # either SCSI or NVME. For most machine types, the
1216 # default is SCSI. Local SSDs can use either NVME or SCSI.
1217 # In certain configurations, persistent disks can use NVMe. For more
1218 # information, seeAbout
1219 # persistent disks.
1220 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1221 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1222 &quot;A String&quot;,
1223 ],
1224 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
1225 # disk is not allowed to be detached from the instance, or to be used as the
1226 # source of the snapshot creation, and the image creation. The instance with
1227 # at least one locked attached disk is not allow to be used as source of
1228 # machine image creation, instant snapshot creation, and not allowed to be
1229 # deleted with --keep-disk parameter set to true for locked disks.
1230 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
1231 # in READ_WRITE mode.
1232 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1233 # field is set to PRESERVED if the LocalSSD data has been saved
1234 # to a persistent location by customer request. (see the
1235 # discard_local_ssd option on Stop/Suspend).
1236 # Read-only in the api.
1237 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1238 # these are public keys which are safe to store in public
1239 &quot;dbs&quot;: [ # The Key Database (db).
1240 {
1241 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1242 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1243 },
1244 ],
1245 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
1246 {
1247 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1248 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1249 },
1250 ],
1251 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
1252 {
1253 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1254 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1255 },
1256 ],
1257 &quot;pk&quot;: { # The Platform Key (PK).
1258 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1259 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1260 },
1261 },
1262 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
1263 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1264 # is required.
1265 #
1266 # If desired, you can also attach existing non-root persistent disks using
1267 # this property. This field is only applicable for persistent disks.
1268 #
1269 # Note that for InstanceTemplate, specify the disk name for zonal disk,
1270 # and the URL for regional disk.
1271 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
1272 },
1273 ],
1274 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
1275 &quot;A String&quot;,
1276 ],
1277 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
1278 # e.g. &#x27;Intel Ice Lake&#x27;.
1279 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
1280 # preference. MIG will first try to create a VM based on the machine-type
1281 # with lowest rank and fallback to next rank based on availability.
1282 # Machine types and instance selections with the same rank have the same
1283 # preference.
1284 },
1285 },
1286 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
1287 # when creating new VMs.
1288 &quot;a_key&quot;: {
1289 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
1290 # selection.
1291 { # An instance-attached disk resource.
1292 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
1293 # or X86_64.
1294 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
1295 # deleted (but not when the disk is detached from the instance).
1296 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
1297 # partition of the disk for its root filesystem.
1298 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
1299 # running within the instance. This name can be used to reference the device
1300 # for mounting, resizing, and so on, from within the instance.
1301 #
1302 # If not specified, the server chooses a default device name to apply to this
1303 # disk, in the form persistent-disk-x, where x is a number
1304 # assigned by Google Compute Engine. This field is only applicable for
1305 # persistent disks.
1306 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
1307 # encryption key.
1308 #
1309 # If you are creating a new disk, this field encrypts the new disk using
1310 # an encryption key that you provide. If you are attaching an existing
1311 # disk that is already encrypted, this field decrypts the disk using
1312 # the customer-supplied encryption key.
1313 #
1314 # If you encrypt a disk using a customer-supplied key, you must provide the
1315 # same key again when you attempt to use this resource at a later time. For
1316 # example, you must provide the key when you create a snapshot or an image
1317 # from the disk or when you attach the disk to a virtual machine instance.
1318 #
1319 # If you do not provide an encryption key, then the disk will be encrypted
1320 # using an automatically generated key and you do not need to provide a key
1321 # to use the disk later.
1322 #
1323 # Note:
1324 #
1325 # Instance templates do not storecustomer-supplied
1326 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
1327 #
1328 # You cannot create VMs that have disks with customer-supplied keys using
1329 # the bulk
1330 # insert method.
1331 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1332 # For example:
1333 #
1334 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1335 # key_region/cryptoKeys/key
1336 #
1337 # The fully-qualifed key name may be returned for resource GET requests. For
1338 # example:
1339 #
1340 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1341 # key_region/cryptoKeys/key
1342 # /cryptoKeyVersions/1
1343 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1344 # key. If absent, the Compute Engine default service account is used.
1345 # For example:
1346 #
1347 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1348 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1349 # encryption key, encoded in RFC
1350 # 4648 base64 to either encrypt or decrypt this resource. You can
1351 # provide either the rawKey or thersaEncryptedKey.
1352 # For example:
1353 #
1354 # &quot;rawKey&quot;:
1355 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1356 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1357 # customer-supplied encryption key to either encrypt or decrypt this
1358 # resource. You can provide either the rawKey or thersaEncryptedKey.
1359 # For example:
1360 #
1361 # &quot;rsaEncryptedKey&quot;:
1362 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1363 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1364 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1365 #
1366 # The key must meet the following requirements before you can provide it to
1367 # Compute Engine:
1368 #
1369 # 1. The key is wrapped using a RSA public key certificate provided by
1370 # Google.
1371 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1372 # encoding.
1373 #
1374 # Gets the RSA public key certificate provided by Google at:
1375 #
1376 #
1377 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1378 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1379 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1380 # encryption key that protects this resource.
1381 },
1382 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
1383 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
1384 # currently attached to another instance. If you try to force attach a zonal
1385 # disk to an instance, you will receive an error.
1386 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
1387 # only for bootable images. Read
1388 # Enabling guest operating system features to see a list of available
1389 # options.
1390 { # Guest OS features.
1391 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1392 # separate values. Set to one or more of the following values:
1393 #
1394 # - VIRTIO_SCSI_MULTIQUEUE
1395 # - WINDOWS
1396 # - MULTI_IP_SUBNET
1397 # - UEFI_COMPATIBLE
1398 # - GVNIC
1399 # - SEV_CAPABLE
1400 # - SUSPEND_RESUME_COMPATIBLE
1401 # - SEV_LIVE_MIGRATABLE_V2
1402 # - SEV_SNP_CAPABLE
1403 # - TDX_CAPABLE
1404 # - IDPF
1405 # - SNP_SVSM_CAPABLE
1406 # - CCA_CAPABLE
1407 #
1408 #
1409 # For more information, see
1410 # Enabling guest operating system features.
1411 },
1412 ],
1413 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
1414 # boot disk. If you have many disks attached to an instance, each
1415 # disk would have a unique index number.
1416 &quot;initializeParams&quot;: { # [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
1417 # alongside the new instance. Use initialization parameters to create boot
1418 # disks or local SSDs attached to the new instance.
1419 #
1420 # This property is mutually exclusive with the source property;
1421 # you can only define one or the other, but not both.
1422 # alongside the new instance. Use initialization parameters to create boot
1423 # disks or local SSDs attached to the new instance.
1424 #
1425 # This field is persisted and returned for instanceTemplate and not returned
1426 # in the context of instance.
1427 #
1428 # This property is mutually exclusive with the source property;
1429 # you can only define one or the other, but not both.
1430 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
1431 # arm64 or x86_64.
1432 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
1433 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
1434 # of the instance. If a disk with the same name already exists in the given
1435 # region, the existing disk is attached to the new instance and the
1436 # new disk is not created.
1437 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
1438 # 10 GB. If you specify a sourceImage, which is required for
1439 # boot disks, the default size is the size of the sourceImage.
1440 # If you do not specify a sourceImage, the default disk size
1441 # is 500 GB.
1442 &quot;diskType&quot;: &quot;A String&quot;,
1443 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
1444 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
1445 # only for bootable images. Read
1446 # Enabling guest operating system features to see a list of available
1447 # options.
1448 #
1449 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
1450 { # Guest OS features.
1451 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1452 # separate values. Set to one or more of the following values:
1453 #
1454 # - VIRTIO_SCSI_MULTIQUEUE
1455 # - WINDOWS
1456 # - MULTI_IP_SUBNET
1457 # - UEFI_COMPATIBLE
1458 # - GVNIC
1459 # - SEV_CAPABLE
1460 # - SUSPEND_RESUME_COMPATIBLE
1461 # - SEV_LIVE_MIGRATABLE_V2
1462 # - SEV_SNP_CAPABLE
1463 # - TDX_CAPABLE
1464 # - IDPF
1465 # - SNP_SVSM_CAPABLE
1466 # - CCA_CAPABLE
1467 #
1468 #
1469 # For more information, see
1470 # Enabling guest operating system features.
1471 },
1472 ],
1473 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
1474 # which is either SCSI or NVME. The default isSCSI.
1475 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
1476 # persistent disks.
1477 &quot;a_key&quot;: &quot;A String&quot;,
1478 },
1479 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
1480 # disk.
1481 &quot;A String&quot;,
1482 ],
1483 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
1484 &quot;A String&quot;,
1485 ],
1486 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
1487 # more than one instance.
1488 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
1489 # is to use the existing disk.
1490 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
1491 # of I/O operations per second that the disk can handle. Values must be
1492 # between 10,000 and 120,000. For more details, see theExtreme persistent
1493 # disk documentation.
1494 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
1495 # number of throughput mb per second that the disk can handle. Values must
1496 # greater than or equal to 1.
1497 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
1498 # the URLs of the zones where the disk should be replicated to.
1499 # You must provide exactly two replica zones, and one zone must be the same
1500 # as the instance zone.
1501 &quot;A String&quot;,
1502 ],
1503 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
1504 # have the same definition as resource
1505 # manager tags. Keys and values can be either in numeric format,
1506 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1507 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1508 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
1509 # empty.
1510 &quot;a_key&quot;: &quot;A String&quot;,
1511 },
1512 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
1513 # Specified using the full or partial URL. For instance template, specify
1514 # only the resource policy name.
1515 &quot;A String&quot;,
1516 ],
1517 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
1518 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1519 # is required.
1520 #
1521 # To create a disk with one of the public operating system
1522 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
1523 #
1524 # projects/debian-cloud/global/images/family/debian-9
1525 #
1526 #
1527 # Alternatively, use a specific version of a public operating system image:
1528 #
1529 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
1530 #
1531 #
1532 # To create a disk with a custom image that you created, specify the
1533 # image name in the following format:
1534 #
1535 # global/images/my-custom-image
1536 #
1537 #
1538 # You can also specify a custom image by its image family, which returns
1539 # the latest version of the image in that family. Replace the image name
1540 # with family/family-name:
1541 #
1542 # global/images/family/my-image-family
1543 #
1544 #
1545 # If the source image is deleted later, this field will not be set.
1546 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
1547 # encryption key of the source image. Required if the source image is
1548 # protected by a customer-supplied encryption key.
1549 #
1550 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
1551 # encryption keys, so you cannot create disks for instances in a managed instance group if the
1552 # source images are encrypted with your own keys.
1553 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1554 # For example:
1555 #
1556 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1557 # key_region/cryptoKeys/key
1558 #
1559 # The fully-qualifed key name may be returned for resource GET requests. For
1560 # example:
1561 #
1562 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1563 # key_region/cryptoKeys/key
1564 # /cryptoKeyVersions/1
1565 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1566 # key. If absent, the Compute Engine default service account is used.
1567 # For example:
1568 #
1569 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1570 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1571 # encryption key, encoded in RFC
1572 # 4648 base64 to either encrypt or decrypt this resource. You can
1573 # provide either the rawKey or thersaEncryptedKey.
1574 # For example:
1575 #
1576 # &quot;rawKey&quot;:
1577 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1578 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1579 # customer-supplied encryption key to either encrypt or decrypt this
1580 # resource. You can provide either the rawKey or thersaEncryptedKey.
1581 # For example:
1582 #
1583 # &quot;rsaEncryptedKey&quot;:
1584 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1585 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1586 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1587 #
1588 # The key must meet the following requirements before you can provide it to
1589 # Compute Engine:
1590 #
1591 # 1. The key is wrapped using a RSA public key certificate provided by
1592 # Google.
1593 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1594 # encoding.
1595 #
1596 # Gets the RSA public key certificate provided by Google at:
1597 #
1598 #
1599 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1600 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1601 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1602 # encryption key that protects this resource.
1603 },
1604 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
1605 # instance boot disk, one of initializeParams.sourceSnapshot
1606 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
1607 # is required.
1608 #
1609 # To create a disk with a snapshot that you created, specify the
1610 # snapshot name in the following format:
1611 #
1612 # us-central1-a/instantSnapshots/my-backup
1613 #
1614 #
1615 # If the source instant-snapshot is deleted later, this field will not be
1616 # set.
1617 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
1618 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
1619 # is required.
1620 #
1621 # To create a disk with a snapshot that you created, specify the
1622 # snapshot name in the following format:
1623 #
1624 # global/snapshots/my-backup
1625 #
1626 #
1627 # If the source snapshot is deleted later, this field will not be set.
1628 #
1629 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
1630 # an image instead when you create VMs using
1631 # the bulk
1632 # insert method.
1633 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1634 # encryption key of the source snapshot.
1635 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1636 # For example:
1637 #
1638 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1639 # key_region/cryptoKeys/key
1640 #
1641 # The fully-qualifed key name may be returned for resource GET requests. For
1642 # example:
1643 #
1644 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1645 # key_region/cryptoKeys/key
1646 # /cryptoKeyVersions/1
1647 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1648 # key. If absent, the Compute Engine default service account is used.
1649 # For example:
1650 #
1651 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1652 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1653 # encryption key, encoded in RFC
1654 # 4648 base64 to either encrypt or decrypt this resource. You can
1655 # provide either the rawKey or thersaEncryptedKey.
1656 # For example:
1657 #
1658 # &quot;rawKey&quot;:
1659 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1660 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1661 # customer-supplied encryption key to either encrypt or decrypt this
1662 # resource. You can provide either the rawKey or thersaEncryptedKey.
1663 # For example:
1664 #
1665 # &quot;rsaEncryptedKey&quot;:
1666 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1667 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1668 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1669 #
1670 # The key must meet the following requirements before you can provide it to
1671 # Compute Engine:
1672 #
1673 # 1. The key is wrapped using a RSA public key certificate provided by
1674 # Google.
1675 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1676 # encoding.
1677 #
1678 # Gets the RSA public key certificate provided by Google at:
1679 #
1680 #
1681 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1682 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1683 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1684 # encryption key that protects this resource.
1685 },
1686 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1687 # this as a partial or full URL to the resource. For example, the following
1688 # are valid values:
1689 #
1690 #
1691 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1692 # - projects/project/zones/zone/storagePools/storagePool
1693 # - zones/zone/storagePools/storagePool
1694 },
1695 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1696 # either SCSI or NVME. For most machine types, the
1697 # default is SCSI. Local SSDs can use either NVME or SCSI.
1698 # In certain configurations, persistent disks can use NVMe. For more
1699 # information, seeAbout
1700 # persistent disks.
1701 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1702 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1703 &quot;A String&quot;,
1704 ],
1705 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
1706 # disk is not allowed to be detached from the instance, or to be used as the
1707 # source of the snapshot creation, and the image creation. The instance with
1708 # at least one locked attached disk is not allow to be used as source of
1709 # machine image creation, instant snapshot creation, and not allowed to be
1710 # deleted with --keep-disk parameter set to true for locked disks.
1711 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
1712 # in READ_WRITE mode.
1713 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1714 # field is set to PRESERVED if the LocalSSD data has been saved
1715 # to a persistent location by customer request. (see the
1716 # discard_local_ssd option on Stop/Suspend).
1717 # Read-only in the api.
1718 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1719 # these are public keys which are safe to store in public
1720 &quot;dbs&quot;: [ # The Key Database (db).
1721 {
1722 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1723 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1724 },
1725 ],
1726 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
1727 {
1728 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1729 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1730 },
1731 ],
1732 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
1733 {
1734 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1735 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1736 },
1737 ],
1738 &quot;pk&quot;: { # The Platform Key (PK).
1739 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1740 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1741 },
1742 },
1743 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
1744 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1745 # is required.
1746 #
1747 # If desired, you can also attach existing non-root persistent disks using
1748 # this property. This field is only applicable for persistent disks.
1749 #
1750 # Note that for InstanceTemplate, specify the disk name for zonal disk,
1751 # and the URL for regional disk.
1752 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
1753 },
1754 ],
1755 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
1756 &quot;A String&quot;,
1757 ],
1758 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
1759 # e.g. &#x27;Intel Ice Lake&#x27;.
1760 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
1761 # preference. MIG will first try to create a VM based on the machine-type
1762 # with lowest rank and fallback to next rank based on availability.
1763 # Machine types and instance selections with the same rank have the same
1764 # preference.
1765 },
1766 },
1767 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
1768 # create instances.
1769 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
1770 # more preemption than the minimum capacity user needs. MIG will create
1771 # only Standard VMs until it reaches standard_capacity_base and only
1772 # then will start using standard_capacity_percent_above_base to mix Spot
1773 # with Standard VMs.
1774 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
1775 # remaining percentage will use Spot VMs. The percentage applies only to
1776 # the capacity above standard_capacity_base.
1777 },
1778 },
1779 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
1780 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
1781 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
1782 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
1783 # applies to the VMs on which your application fails a health check.
1784 # Valid values are
1785 #
1786 # - REPAIR (default): MIG automatically repairs a failed VM
1787 # by recreating it. For more information, see About
1788 # repairing VMs in a MIG.
1789 # - DO_NOTHING: MIG does not repair a failed VM.
1790 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
1791 # configuration when repairing a VM. Valid options are:
1792 #
1793 #
1794 #
1795 # - NO (default): If configuration updates are available, they are not
1796 # forcefully applied during repair. Instead, configuration updates are
1797 # applied according to the group&#x27;s update policy.
1798 #
1799 # - YES: If configuration updates are available, they are applied
1800 # during repair.
1801 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
1802 # instance during initialization when stopping / suspending an instance.
1803 # The Instance Group Manager will wait for a signal that indicates
1804 # successful initialization before stopping / suspending an instance.
1805 #
1806 # If a successful readiness signal is not sent before timeout, the
1807 # corresponding instance will not be stopped / suspended. Instead,
1808 # an error will be visible in the lastAttempt.errors field of
1809 # the managed instance in the listmanagedinstances
1810 # method.
1811 #
1812 # If metadataBasedReadinessSignal.timeoutSec is unset,
1813 # the Instance Group Manager will directly proceed to suspend / stop
1814 # instances, skipping initialization on them.
1815 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
1816 # initialization before timing out.
1817 },
1818 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
1819 # unhealthy when the application running on that VM fails a health check.
1820 # Valid values are:
1821 #
1822 # - DEFAULT_ACTION (default): MIG uses the same action
1823 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
1824 # - REPAIR: MIG automatically repairs an unhealthy VM by
1825 # recreating it.
1826 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
1827 # For more information, see
1828 # About repairing VMs in a MIG.
1829 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
1830 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
1831 # Valid values are:
1832 #
1833 # - NO (default): MIG cannot change a VM&#x27;s zone during a
1834 # repair.
1835 # - YES: MIG can select a different zone for the VM during
1836 # a repair.
1837 },
1838 },
1839 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
1840 # instance group. The group uses this template to create all new instances
1841 # in the managed instance group. The templates for existing instances in the
1842 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
1843 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
1844 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
1845 # this managed instance group.
1846 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
1847 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
1848 # long, and comply withRFC1035.
1849 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
1850 # to this Instance Group Manager.
1851 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
1852 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
1853 # The name must be 1-63 characters long, and comply withRFC1035.
1854 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
1855 },
1856 ],
1857 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
1858 # as part of resource payload.
1859 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
1860 # key-value pairs. Keys and values can be either in numeric format,
1861 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
1862 # format such as `{org_id|project_id}/{tag_key_short_name}` and
1863 # `{tag_value_short_name}`. For more information, seeManage tags
1864 # for resources.
1865 &quot;a_key&quot;: &quot;A String&quot;,
1866 },
1867 },
1868 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
1869 # where the managed instance group resides (for regional resources).
1870 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
1871 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
1872 # instance group.
1873 # It can be a full or partial URL. For example, the following are
1874 # all valid URLs to a workload policy:
1875 #
1876 #
1877 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
1878 # - projects/project/regions/region/resourcePolicies/resourcePolicy
1879 # - regions/region/resourcePolicies/resourcePolicy
1880 },
1881 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
1882 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
1883 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
1884 # this URL.
1885 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
1886 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
1887 # by the managed instance group on instances. The service accounts needs all
1888 # permissions required to create and delete instances.
1889 # By default, the service account
1890 # {projectNumber}@cloudservices.gserviceaccount.com is used.
1891 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
1892 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
1893 # stop a VM after that VM was created. The initial delay gives the
1894 # initialization script the time to prepare your VM for a quick scale out.
1895 # The value of initial delay must be between 0 and 3600 seconds. The
1896 # default value is 0.
1897 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
1898 # group scales out. The default mode is `MANUAL`.
1899 },
1900 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
1901 &quot;preservedState&quot;: { # Configuration of preserved resources.
1902 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
1903 # delete, update, etc. This map is keyed with the device names of
1904 # the disks.
1905 &quot;a_key&quot;: {
1906 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1907 # update or VM instance recreate operations.
1908 # This flag is used to configure if the disk should be deleted after it
1909 # is no longer used by the group, e.g. when the given instance or
1910 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
1911 },
1912 },
1913 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
1914 # instance delete, update, etc. This map is keyed with the network
1915 # interface name.
1916 &quot;a_key&quot;: {
1917 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1918 # update or VM instance recreate operations.
1919 # This flag is used to configure if the IP reservation should be deleted
1920 # after it is no longer used by the group, e.g. when the given instance
1921 # or the whole group is deleted.
1922 },
1923 },
1924 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
1925 # instance delete, update, etc. This map is keyed with the network
1926 # interface name.
1927 &quot;a_key&quot;: {
1928 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1929 # update or VM instance recreate operations.
1930 # This flag is used to configure if the IP reservation should be deleted
1931 # after it is no longer used by the group, e.g. when the given instance
1932 # or the whole group is deleted.
1933 },
1934 },
1935 },
1936 },
1937 &quot;status&quot;: { # Output only. The status of this managed instance group.
1938 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
1939 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
1940 # This value is in RFC3339 text format.
1941 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
1942 # been applied to all managed instances in the group.
1943 },
1944 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
1945 # Currently only one accelerator topology is supported.
1946 {
1947 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
1948 # The value is the same as configured in the WorkloadPolicy.
1949 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
1950 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
1951 # check.
1952 &quot;error&quot;: { # Output only. Encountered errors.
1953 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1954 # operation.
1955 {
1956 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1957 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1958 # details. There is a set of defined message types to use for providing
1959 # details.The syntax depends on the error code. For example,
1960 # QuotaExceededInfo will have details when the error code is
1961 # QUOTA_EXCEEDED.
1962 {
1963 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1964 #
1965 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1966 # is not enabled:
1967 #
1968 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1969 # &quot;domain&quot;: &quot;googleapis.com&quot;
1970 # &quot;metadata&quot;: {
1971 # &quot;resource&quot;: &quot;projects/123&quot;,
1972 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1973 # }
1974 # }
1975 #
1976 # This response indicates that the pubsub.googleapis.com API is not enabled.
1977 #
1978 # Example of an error that is returned when attempting to create a Spanner
1979 # instance in a region that is out of stock:
1980 #
1981 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1982 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1983 # &quot;metadata&quot;: {
1984 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1985 # }
1986 # }
1987 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1988 # is typically the registered service name of the tool or product that
1989 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1990 # generated by some common infrastructure, the error domain must be a
1991 # globally unique value that identifies the infrastructure. For Google API
1992 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1993 &quot;metadatas&quot;: { # Additional structured details about this error.
1994 #
1995 # Keys must match a regular expression of `a-z+` but should
1996 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1997 # length. When identifying the current value of an exceeded limit, the units
1998 # should be contained in the key, not the value. For example, rather than
1999 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2000 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2001 # instances that can be created in a single (batch) request.
2002 &quot;a_key&quot;: &quot;A String&quot;,
2003 },
2004 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2005 # proximate cause of the error. Error reasons are unique within a particular
2006 # domain of errors. This should be at most 63 characters and match a
2007 # regular expression of `A-Z+[A-Z0-9]`, which represents
2008 # UPPER_SNAKE_CASE.
2009 },
2010 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2011 #
2012 # For example, if a quota check failed with an error indicating the calling
2013 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2014 # directly to the right place in the developer console to flip the bit.
2015 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2016 { # Describes a URL link.
2017 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2018 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2019 },
2020 ],
2021 },
2022 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2023 # which can be attached to an RPC error.
2024 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2025 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2026 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2027 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2028 },
2029 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2030 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2031 &quot;a_key&quot;: &quot;A String&quot;,
2032 },
2033 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2034 # type or metric.
2035 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2036 # or metric.
2037 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2038 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2039 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2040 },
2041 },
2042 ],
2043 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2044 # This property is optional.
2045 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2046 },
2047 ],
2048 },
2049 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
2050 # has // RFC3339 //
2051 # text format.
2052 },
2053 },
2054 ],
2055 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
2056 # that targets this instance group manager.
2057 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
2058 # targetSizePolicy.mode is set to BULK.
2059 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
2060 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
2061 # operation.
2062 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
2063 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2064 # operation.
2065 {
2066 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2067 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2068 # details. There is a set of defined message types to use for providing
2069 # details.The syntax depends on the error code. For example,
2070 # QuotaExceededInfo will have details when the error code is
2071 # QUOTA_EXCEEDED.
2072 {
2073 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2074 #
2075 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2076 # is not enabled:
2077 #
2078 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2079 # &quot;domain&quot;: &quot;googleapis.com&quot;
2080 # &quot;metadata&quot;: {
2081 # &quot;resource&quot;: &quot;projects/123&quot;,
2082 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2083 # }
2084 # }
2085 #
2086 # This response indicates that the pubsub.googleapis.com API is not enabled.
2087 #
2088 # Example of an error that is returned when attempting to create a Spanner
2089 # instance in a region that is out of stock:
2090 #
2091 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2092 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2093 # &quot;metadata&quot;: {
2094 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2095 # }
2096 # }
2097 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2098 # is typically the registered service name of the tool or product that
2099 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2100 # generated by some common infrastructure, the error domain must be a
2101 # globally unique value that identifies the infrastructure. For Google API
2102 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2103 &quot;metadatas&quot;: { # Additional structured details about this error.
2104 #
2105 # Keys must match a regular expression of `a-z+` but should
2106 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2107 # length. When identifying the current value of an exceeded limit, the units
2108 # should be contained in the key, not the value. For example, rather than
2109 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2110 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2111 # instances that can be created in a single (batch) request.
2112 &quot;a_key&quot;: &quot;A String&quot;,
2113 },
2114 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2115 # proximate cause of the error. Error reasons are unique within a particular
2116 # domain of errors. This should be at most 63 characters and match a
2117 # regular expression of `A-Z+[A-Z0-9]`, which represents
2118 # UPPER_SNAKE_CASE.
2119 },
2120 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2121 #
2122 # For example, if a quota check failed with an error indicating the calling
2123 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2124 # directly to the right place in the developer console to flip the bit.
2125 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2126 { # Describes a URL link.
2127 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2128 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2129 },
2130 ],
2131 },
2132 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2133 # which can be attached to an RPC error.
2134 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2135 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2136 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2137 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2138 },
2139 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2140 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2141 &quot;a_key&quot;: &quot;A String&quot;,
2142 },
2143 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2144 # type or metric.
2145 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2146 # or metric.
2147 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2148 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2149 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2150 },
2151 },
2152 ],
2153 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2154 # This property is optional.
2155 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2156 },
2157 ],
2158 },
2159 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
2160 # operation. Timestamp is in RFC3339 text format.
2161 },
2162 },
2163 &quot;currentInstanceStatuses&quot;: { # 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
2164 # in this managed instance group that have the status. Currently only shown
2165 # for TPU MIGs
2166 # instance group that have the status. For more information about how to
2167 # interpret each status check the instance lifecycle documentation.
2168 # Currently only shown for TPU MIGs.
2169 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
2170 # that have DEPROVISIONING status.
2171 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
2172 # have been deleted. Includes only instances that would be shown in the
2173 # listManagedInstances method and not all instances that have been
2174 # deleted in the lifetime of the MIG.
2175 # Does not include FlexStart instances that are waiting for the resources
2176 # availability, they are considered as &#x27;pending&#x27;.
2177 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
2178 # that have PENDING status, that is FlexStart instances that are waiting
2179 # for resources. Instances that do not exist because of the other reasons
2180 # are counted as &#x27;non_existent&#x27;.
2181 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
2182 # that have PENDING_STOP status.
2183 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
2184 # that have PROVISIONING status.
2185 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
2186 # that have REPAIRING status.
2187 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
2188 # that have RUNNING status.
2189 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
2190 # that have STAGING status.
2191 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
2192 # that have STOPPED status.
2193 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
2194 # that have STOPPING status.
2195 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
2196 # that have SUSPENDED status.
2197 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
2198 # that have SUSPENDING status.
2199 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
2200 # that have TERMINATED status.
2201 },
2202 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
2203 # stable state. A stable state means that: none of the instances in the
2204 # managed instance group is currently undergoing any type of change (for
2205 # example, creation, restart, or deletion); no future changes are scheduled
2206 # for instances in the managed instance group; and the managed instance
2207 # group itself is not being modified.
2208 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
2209 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
2210 # has stateful configuration, that is, if you have configured any items
2211 # in a stateful policy or in per-instance configs.
2212 # The group might report that it has no stateful configuration even when
2213 # there is still some preserved state on a managed instance, for example,
2214 # if you have deleted all PICs but not yet applied those deletions.
2215 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
2216 # has stateful configuration, that is, if you have configured any items
2217 # in a stateful policy or in per-instance configs.
2218 # The group might report that it has no stateful configuration even when
2219 # there is still some preserved state on a managed instance, for example,
2220 # if you have deleted all PICs but not yet applied those deletions. This
2221 # field is deprecated in favor of has_stateful_config.
2222 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
2223 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
2224 # (listed in the output of a listPerInstanceConfigs API call) have
2225 # status EFFECTIVE or there are no per-instance-configs.
2226 },
2227 },
2228 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
2229 # target version specified by version field on Instance Group
2230 # Manager.
2231 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
2232 # in this managed instance group, i.e. all instances are in their target
2233 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
2234 },
2235 },
2236 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
2237 # apply to all of the instances in the managed instance group.
2238 &quot;A String&quot;,
2239 ],
2240 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
2241 # You can reduce this number by using the instanceGroupManager
2242 # deleteInstances or abandonInstances methods. Resizing the group also
2243 # changes this number.
2244 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
2245 # size.
2246 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
2247 # individually or all at once.
2248 },
2249 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
2250 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
2251 # This number changes when you:
2252 #
2253 # - Stop instance using the stopInstances
2254 # method or start instances using the startInstances
2255 # method.
2256 # - Manually change the targetStoppedSize using the update
2257 # method.
2258 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
2259 # This number changes when you:
2260 #
2261 # - Suspend instance using the suspendInstances
2262 # method or resume instances using the resumeInstances
2263 # method.
2264 # - Manually change the targetSuspendedSize using the update
2265 # method.
2266 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
2267 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
2268 &quot;A String&quot;,
2269 ],
2270 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
2271 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
2272 # instance redistribution policy for regional managed instance groups.
2273 # Valid values are:
2274 #
2275 # - PROACTIVE (default): The group attempts to maintain an
2276 # even distribution of VM instances across zones in the region.
2277 # - NONE: For non-autoscaled groups, proactive
2278 # redistribution is disabled.
2279 &quot;maxSurge&quot;: { # 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
2280 # either a fixed number or, if the group has 10 or more instances, a
2281 # percentage. If you set a percentage, the number of instances is rounded
2282 # if necessary. The default value for maxSurge is a fixed
2283 # value equal to the number of zones in which the managed instance group
2284 # operates.
2285 #
2286 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
2287 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
2288 #
2289 #
2290 #
2291 # - If the value is fixed, then the calculated
2292 # value is equal to the fixed value.
2293 # - If the value is a percent, then the
2294 # calculated
2295 # value is percent/100 * targetSize. For example,
2296 # the calculated value of a 80% of a managed instance group
2297 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
2298 # is a remainder, the number is rounded.
2299 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
2300 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
2301 # example, specify 80 for 80%.
2302 },
2303 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
2304 # process. An instance is considered available if all of the following
2305 # conditions are satisfied:
2306 #
2307 #
2308 #
2309 # - The instance&#x27;s status is
2310 # RUNNING.
2311 # - If there is a health
2312 # check on the instance group, the instance&#x27;s health check status
2313 # must be HEALTHY at least once. If there is no health check
2314 # on the group, then the instance only needs to have a status of
2315 # RUNNING to be considered available.
2316 #
2317 #
2318 # This value can be either a fixed number or, if the group has 10 or more
2319 # instances, a percentage. If you set a percentage, the number of instances
2320 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
2321 # in which the managed instance group operates.
2322 #
2323 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
2324 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
2325 #
2326 #
2327 #
2328 # - If the value is fixed, then the calculated
2329 # value is equal to the fixed value.
2330 # - If the value is a percent, then the
2331 # calculated
2332 # value is percent/100 * targetSize. For example,
2333 # the calculated value of a 80% of a managed instance group
2334 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
2335 # is a remainder, the number is rounded.
2336 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
2337 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
2338 # example, specify 80 for 80%.
2339 },
2340 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
2341 # becomes available. This value must be from range [0, 3600].
2342 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
2343 # disruption as much as possible or to apply a more disruptive action than
2344 # is necessary.
2345 #
2346 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
2347 # Compute Engine performs the necessary action to execute the update.
2348 # - To apply a more disruptive action than is strictly necessary, set the
2349 # minimal action to RESTART or REPLACE. For
2350 # example, Compute Engine does not need to restart a VM to change its
2351 # metadata. But if your application reads instance metadata only when a VM
2352 # is restarted, you can set the minimal action to RESTART in
2353 # order to pick up metadata changes.
2354 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
2355 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
2356 # as much as possible. RESTART to allow actions that can be
2357 # applied without instance replacing or REPLACE to allow all
2358 # possible actions. If the Updater determines that the minimal update
2359 # action needed is more disruptive than most disruptive allowed action you
2360 # specify it will not perform the update at all.
2361 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
2362 # See minimal_action.REPLACE
2363 &quot;type&quot;: &quot;A String&quot;, # The type
2364 # of update process. You can specify either PROACTIVE so
2365 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
2366 # to update.
2367 },
2368 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
2369 # create instances.
2370 #
2371 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
2372 # group. This field overrides the top-level instanceTemplate
2373 # field. Read more about therelationships
2374 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
2375 # remaining instances. For more information, read aboutcanary
2376 # updates.
2377 {
2378 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
2379 # instance group. The group uses this template to create new instances in
2380 # the managed instance group until the `targetSize` for this version is
2381 # reached. The templates for existing instances in the group do not change
2382 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
2383 # existing instances are updated until the `targetSize` for this version is
2384 # reached.
2385 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
2386 # managed instance group.
2387 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
2388 # even if instance_template remains unchanged.
2389 # Deprecated in favor of &#x27;name&#x27;.
2390 &quot;targetSize&quot;: { # 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
2391 # from the template will be equal to:
2392 #
2393 #
2394 # - If expressed as a fixed number, the minimum of either
2395 # targetSize.fixed or
2396 # instanceGroupManager.targetSize is used.
2397 # - if expressed as a percent, the targetSize
2398 # would be (targetSize.percent/100 *
2399 # InstanceGroupManager.targetSize) If there is a remainder, the
2400 # number is rounded.
2401 #
2402 # If unset, this version will update any remaining instances not
2403 # updated by another version. ReadStarting
2404 # a canary update for more information.
2405 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
2406 #
2407 #
2408 #
2409 # - If the value is fixed, then the calculated
2410 # value is equal to the fixed value.
2411 # - If the value is a percent, then the
2412 # calculated
2413 # value is percent/100 * targetSize. For example,
2414 # the calculated value of a 80% of a managed instance group
2415 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
2416 # is a remainder, the number is rounded.
2417 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
2418 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
2419 # example, specify 80 for 80%.
2420 },
2421 },
2422 ],
2423 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
2424 # where the managed instance group is located (for zonal resources).
2425 },
2426 ],
2427 &quot;warning&quot;: { # Output only. The warning that replaces the list of managed instance groups when the list
2428 # is empty.
2429 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2430 # Engine returns NO_RESULTS_ON_PAGE if there
2431 # are no results in the response.
2432 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2433 # value format. For example:
2434 #
2435 # &quot;data&quot;: [
2436 # {
2437 # &quot;key&quot;: &quot;scope&quot;,
2438 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2439 # }
2440 {
2441 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2442 # returned. For example, for warnings where there are no results in a list
2443 # request for a particular zone, this key might be scope and
2444 # the key value might be the zone name. Other examples might be a key
2445 # indicating a deprecated resource and a suggested replacement, or a
2446 # warning about invalid network settings (for example, if an instance
2447 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2448 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2449 },
2450 ],
2451 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2452 },
2453 },
2454 },
2455 &quot;kind&quot;: &quot;compute#instanceGroupManagerAggregatedList&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated
2456 # list of managed instance groups.
2457 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
2458 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
2459 # the query parameter pageToken in the next list request.
2460 # Subsequent list requests will have their own nextPageToken to
2461 # continue paging through the results.
2462 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
2463 &quot;unreachables&quot;: [ # Output only. Unreachable resources.
2464 &quot;A String&quot;,
2465 ],
2466 &quot;warning&quot;: { # Output only. Informational warning message.
2467 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2468 # Engine returns NO_RESULTS_ON_PAGE if there
2469 # are no results in the response.
2470 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2471 # value format. For example:
2472 #
2473 # &quot;data&quot;: [
2474 # {
2475 # &quot;key&quot;: &quot;scope&quot;,
2476 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2477 # }
2478 {
2479 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2480 # returned. For example, for warnings where there are no results in a list
2481 # request for a particular zone, this key might be scope and
2482 # the key value might be the zone name. Other examples might be a key
2483 # indicating a deprecated resource and a suggested replacement, or a
2484 # warning about invalid network settings (for example, if an instance
2485 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2486 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2487 },
2488 ],
2489 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2490 },
2491 }</pre>
2492 </div>
2493
2494 <div class="method">
2495 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
2496 <pre>Retrieves the next page of results.
2497
2498 Args:
2499 previous_request: The request for the previous page. (required)
2500 previous_response: The response from the request for the previous page. (required)
2501
2502 Returns:
2503 A request object that you can call &#x27;execute()&#x27; on to request the next
2504 page. Returns None if there are no more items in the collection.
2505 </pre>
2506 </div>
2507
2508 <div class="method">
2509 <code class="details" id="applyUpdatesToInstances">applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)</code>
2510 <pre>Applies changes to selected instances on the managed instance group.
2511 This method can be used to apply new overrides and/or new versions.
2512
2513 Args:
2514 project: string, Project ID for this request. (required)
2515 zone: string, The name of thezone
2516 where the managed instance group is located. Should conform to RFC1035. (required)
2517 instanceGroupManager: string, The name of the managed instance group, should conform to RFC1035. (required)
2518 body: object, The request body.
2519 The object takes the form of:
2520
2521 { # InstanceGroupManagers.applyUpdatesToInstances
2522 &quot;allInstances&quot;: True or False, # Flag to update all instances instead of specified list of “instances”.
2523 # If the flag is set to true then the instances may not be specified
2524 # in the request.
2525 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
2526 &quot;A String&quot;,
2527 ],
2528 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
2529 &quot;instances&quot;: [ # The list of URLs of one or more instances for which you want to apply
2530 # updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].
2531 &quot;A String&quot;,
2532 ],
2533 &quot;maximalAction&quot;: &quot;A String&quot;, # The maximal action that should be performed on the instances.
2534 # By default REPLACE.
2535 # This field is deprecated, please use most_disruptive_allowed_action.
2536 &quot;minimalAction&quot;: &quot;A String&quot;, # The minimal action that you want to perform on each instance during the
2537 # update:
2538 #
2539 #
2540 # - REPLACE: At minimum, delete the instance and create it
2541 # again.
2542 # - RESTART: Stop the instance and start it
2543 # again.
2544 # - REFRESH: Do not stop the instance and limit
2545 # disruption as much as possible.
2546 # - NONE: Do not
2547 # disrupt the instance at all.
2548 #
2549 #
2550 # By default, the minimum action is NONE. If your update
2551 # requires a more disruptive action than you set with this flag, the
2552 # necessary action is performed to execute the update.
2553 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # The most disruptive action that you want to perform on each instance during
2554 # the update:
2555 #
2556 #
2557 # - REPLACE: Delete the instance and create it again.
2558 # - RESTART: Stop the instance and start it again.
2559 # - REFRESH: Do not stop the instance and limit disruption
2560 # as much as possible.
2561 # - NONE: Do not disrupt the
2562 # instance at all.
2563 #
2564 #
2565 # By default, the most disruptive allowed action is REPLACE. If
2566 # your update requires a more disruptive action than you set with this flag,
2567 # the update request will fail.
2568 }
2569
2570 x__xgafv: string, V1 error format.
2571 Allowed values
2572 1 - v1 error format
2573 2 - v2 error format
2574
2575 Returns:
2576 An object of the form:
2577
2578 { # Represents an Operation resource.
2579 #
2580 # Google Compute Engine has three Operation resources:
2581 #
2582 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2583 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2584 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2585 #
2586 # You can use an operation resource to manage asynchronous API requests.
2587 # For more information, readHandling
2588 # API responses.
2589 #
2590 # Operations can be global, regional or zonal.
2591 #
2592 # - For global operations, use the `globalOperations`
2593 # resource.
2594 # - For regional operations, use the
2595 # `regionOperations` resource.
2596 # - For zonal operations, use
2597 # the `zoneOperations` resource.
2598 #
2599 #
2600 #
2601 # For more information, read
2602 # Global, Regional, and Zonal Resources.
2603 #
2604 # Note that completed Operation resources have a limited
2605 # retention period.
2606 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2607 # Not present otherwise.
2608 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2609 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2610 # set when the operation is created.
2611 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2612 # text format.
2613 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2614 # this field will be populated.
2615 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2616 # operation.
2617 {
2618 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2619 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2620 # details. There is a set of defined message types to use for providing
2621 # details.The syntax depends on the error code. For example,
2622 # QuotaExceededInfo will have details when the error code is
2623 # QUOTA_EXCEEDED.
2624 {
2625 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2626 #
2627 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2628 # is not enabled:
2629 #
2630 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2631 # &quot;domain&quot;: &quot;googleapis.com&quot;
2632 # &quot;metadata&quot;: {
2633 # &quot;resource&quot;: &quot;projects/123&quot;,
2634 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2635 # }
2636 # }
2637 #
2638 # This response indicates that the pubsub.googleapis.com API is not enabled.
2639 #
2640 # Example of an error that is returned when attempting to create a Spanner
2641 # instance in a region that is out of stock:
2642 #
2643 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2644 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2645 # &quot;metadata&quot;: {
2646 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2647 # }
2648 # }
2649 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2650 # is typically the registered service name of the tool or product that
2651 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2652 # generated by some common infrastructure, the error domain must be a
2653 # globally unique value that identifies the infrastructure. For Google API
2654 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2655 &quot;metadatas&quot;: { # Additional structured details about this error.
2656 #
2657 # Keys must match a regular expression of `a-z+` but should
2658 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2659 # length. When identifying the current value of an exceeded limit, the units
2660 # should be contained in the key, not the value. For example, rather than
2661 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2662 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2663 # instances that can be created in a single (batch) request.
2664 &quot;a_key&quot;: &quot;A String&quot;,
2665 },
2666 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2667 # proximate cause of the error. Error reasons are unique within a particular
2668 # domain of errors. This should be at most 63 characters and match a
2669 # regular expression of `A-Z+[A-Z0-9]`, which represents
2670 # UPPER_SNAKE_CASE.
2671 },
2672 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2673 #
2674 # For example, if a quota check failed with an error indicating the calling
2675 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2676 # directly to the right place in the developer console to flip the bit.
2677 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2678 { # Describes a URL link.
2679 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2680 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2681 },
2682 ],
2683 },
2684 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2685 # which can be attached to an RPC error.
2686 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2687 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2688 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2689 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2690 },
2691 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2692 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2693 &quot;a_key&quot;: &quot;A String&quot;,
2694 },
2695 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2696 # type or metric.
2697 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2698 # or metric.
2699 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2700 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2701 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2702 },
2703 },
2704 ],
2705 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2706 # This property is optional.
2707 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2708 },
2709 ],
2710 },
2711 &quot;getVersionOperationMetadata&quot;: {
2712 &quot;inlineSbomInfo&quot;: {
2713 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2714 # appropriate identifiers.
2715 &quot;a_key&quot;: &quot;A String&quot;,
2716 },
2717 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2718 # identifiers.
2719 &quot;a_key&quot;: &quot;A String&quot;,
2720 },
2721 },
2722 },
2723 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2724 # message that was returned, such as `NOT FOUND`.
2725 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2726 # status code that was returned. For example, a `404` means the
2727 # resource was not found.
2728 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2729 # defined by the server.
2730 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2731 # This value is inRFC3339
2732 # text format.
2733 &quot;instancesBulkInsertOperationMetadata&quot;: {
2734 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2735 # Example key: zones/us-central1-a
2736 &quot;a_key&quot;: {
2737 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2738 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2739 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2740 # error.
2741 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2742 # if the flow is rolling forward or rolling back.
2743 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2744 },
2745 },
2746 },
2747 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2748 # Operation resources.
2749 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2750 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2751 # group of operations results from a `bulkInsert` API request.
2752 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2753 # `update`, or `delete`, and so on.
2754 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2755 # There is no requirement that this be linear or support any granularity of
2756 # operations. This should not be used to guess when the operation will be
2757 # complete. This number should monotonically increase as the operation
2758 # progresses.
2759 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2760 # applicable when performing regional operations.
2761 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2762 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2763 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2764 # this field will contain information on all underlying zonal actions and
2765 # their state.
2766 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2767 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2768 # Example key: zones/us-central1-a
2769 &quot;a_key&quot;: {
2770 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
2771 # populated.
2772 # different programming environments, including REST APIs and RPC APIs. It is
2773 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2774 # three pieces of data: error code, error message, and error details.
2775 #
2776 # You can find out more about this error model and how to work with it in the
2777 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2778 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2779 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2780 # message types for APIs to use.
2781 {
2782 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2783 },
2784 ],
2785 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2786 # user-facing error message should be localized and sent in the
2787 # google.rpc.Status.details field, or localized by the client.
2788 },
2789 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2790 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2791 },
2792 },
2793 },
2794 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2795 # This value is inRFC3339
2796 # text format.
2797 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2798 # following:
2799 # `PENDING`, `RUNNING`, or `DONE`.
2800 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2801 # operation.
2802 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2803 # of the target resource.
2804 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2805 # operations related to creating a snapshot, this points to the disk
2806 # that the snapshot was created from.
2807 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2808 # `[email protected]` or
2809 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2810 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2811 # operation, this field will be populated.
2812 {
2813 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2814 # Engine returns NO_RESULTS_ON_PAGE if there
2815 # are no results in the response.
2816 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2817 # value format. For example:
2818 #
2819 # &quot;data&quot;: [
2820 # {
2821 # &quot;key&quot;: &quot;scope&quot;,
2822 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2823 # }
2824 {
2825 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2826 # returned. For example, for warnings where there are no results in a list
2827 # request for a particular zone, this key might be scope and
2828 # the key value might be the zone name. Other examples might be a key
2829 # indicating a deprecated resource and a suggested replacement, or a
2830 # warning about invalid network settings (for example, if an instance
2831 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2832 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2833 },
2834 ],
2835 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2836 },
2837 ],
2838 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2839 # applicable when performing per-zone operations.
2840 }</pre>
2841 </div>
2842
2843 <div class="method">
2844 <code class="details" id="close">close()</code>
2845 <pre>Close httplib2 connections.</pre>
2846 </div>
2847
2848 <div class="method">
2849 <code class="details" id="configureAcceleratorTopologies">configureAcceleratorTopologies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
2850 <pre>Updates the accelerator topologies configuration.
2851
2852 Args:
2853 project: string, Project ID for this request. (required)
2854 zone: string, The name of thezone
2855 where the managed instance group is located.
2856 It should conform to RFC1035. (required)
2857 instanceGroupManager: string, The name of the managed instance group.
2858 It should conform to RFC1035. (required)
2859 body: object, The request body.
2860 The object takes the form of:
2861
2862 { # InstanceGroupManagers.ConfigureAcceleratorTopologies
2863 &quot;acceleratorTopologyActions&quot;: { # Map of accelerator topologies that should have their state changed to
2864 # the specified value. The key is the hashed topology locus id. It can be
2865 # obtained from the GetAvailableAcceleratorTopologies rpc.
2866 &quot;a_key&quot;: &quot;A String&quot;,
2867 },
2868 &quot;acceleratorTopologyConfigurations&quot;: { # Map of accelerator topologies that should have their state changed to
2869 # the specified configuration. The map key is the hashed topology locus id.
2870 # It can be obtained from the GetAvailableAcceleratorTopologies rpc.
2871 &quot;a_key&quot;: { # Configuration for a single accelerator topology.
2872 &quot;action&quot;: &quot;A String&quot;,
2873 &quot;externalId&quot;: &quot;A String&quot;, # Identifier of the accelerator topology assigned externally to
2874 # differentiate who is the owner of the topology. The format needs to
2875 # conform to RFC1035 and be unique. The uniqueness is guaranteed by the
2876 # requestor. If it is provided on activating the sub-slice it will have to
2877 # be provided on deactivating as well. This identifier is cleared on
2878 # successful deform of a sub-slice.
2879 },
2880 },
2881 }
2882
2883 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2884 that if you must retry your request, the server will know to ignore the
2885 request if it has already been completed.
2886
2887 For example, consider a situation where you make an initial request and
2888 the request times out. If you make the request again with the same
2889 request ID, the server can check if original operation with the same
2890 request ID was received, and if so, will ignore the second request.
2891
2892 The request ID must be
2893 a valid UUID with the exception that zero UUID is not supported
2894 (00000000-0000-0000-0000-000000000000).
2895 x__xgafv: string, V1 error format.
2896 Allowed values
2897 1 - v1 error format
2898 2 - v2 error format
2899
2900 Returns:
2901 An object of the form:
2902
2903 { # Represents an Operation resource.
2904 #
2905 # Google Compute Engine has three Operation resources:
2906 #
2907 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2908 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2909 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2910 #
2911 # You can use an operation resource to manage asynchronous API requests.
2912 # For more information, readHandling
2913 # API responses.
2914 #
2915 # Operations can be global, regional or zonal.
2916 #
2917 # - For global operations, use the `globalOperations`
2918 # resource.
2919 # - For regional operations, use the
2920 # `regionOperations` resource.
2921 # - For zonal operations, use
2922 # the `zoneOperations` resource.
2923 #
2924 #
2925 #
2926 # For more information, read
2927 # Global, Regional, and Zonal Resources.
2928 #
2929 # Note that completed Operation resources have a limited
2930 # retention period.
2931 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2932 # Not present otherwise.
2933 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2934 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2935 # set when the operation is created.
2936 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2937 # text format.
2938 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2939 # this field will be populated.
2940 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2941 # operation.
2942 {
2943 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2944 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2945 # details. There is a set of defined message types to use for providing
2946 # details.The syntax depends on the error code. For example,
2947 # QuotaExceededInfo will have details when the error code is
2948 # QUOTA_EXCEEDED.
2949 {
2950 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2951 #
2952 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2953 # is not enabled:
2954 #
2955 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2956 # &quot;domain&quot;: &quot;googleapis.com&quot;
2957 # &quot;metadata&quot;: {
2958 # &quot;resource&quot;: &quot;projects/123&quot;,
2959 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2960 # }
2961 # }
2962 #
2963 # This response indicates that the pubsub.googleapis.com API is not enabled.
2964 #
2965 # Example of an error that is returned when attempting to create a Spanner
2966 # instance in a region that is out of stock:
2967 #
2968 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2969 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2970 # &quot;metadata&quot;: {
2971 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2972 # }
2973 # }
2974 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2975 # is typically the registered service name of the tool or product that
2976 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2977 # generated by some common infrastructure, the error domain must be a
2978 # globally unique value that identifies the infrastructure. For Google API
2979 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2980 &quot;metadatas&quot;: { # Additional structured details about this error.
2981 #
2982 # Keys must match a regular expression of `a-z+` but should
2983 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2984 # length. When identifying the current value of an exceeded limit, the units
2985 # should be contained in the key, not the value. For example, rather than
2986 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2987 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2988 # instances that can be created in a single (batch) request.
2989 &quot;a_key&quot;: &quot;A String&quot;,
2990 },
2991 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2992 # proximate cause of the error. Error reasons are unique within a particular
2993 # domain of errors. This should be at most 63 characters and match a
2994 # regular expression of `A-Z+[A-Z0-9]`, which represents
2995 # UPPER_SNAKE_CASE.
2996 },
2997 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2998 #
2999 # For example, if a quota check failed with an error indicating the calling
3000 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3001 # directly to the right place in the developer console to flip the bit.
3002 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3003 { # Describes a URL link.
3004 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3005 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3006 },
3007 ],
3008 },
3009 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3010 # which can be attached to an RPC error.
3011 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3012 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3013 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3014 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3015 },
3016 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3017 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3018 &quot;a_key&quot;: &quot;A String&quot;,
3019 },
3020 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3021 # type or metric.
3022 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3023 # or metric.
3024 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3025 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3026 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3027 },
3028 },
3029 ],
3030 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3031 # This property is optional.
3032 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3033 },
3034 ],
3035 },
3036 &quot;getVersionOperationMetadata&quot;: {
3037 &quot;inlineSbomInfo&quot;: {
3038 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3039 # appropriate identifiers.
3040 &quot;a_key&quot;: &quot;A String&quot;,
3041 },
3042 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3043 # identifiers.
3044 &quot;a_key&quot;: &quot;A String&quot;,
3045 },
3046 },
3047 },
3048 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3049 # message that was returned, such as `NOT FOUND`.
3050 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3051 # status code that was returned. For example, a `404` means the
3052 # resource was not found.
3053 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3054 # defined by the server.
3055 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3056 # This value is inRFC3339
3057 # text format.
3058 &quot;instancesBulkInsertOperationMetadata&quot;: {
3059 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3060 # Example key: zones/us-central1-a
3061 &quot;a_key&quot;: {
3062 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3063 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3064 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3065 # error.
3066 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3067 # if the flow is rolling forward or rolling back.
3068 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3069 },
3070 },
3071 },
3072 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3073 # Operation resources.
3074 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3075 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3076 # group of operations results from a `bulkInsert` API request.
3077 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3078 # `update`, or `delete`, and so on.
3079 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3080 # There is no requirement that this be linear or support any granularity of
3081 # operations. This should not be used to guess when the operation will be
3082 # complete. This number should monotonically increase as the operation
3083 # progresses.
3084 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3085 # applicable when performing regional operations.
3086 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3087 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3088 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3089 # this field will contain information on all underlying zonal actions and
3090 # their state.
3091 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3092 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3093 # Example key: zones/us-central1-a
3094 &quot;a_key&quot;: {
3095 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
3096 # populated.
3097 # different programming environments, including REST APIs and RPC APIs. It is
3098 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3099 # three pieces of data: error code, error message, and error details.
3100 #
3101 # You can find out more about this error model and how to work with it in the
3102 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3103 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3104 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3105 # message types for APIs to use.
3106 {
3107 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3108 },
3109 ],
3110 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3111 # user-facing error message should be localized and sent in the
3112 # google.rpc.Status.details field, or localized by the client.
3113 },
3114 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3115 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3116 },
3117 },
3118 },
3119 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3120 # This value is inRFC3339
3121 # text format.
3122 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3123 # following:
3124 # `PENDING`, `RUNNING`, or `DONE`.
3125 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3126 # operation.
3127 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3128 # of the target resource.
3129 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3130 # operations related to creating a snapshot, this points to the disk
3131 # that the snapshot was created from.
3132 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3133 # `[email protected]` or
3134 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3135 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3136 # operation, this field will be populated.
3137 {
3138 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3139 # Engine returns NO_RESULTS_ON_PAGE if there
3140 # are no results in the response.
3141 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3142 # value format. For example:
3143 #
3144 # &quot;data&quot;: [
3145 # {
3146 # &quot;key&quot;: &quot;scope&quot;,
3147 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3148 # }
3149 {
3150 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3151 # returned. For example, for warnings where there are no results in a list
3152 # request for a particular zone, this key might be scope and
3153 # the key value might be the zone name. Other examples might be a key
3154 # indicating a deprecated resource and a suggested replacement, or a
3155 # warning about invalid network settings (for example, if an instance
3156 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3157 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3158 },
3159 ],
3160 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3161 },
3162 ],
3163 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3164 # applicable when performing per-zone operations.
3165 }</pre>
3166 </div>
3167
3168 <div class="method">
3169 <code class="details" id="createInstances">createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
3170 <pre>Creates instances with per-instance configurations in this managed instance
3171 group. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions
3172 take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
3173 method.
3174
3175 Args:
3176 project: string, Project ID for this request. (required)
3177 zone: string, The name of thezone
3178 where the managed instance group is located.
3179 It should conform to RFC1035. (required)
3180 instanceGroupManager: string, The name of the managed instance group.
3181 It should conform to RFC1035. (required)
3182 body: object, The request body.
3183 The object takes the form of:
3184
3185 { # InstanceGroupManagers.createInstances
3186 &quot;instances&quot;: [ # [Required] List of specifications of per-instance configs.
3187 {
3188 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
3189 # optimistic locking. It is ignored when inserting a per-instance
3190 # config. An up-to-date fingerprint must be provided in order to update an
3191 # existing per-instance configuration or the field needs to be unset.
3192 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
3193 # Serves as a merge key during UpdatePerInstanceConfigs
3194 # operations, that is, if a per-instance configuration with the same name
3195 # exists then it will be updated, otherwise a new one will be created for the
3196 # VM instance with the same name. An attempt to create a per-instance
3197 # configuration for a VM instance that either doesn&#x27;t exist or is not part
3198 # of the group will result in an error.
3199 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
3200 # preserved state generated from a stateful policy.
3201 &quot;disks&quot;: { # Preserved disks defined for this instance.
3202 # This map is keyed with the device names of the disks.
3203 &quot;a_key&quot;: {
3204 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
3205 # update, instance recreate operations. This flag is used to configure
3206 # if the disk should be deleted after it is no longer used by the group,
3207 # e.g. when the given instance or the whole MIG is deleted.
3208 # Note: disks attached in READ_ONLY mode cannot be
3209 # auto-deleted.
3210 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
3211 # disk in READ_WRITE mode.
3212 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
3213 # to the VM instance.
3214 },
3215 },
3216 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
3217 # This map is keyed with the name of the network interface.
3218 &quot;a_key&quot;: {
3219 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
3220 # update or VM instance recreate operations.
3221 # This flag is used to configure if the IP reservation should be deleted
3222 # after it is no longer used by the group, e.g. when the given instance
3223 # or the whole group is deleted.
3224 &quot;ipAddress&quot;: { # Ip address representation
3225 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
3226 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
3227 # network interface.
3228 },
3229 },
3230 },
3231 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
3232 # This map is keyed with the name of the network interface.
3233 &quot;a_key&quot;: {
3234 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
3235 # update or VM instance recreate operations.
3236 # This flag is used to configure if the IP reservation should be deleted
3237 # after it is no longer used by the group, e.g. when the given instance
3238 # or the whole group is deleted.
3239 &quot;ipAddress&quot;: { # Ip address representation
3240 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
3241 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
3242 # network interface.
3243 },
3244 },
3245 },
3246 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
3247 &quot;a_key&quot;: &quot;A String&quot;,
3248 },
3249 },
3250 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
3251 # managed instance.
3252 },
3253 ],
3254 }
3255
3256 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3257 that if you must retry your request, the server will know to ignore the
3258 request if it has already been completed.
3259
3260 For example, consider a situation where you make an initial request and
3261 the request times out. If you make the request again with the same
3262 request ID, the server can check if original operation with the same
3263 request ID was received, and if so, will ignore the second request.
3264
3265 The request ID must be
3266 a valid UUID with the exception that zero UUID is not supported
3267 (00000000-0000-0000-0000-000000000000).
3268 x__xgafv: string, V1 error format.
3269 Allowed values
3270 1 - v1 error format
3271 2 - v2 error format
3272
3273 Returns:
3274 An object of the form:
3275
3276 { # Represents an Operation resource.
3277 #
3278 # Google Compute Engine has three Operation resources:
3279 #
3280 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
3281 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
3282 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
3283 #
3284 # You can use an operation resource to manage asynchronous API requests.
3285 # For more information, readHandling
3286 # API responses.
3287 #
3288 # Operations can be global, regional or zonal.
3289 #
3290 # - For global operations, use the `globalOperations`
3291 # resource.
3292 # - For regional operations, use the
3293 # `regionOperations` resource.
3294 # - For zonal operations, use
3295 # the `zoneOperations` resource.
3296 #
3297 #
3298 #
3299 # For more information, read
3300 # Global, Regional, and Zonal Resources.
3301 #
3302 # Note that completed Operation resources have a limited
3303 # retention period.
3304 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3305 # Not present otherwise.
3306 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3307 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3308 # set when the operation is created.
3309 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3310 # text format.
3311 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3312 # this field will be populated.
3313 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3314 # operation.
3315 {
3316 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3317 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3318 # details. There is a set of defined message types to use for providing
3319 # details.The syntax depends on the error code. For example,
3320 # QuotaExceededInfo will have details when the error code is
3321 # QUOTA_EXCEEDED.
3322 {
3323 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3324 #
3325 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3326 # is not enabled:
3327 #
3328 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3329 # &quot;domain&quot;: &quot;googleapis.com&quot;
3330 # &quot;metadata&quot;: {
3331 # &quot;resource&quot;: &quot;projects/123&quot;,
3332 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3333 # }
3334 # }
3335 #
3336 # This response indicates that the pubsub.googleapis.com API is not enabled.
3337 #
3338 # Example of an error that is returned when attempting to create a Spanner
3339 # instance in a region that is out of stock:
3340 #
3341 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3342 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3343 # &quot;metadata&quot;: {
3344 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3345 # }
3346 # }
3347 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3348 # is typically the registered service name of the tool or product that
3349 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3350 # generated by some common infrastructure, the error domain must be a
3351 # globally unique value that identifies the infrastructure. For Google API
3352 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3353 &quot;metadatas&quot;: { # Additional structured details about this error.
3354 #
3355 # Keys must match a regular expression of `a-z+` but should
3356 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3357 # length. When identifying the current value of an exceeded limit, the units
3358 # should be contained in the key, not the value. For example, rather than
3359 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3360 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3361 # instances that can be created in a single (batch) request.
3362 &quot;a_key&quot;: &quot;A String&quot;,
3363 },
3364 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3365 # proximate cause of the error. Error reasons are unique within a particular
3366 # domain of errors. This should be at most 63 characters and match a
3367 # regular expression of `A-Z+[A-Z0-9]`, which represents
3368 # UPPER_SNAKE_CASE.
3369 },
3370 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3371 #
3372 # For example, if a quota check failed with an error indicating the calling
3373 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3374 # directly to the right place in the developer console to flip the bit.
3375 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3376 { # Describes a URL link.
3377 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3378 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3379 },
3380 ],
3381 },
3382 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3383 # which can be attached to an RPC error.
3384 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3385 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3386 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3387 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3388 },
3389 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3390 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3391 &quot;a_key&quot;: &quot;A String&quot;,
3392 },
3393 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3394 # type or metric.
3395 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3396 # or metric.
3397 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3398 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3399 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3400 },
3401 },
3402 ],
3403 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3404 # This property is optional.
3405 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3406 },
3407 ],
3408 },
3409 &quot;getVersionOperationMetadata&quot;: {
3410 &quot;inlineSbomInfo&quot;: {
3411 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3412 # appropriate identifiers.
3413 &quot;a_key&quot;: &quot;A String&quot;,
3414 },
3415 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3416 # identifiers.
3417 &quot;a_key&quot;: &quot;A String&quot;,
3418 },
3419 },
3420 },
3421 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3422 # message that was returned, such as `NOT FOUND`.
3423 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3424 # status code that was returned. For example, a `404` means the
3425 # resource was not found.
3426 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3427 # defined by the server.
3428 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3429 # This value is inRFC3339
3430 # text format.
3431 &quot;instancesBulkInsertOperationMetadata&quot;: {
3432 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3433 # Example key: zones/us-central1-a
3434 &quot;a_key&quot;: {
3435 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3436 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3437 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3438 # error.
3439 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3440 # if the flow is rolling forward or rolling back.
3441 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3442 },
3443 },
3444 },
3445 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3446 # Operation resources.
3447 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3448 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3449 # group of operations results from a `bulkInsert` API request.
3450 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3451 # `update`, or `delete`, and so on.
3452 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3453 # There is no requirement that this be linear or support any granularity of
3454 # operations. This should not be used to guess when the operation will be
3455 # complete. This number should monotonically increase as the operation
3456 # progresses.
3457 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3458 # applicable when performing regional operations.
3459 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3460 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3461 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3462 # this field will contain information on all underlying zonal actions and
3463 # their state.
3464 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3465 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3466 # Example key: zones/us-central1-a
3467 &quot;a_key&quot;: {
3468 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
3469 # populated.
3470 # different programming environments, including REST APIs and RPC APIs. It is
3471 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3472 # three pieces of data: error code, error message, and error details.
3473 #
3474 # You can find out more about this error model and how to work with it in the
3475 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3476 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3477 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3478 # message types for APIs to use.
3479 {
3480 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3481 },
3482 ],
3483 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3484 # user-facing error message should be localized and sent in the
3485 # google.rpc.Status.details field, or localized by the client.
3486 },
3487 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3488 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3489 },
3490 },
3491 },
3492 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3493 # This value is inRFC3339
3494 # text format.
3495 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3496 # following:
3497 # `PENDING`, `RUNNING`, or `DONE`.
3498 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3499 # operation.
3500 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3501 # of the target resource.
3502 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3503 # operations related to creating a snapshot, this points to the disk
3504 # that the snapshot was created from.
3505 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3506 # `[email protected]` or
3507 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3508 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3509 # operation, this field will be populated.
3510 {
3511 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3512 # Engine returns NO_RESULTS_ON_PAGE if there
3513 # are no results in the response.
3514 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3515 # value format. For example:
3516 #
3517 # &quot;data&quot;: [
3518 # {
3519 # &quot;key&quot;: &quot;scope&quot;,
3520 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3521 # }
3522 {
3523 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3524 # returned. For example, for warnings where there are no results in a list
3525 # request for a particular zone, this key might be scope and
3526 # the key value might be the zone name. Other examples might be a key
3527 # indicating a deprecated resource and a suggested replacement, or a
3528 # warning about invalid network settings (for example, if an instance
3529 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3530 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3531 },
3532 ],
3533 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3534 },
3535 ],
3536 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3537 # applicable when performing per-zone operations.
3538 }</pre>
3539 </div>
3540
3541 <div class="method">
3542 <code class="details" id="delete">delete(project, zone, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
3543 <pre>Deletes the specified managed instance group and all of the instances
3544 in that group. Note that the instance group must not belong to a
3545 backend service. Read
3546 Deleting an instance group for more information.
3547
3548 Args:
3549 project: string, Project ID for this request. (required)
3550 zone: string, The name of thezone where the managed
3551 instance group is located. (required)
3552 instanceGroupManager: string, The name of the managed instance group to delete. (required)
3553 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
3554 configured for the instances.
3555 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3556 that if you must retry your request, the server will know to ignore the
3557 request if it has already been completed.
3558
3559 For example, consider a situation where you make an initial request and
3560 the request times out. If you make the request again with the same
3561 request ID, the server can check if original operation with the same
3562 request ID was received, and if so, will ignore the second request. This
3563 prevents clients from accidentally creating duplicate commitments.
3564
3565 The request ID must be
3566 a valid UUID with the exception that zero UUID is not supported
3567 (00000000-0000-0000-0000-000000000000).
3568 x__xgafv: string, V1 error format.
3569 Allowed values
3570 1 - v1 error format
3571 2 - v2 error format
3572
3573 Returns:
3574 An object of the form:
3575
3576 { # Represents an Operation resource.
3577 #
3578 # Google Compute Engine has three Operation resources:
3579 #
3580 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
3581 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
3582 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
3583 #
3584 # You can use an operation resource to manage asynchronous API requests.
3585 # For more information, readHandling
3586 # API responses.
3587 #
3588 # Operations can be global, regional or zonal.
3589 #
3590 # - For global operations, use the `globalOperations`
3591 # resource.
3592 # - For regional operations, use the
3593 # `regionOperations` resource.
3594 # - For zonal operations, use
3595 # the `zoneOperations` resource.
3596 #
3597 #
3598 #
3599 # For more information, read
3600 # Global, Regional, and Zonal Resources.
3601 #
3602 # Note that completed Operation resources have a limited
3603 # retention period.
3604 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3605 # Not present otherwise.
3606 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3607 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3608 # set when the operation is created.
3609 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3610 # text format.
3611 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3612 # this field will be populated.
3613 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3614 # operation.
3615 {
3616 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3617 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3618 # details. There is a set of defined message types to use for providing
3619 # details.The syntax depends on the error code. For example,
3620 # QuotaExceededInfo will have details when the error code is
3621 # QUOTA_EXCEEDED.
3622 {
3623 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3624 #
3625 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3626 # is not enabled:
3627 #
3628 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3629 # &quot;domain&quot;: &quot;googleapis.com&quot;
3630 # &quot;metadata&quot;: {
3631 # &quot;resource&quot;: &quot;projects/123&quot;,
3632 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3633 # }
3634 # }
3635 #
3636 # This response indicates that the pubsub.googleapis.com API is not enabled.
3637 #
3638 # Example of an error that is returned when attempting to create a Spanner
3639 # instance in a region that is out of stock:
3640 #
3641 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3642 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3643 # &quot;metadata&quot;: {
3644 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3645 # }
3646 # }
3647 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3648 # is typically the registered service name of the tool or product that
3649 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3650 # generated by some common infrastructure, the error domain must be a
3651 # globally unique value that identifies the infrastructure. For Google API
3652 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3653 &quot;metadatas&quot;: { # Additional structured details about this error.
3654 #
3655 # Keys must match a regular expression of `a-z+` but should
3656 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3657 # length. When identifying the current value of an exceeded limit, the units
3658 # should be contained in the key, not the value. For example, rather than
3659 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3660 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3661 # instances that can be created in a single (batch) request.
3662 &quot;a_key&quot;: &quot;A String&quot;,
3663 },
3664 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3665 # proximate cause of the error. Error reasons are unique within a particular
3666 # domain of errors. This should be at most 63 characters and match a
3667 # regular expression of `A-Z+[A-Z0-9]`, which represents
3668 # UPPER_SNAKE_CASE.
3669 },
3670 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3671 #
3672 # For example, if a quota check failed with an error indicating the calling
3673 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3674 # directly to the right place in the developer console to flip the bit.
3675 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3676 { # Describes a URL link.
3677 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3678 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3679 },
3680 ],
3681 },
3682 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3683 # which can be attached to an RPC error.
3684 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3685 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3686 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3687 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3688 },
3689 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3690 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3691 &quot;a_key&quot;: &quot;A String&quot;,
3692 },
3693 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3694 # type or metric.
3695 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3696 # or metric.
3697 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3698 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3699 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3700 },
3701 },
3702 ],
3703 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3704 # This property is optional.
3705 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3706 },
3707 ],
3708 },
3709 &quot;getVersionOperationMetadata&quot;: {
3710 &quot;inlineSbomInfo&quot;: {
3711 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3712 # appropriate identifiers.
3713 &quot;a_key&quot;: &quot;A String&quot;,
3714 },
3715 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3716 # identifiers.
3717 &quot;a_key&quot;: &quot;A String&quot;,
3718 },
3719 },
3720 },
3721 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3722 # message that was returned, such as `NOT FOUND`.
3723 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3724 # status code that was returned. For example, a `404` means the
3725 # resource was not found.
3726 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3727 # defined by the server.
3728 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3729 # This value is inRFC3339
3730 # text format.
3731 &quot;instancesBulkInsertOperationMetadata&quot;: {
3732 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3733 # Example key: zones/us-central1-a
3734 &quot;a_key&quot;: {
3735 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3736 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3737 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3738 # error.
3739 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3740 # if the flow is rolling forward or rolling back.
3741 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3742 },
3743 },
3744 },
3745 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3746 # Operation resources.
3747 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3748 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3749 # group of operations results from a `bulkInsert` API request.
3750 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3751 # `update`, or `delete`, and so on.
3752 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3753 # There is no requirement that this be linear or support any granularity of
3754 # operations. This should not be used to guess when the operation will be
3755 # complete. This number should monotonically increase as the operation
3756 # progresses.
3757 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3758 # applicable when performing regional operations.
3759 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3760 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3761 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3762 # this field will contain information on all underlying zonal actions and
3763 # their state.
3764 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3765 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3766 # Example key: zones/us-central1-a
3767 &quot;a_key&quot;: {
3768 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
3769 # populated.
3770 # different programming environments, including REST APIs and RPC APIs. It is
3771 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3772 # three pieces of data: error code, error message, and error details.
3773 #
3774 # You can find out more about this error model and how to work with it in the
3775 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3776 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3777 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3778 # message types for APIs to use.
3779 {
3780 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3781 },
3782 ],
3783 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3784 # user-facing error message should be localized and sent in the
3785 # google.rpc.Status.details field, or localized by the client.
3786 },
3787 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3788 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3789 },
3790 },
3791 },
3792 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3793 # This value is inRFC3339
3794 # text format.
3795 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3796 # following:
3797 # `PENDING`, `RUNNING`, or `DONE`.
3798 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3799 # operation.
3800 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3801 # of the target resource.
3802 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3803 # operations related to creating a snapshot, this points to the disk
3804 # that the snapshot was created from.
3805 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3806 # `[email protected]` or
3807 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3808 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3809 # operation, this field will be populated.
3810 {
3811 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3812 # Engine returns NO_RESULTS_ON_PAGE if there
3813 # are no results in the response.
3814 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3815 # value format. For example:
3816 #
3817 # &quot;data&quot;: [
3818 # {
3819 # &quot;key&quot;: &quot;scope&quot;,
3820 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3821 # }
3822 {
3823 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3824 # returned. For example, for warnings where there are no results in a list
3825 # request for a particular zone, this key might be scope and
3826 # the key value might be the zone name. Other examples might be a key
3827 # indicating a deprecated resource and a suggested replacement, or a
3828 # warning about invalid network settings (for example, if an instance
3829 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3830 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3831 },
3832 ],
3833 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3834 },
3835 ],
3836 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3837 # applicable when performing per-zone operations.
3838 }</pre>
3839 </div>
3840
3841 <div class="method">
3842 <code class="details" id="deleteInstances">deleteInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
3843 <pre>Flags the specified instances in the managed instance group for immediate
3844 deletion. The instances are also removed from any target
3845 pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
3846 instances that you delete. This operation is marked as DONE
3847 when the action is scheduled even if the instances are still being deleted.
3848 You must separately verify the status of the deleting action
3849 with thelistmanagedinstances
3850 method.
3851
3852 If the group is part of a backend
3853 service that has enabled
3854 connection draining, it can take up to 60 seconds after the connection
3855 draining duration has elapsed before the VM instance is removed or deleted.
3856
3857 You can specify a maximum of 1000 instances with this method per request.
3858
3859 Args:
3860 project: string, Project ID for this request. (required)
3861 zone: string, The name of thezone where the managed
3862 instance group is located. (required)
3863 instanceGroupManager: string, The name of the managed instance group. (required)
3864 body: object, The request body.
3865 The object takes the form of:
3866
3867 {
3868 &quot;instanceNames&quot;: [ # The list of instance names to delete. Queued instances do not have URL and
3869 # can be deleted only by name. You cannot specify both URLs and names in a
3870 # single request.
3871 &quot;A String&quot;,
3872 ],
3873 &quot;instances&quot;: [ # The URLs of one or more instances to delete. This can be a full URL or
3874 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
3875 # Queued instances do not have URL and can be deleted only by name.
3876 # One cannot specify both URLs and names in a single request.
3877 &quot;A String&quot;,
3878 ],
3879 &quot;skipInstancesOnValidationError&quot;: True or False, # Specifies whether the request should proceed despite the inclusion of
3880 # instances that are not members of the group or that are already in the
3881 # process of being deleted or abandoned. If this field is set to `false` and
3882 # such an instance is specified in the request, the operation fails. The
3883 # operation always fails if the request contains a malformed instance URL or
3884 # a reference to an instance that exists in a zone or region other than the
3885 # group&#x27;s zone or region.
3886 }
3887
3888 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
3889 configured for the instances.
3890 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3891 that if you must retry your request, the server will know to ignore the
3892 request if it has already been completed.
3893
3894 For example, consider a situation where you make an initial request and
3895 the request times out. If you make the request again with the same
3896 request ID, the server can check if original operation with the same
3897 request ID was received, and if so, will ignore the second request. This
3898 prevents clients from accidentally creating duplicate commitments.
3899
3900 The request ID must be
3901 a valid UUID with the exception that zero UUID is not supported
3902 (00000000-0000-0000-0000-000000000000).
3903 x__xgafv: string, V1 error format.
3904 Allowed values
3905 1 - v1 error format
3906 2 - v2 error format
3907
3908 Returns:
3909 An object of the form:
3910
3911 { # Represents an Operation resource.
3912 #
3913 # Google Compute Engine has three Operation resources:
3914 #
3915 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
3916 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
3917 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
3918 #
3919 # You can use an operation resource to manage asynchronous API requests.
3920 # For more information, readHandling
3921 # API responses.
3922 #
3923 # Operations can be global, regional or zonal.
3924 #
3925 # - For global operations, use the `globalOperations`
3926 # resource.
3927 # - For regional operations, use the
3928 # `regionOperations` resource.
3929 # - For zonal operations, use
3930 # the `zoneOperations` resource.
3931 #
3932 #
3933 #
3934 # For more information, read
3935 # Global, Regional, and Zonal Resources.
3936 #
3937 # Note that completed Operation resources have a limited
3938 # retention period.
3939 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3940 # Not present otherwise.
3941 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3942 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3943 # set when the operation is created.
3944 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3945 # text format.
3946 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3947 # this field will be populated.
3948 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3949 # operation.
3950 {
3951 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3952 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3953 # details. There is a set of defined message types to use for providing
3954 # details.The syntax depends on the error code. For example,
3955 # QuotaExceededInfo will have details when the error code is
3956 # QUOTA_EXCEEDED.
3957 {
3958 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3959 #
3960 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3961 # is not enabled:
3962 #
3963 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3964 # &quot;domain&quot;: &quot;googleapis.com&quot;
3965 # &quot;metadata&quot;: {
3966 # &quot;resource&quot;: &quot;projects/123&quot;,
3967 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3968 # }
3969 # }
3970 #
3971 # This response indicates that the pubsub.googleapis.com API is not enabled.
3972 #
3973 # Example of an error that is returned when attempting to create a Spanner
3974 # instance in a region that is out of stock:
3975 #
3976 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3977 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3978 # &quot;metadata&quot;: {
3979 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3980 # }
3981 # }
3982 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3983 # is typically the registered service name of the tool or product that
3984 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3985 # generated by some common infrastructure, the error domain must be a
3986 # globally unique value that identifies the infrastructure. For Google API
3987 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3988 &quot;metadatas&quot;: { # Additional structured details about this error.
3989 #
3990 # Keys must match a regular expression of `a-z+` but should
3991 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3992 # length. When identifying the current value of an exceeded limit, the units
3993 # should be contained in the key, not the value. For example, rather than
3994 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3995 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3996 # instances that can be created in a single (batch) request.
3997 &quot;a_key&quot;: &quot;A String&quot;,
3998 },
3999 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4000 # proximate cause of the error. Error reasons are unique within a particular
4001 # domain of errors. This should be at most 63 characters and match a
4002 # regular expression of `A-Z+[A-Z0-9]`, which represents
4003 # UPPER_SNAKE_CASE.
4004 },
4005 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4006 #
4007 # For example, if a quota check failed with an error indicating the calling
4008 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4009 # directly to the right place in the developer console to flip the bit.
4010 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4011 { # Describes a URL link.
4012 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4013 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4014 },
4015 ],
4016 },
4017 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4018 # which can be attached to an RPC error.
4019 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4020 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4021 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4022 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4023 },
4024 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4025 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4026 &quot;a_key&quot;: &quot;A String&quot;,
4027 },
4028 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4029 # type or metric.
4030 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4031 # or metric.
4032 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4033 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4034 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4035 },
4036 },
4037 ],
4038 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4039 # This property is optional.
4040 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4041 },
4042 ],
4043 },
4044 &quot;getVersionOperationMetadata&quot;: {
4045 &quot;inlineSbomInfo&quot;: {
4046 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4047 # appropriate identifiers.
4048 &quot;a_key&quot;: &quot;A String&quot;,
4049 },
4050 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4051 # identifiers.
4052 &quot;a_key&quot;: &quot;A String&quot;,
4053 },
4054 },
4055 },
4056 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4057 # message that was returned, such as `NOT FOUND`.
4058 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4059 # status code that was returned. For example, a `404` means the
4060 # resource was not found.
4061 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4062 # defined by the server.
4063 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4064 # This value is inRFC3339
4065 # text format.
4066 &quot;instancesBulkInsertOperationMetadata&quot;: {
4067 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4068 # Example key: zones/us-central1-a
4069 &quot;a_key&quot;: {
4070 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4071 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4072 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4073 # error.
4074 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4075 # if the flow is rolling forward or rolling back.
4076 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4077 },
4078 },
4079 },
4080 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4081 # Operation resources.
4082 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4083 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4084 # group of operations results from a `bulkInsert` API request.
4085 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4086 # `update`, or `delete`, and so on.
4087 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4088 # There is no requirement that this be linear or support any granularity of
4089 # operations. This should not be used to guess when the operation will be
4090 # complete. This number should monotonically increase as the operation
4091 # progresses.
4092 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4093 # applicable when performing regional operations.
4094 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4095 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4096 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4097 # this field will contain information on all underlying zonal actions and
4098 # their state.
4099 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4100 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4101 # Example key: zones/us-central1-a
4102 &quot;a_key&quot;: {
4103 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
4104 # populated.
4105 # different programming environments, including REST APIs and RPC APIs. It is
4106 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4107 # three pieces of data: error code, error message, and error details.
4108 #
4109 # You can find out more about this error model and how to work with it in the
4110 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4111 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4112 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4113 # message types for APIs to use.
4114 {
4115 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4116 },
4117 ],
4118 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4119 # user-facing error message should be localized and sent in the
4120 # google.rpc.Status.details field, or localized by the client.
4121 },
4122 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4123 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4124 },
4125 },
4126 },
4127 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4128 # This value is inRFC3339
4129 # text format.
4130 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4131 # following:
4132 # `PENDING`, `RUNNING`, or `DONE`.
4133 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4134 # operation.
4135 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4136 # of the target resource.
4137 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4138 # operations related to creating a snapshot, this points to the disk
4139 # that the snapshot was created from.
4140 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4141 # `[email protected]` or
4142 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4143 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4144 # operation, this field will be populated.
4145 {
4146 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4147 # Engine returns NO_RESULTS_ON_PAGE if there
4148 # are no results in the response.
4149 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4150 # value format. For example:
4151 #
4152 # &quot;data&quot;: [
4153 # {
4154 # &quot;key&quot;: &quot;scope&quot;,
4155 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4156 # }
4157 {
4158 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4159 # returned. For example, for warnings where there are no results in a list
4160 # request for a particular zone, this key might be scope and
4161 # the key value might be the zone name. Other examples might be a key
4162 # indicating a deprecated resource and a suggested replacement, or a
4163 # warning about invalid network settings (for example, if an instance
4164 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4165 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4166 },
4167 ],
4168 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4169 },
4170 ],
4171 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4172 # applicable when performing per-zone operations.
4173 }</pre>
4174 </div>
4175
4176 <div class="method">
4177 <code class="details" id="deletePerInstanceConfigs">deletePerInstanceConfigs(project, zone, instanceGroupManager, body=None, x__xgafv=None)</code>
4178 <pre>Deletes selected per-instance configurations for the managed instance
4179 group.
4180
4181 Args:
4182 project: string, Project ID for this request. (required)
4183 zone: string, The name of thezone
4184 where the managed instance
4185 group is located.
4186 It should conform to RFC1035. (required)
4187 instanceGroupManager: string, The name of the managed instance group.
4188 It should conform to RFC1035. (required)
4189 body: object, The request body.
4190 The object takes the form of:
4191
4192 { # InstanceGroupManagers.deletePerInstanceConfigs
4193 &quot;names&quot;: [ # The list of instance names for which we want to delete per-instance configs
4194 # on this managed instance group.
4195 &quot;A String&quot;,
4196 ],
4197 }
4198
4199 x__xgafv: string, V1 error format.
4200 Allowed values
4201 1 - v1 error format
4202 2 - v2 error format
4203
4204 Returns:
4205 An object of the form:
4206
4207 { # Represents an Operation resource.
4208 #
4209 # Google Compute Engine has three Operation resources:
4210 #
4211 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
4212 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
4213 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
4214 #
4215 # You can use an operation resource to manage asynchronous API requests.
4216 # For more information, readHandling
4217 # API responses.
4218 #
4219 # Operations can be global, regional or zonal.
4220 #
4221 # - For global operations, use the `globalOperations`
4222 # resource.
4223 # - For regional operations, use the
4224 # `regionOperations` resource.
4225 # - For zonal operations, use
4226 # the `zoneOperations` resource.
4227 #
4228 #
4229 #
4230 # For more information, read
4231 # Global, Regional, and Zonal Resources.
4232 #
4233 # Note that completed Operation resources have a limited
4234 # retention period.
4235 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4236 # Not present otherwise.
4237 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4238 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4239 # set when the operation is created.
4240 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4241 # text format.
4242 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4243 # this field will be populated.
4244 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4245 # operation.
4246 {
4247 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4248 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4249 # details. There is a set of defined message types to use for providing
4250 # details.The syntax depends on the error code. For example,
4251 # QuotaExceededInfo will have details when the error code is
4252 # QUOTA_EXCEEDED.
4253 {
4254 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4255 #
4256 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4257 # is not enabled:
4258 #
4259 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4260 # &quot;domain&quot;: &quot;googleapis.com&quot;
4261 # &quot;metadata&quot;: {
4262 # &quot;resource&quot;: &quot;projects/123&quot;,
4263 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4264 # }
4265 # }
4266 #
4267 # This response indicates that the pubsub.googleapis.com API is not enabled.
4268 #
4269 # Example of an error that is returned when attempting to create a Spanner
4270 # instance in a region that is out of stock:
4271 #
4272 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4273 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4274 # &quot;metadata&quot;: {
4275 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4276 # }
4277 # }
4278 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4279 # is typically the registered service name of the tool or product that
4280 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4281 # generated by some common infrastructure, the error domain must be a
4282 # globally unique value that identifies the infrastructure. For Google API
4283 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4284 &quot;metadatas&quot;: { # Additional structured details about this error.
4285 #
4286 # Keys must match a regular expression of `a-z+` but should
4287 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4288 # length. When identifying the current value of an exceeded limit, the units
4289 # should be contained in the key, not the value. For example, rather than
4290 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4291 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4292 # instances that can be created in a single (batch) request.
4293 &quot;a_key&quot;: &quot;A String&quot;,
4294 },
4295 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4296 # proximate cause of the error. Error reasons are unique within a particular
4297 # domain of errors. This should be at most 63 characters and match a
4298 # regular expression of `A-Z+[A-Z0-9]`, which represents
4299 # UPPER_SNAKE_CASE.
4300 },
4301 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4302 #
4303 # For example, if a quota check failed with an error indicating the calling
4304 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4305 # directly to the right place in the developer console to flip the bit.
4306 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4307 { # Describes a URL link.
4308 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4309 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4310 },
4311 ],
4312 },
4313 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4314 # which can be attached to an RPC error.
4315 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4316 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4317 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4318 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4319 },
4320 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4321 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4322 &quot;a_key&quot;: &quot;A String&quot;,
4323 },
4324 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4325 # type or metric.
4326 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4327 # or metric.
4328 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4329 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4330 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4331 },
4332 },
4333 ],
4334 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4335 # This property is optional.
4336 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4337 },
4338 ],
4339 },
4340 &quot;getVersionOperationMetadata&quot;: {
4341 &quot;inlineSbomInfo&quot;: {
4342 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4343 # appropriate identifiers.
4344 &quot;a_key&quot;: &quot;A String&quot;,
4345 },
4346 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4347 # identifiers.
4348 &quot;a_key&quot;: &quot;A String&quot;,
4349 },
4350 },
4351 },
4352 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4353 # message that was returned, such as `NOT FOUND`.
4354 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4355 # status code that was returned. For example, a `404` means the
4356 # resource was not found.
4357 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4358 # defined by the server.
4359 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4360 # This value is inRFC3339
4361 # text format.
4362 &quot;instancesBulkInsertOperationMetadata&quot;: {
4363 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4364 # Example key: zones/us-central1-a
4365 &quot;a_key&quot;: {
4366 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4367 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4368 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4369 # error.
4370 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4371 # if the flow is rolling forward or rolling back.
4372 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4373 },
4374 },
4375 },
4376 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4377 # Operation resources.
4378 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4379 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4380 # group of operations results from a `bulkInsert` API request.
4381 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4382 # `update`, or `delete`, and so on.
4383 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4384 # There is no requirement that this be linear or support any granularity of
4385 # operations. This should not be used to guess when the operation will be
4386 # complete. This number should monotonically increase as the operation
4387 # progresses.
4388 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4389 # applicable when performing regional operations.
4390 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4391 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4392 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4393 # this field will contain information on all underlying zonal actions and
4394 # their state.
4395 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4396 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4397 # Example key: zones/us-central1-a
4398 &quot;a_key&quot;: {
4399 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
4400 # populated.
4401 # different programming environments, including REST APIs and RPC APIs. It is
4402 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4403 # three pieces of data: error code, error message, and error details.
4404 #
4405 # You can find out more about this error model and how to work with it in the
4406 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4407 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4408 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4409 # message types for APIs to use.
4410 {
4411 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4412 },
4413 ],
4414 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4415 # user-facing error message should be localized and sent in the
4416 # google.rpc.Status.details field, or localized by the client.
4417 },
4418 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4419 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4420 },
4421 },
4422 },
4423 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4424 # This value is inRFC3339
4425 # text format.
4426 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4427 # following:
4428 # `PENDING`, `RUNNING`, or `DONE`.
4429 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4430 # operation.
4431 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4432 # of the target resource.
4433 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4434 # operations related to creating a snapshot, this points to the disk
4435 # that the snapshot was created from.
4436 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4437 # `[email protected]` or
4438 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4439 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4440 # operation, this field will be populated.
4441 {
4442 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4443 # Engine returns NO_RESULTS_ON_PAGE if there
4444 # are no results in the response.
4445 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4446 # value format. For example:
4447 #
4448 # &quot;data&quot;: [
4449 # {
4450 # &quot;key&quot;: &quot;scope&quot;,
4451 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4452 # }
4453 {
4454 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4455 # returned. For example, for warnings where there are no results in a list
4456 # request for a particular zone, this key might be scope and
4457 # the key value might be the zone name. Other examples might be a key
4458 # indicating a deprecated resource and a suggested replacement, or a
4459 # warning about invalid network settings (for example, if an instance
4460 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4461 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4462 },
4463 ],
4464 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4465 },
4466 ],
4467 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4468 # applicable when performing per-zone operations.
4469 }</pre>
4470 </div>
4471
4472 <div class="method">
4473 <code class="details" id="get">get(project, zone, instanceGroupManager, x__xgafv=None)</code>
4474 <pre>Returns all of the details about the specified managed instance group.
4475
4476 Args:
4477 project: string, Project ID for this request. (required)
4478 zone: string, The name of thezone where the managed
4479 instance group is located. (required)
4480 instanceGroupManager: string, The name of the managed instance group. (required)
4481 x__xgafv: string, V1 error format.
4482 Allowed values
4483 1 - v1 error format
4484 2 - v2 error format
4485
4486 Returns:
4487 An object of the form:
4488
4489 { # Represents a Managed Instance Group resource.
4490 #
4491 # An instance group is a collection of VM instances that you can manage as a
4492 # single entity. For more information, readInstance groups.
4493 #
4494 # For zonal Managed Instance Group, use the instanceGroupManagers
4495 # resource.
4496 #
4497 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
4498 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
4499 # for the group.
4500 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
4501 #
4502 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
4503 # instances to apply the configuration. To apply the configuration, set the
4504 # group&#x27;s updatePolicy.type field to use proactive updates or
4505 # use the applyUpdatesToInstances method.
4506 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
4507 &quot;a_key&quot;: &quot;A String&quot;,
4508 },
4509 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
4510 # more information, see Project and
4511 # instance metadata.
4512 &quot;a_key&quot;: &quot;A String&quot;,
4513 },
4514 },
4515 },
4516 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
4517 # only one value.
4518 {
4519 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
4520 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
4521 # this field controls whether to trigger VM autohealing based on a failed
4522 # health check. Valid values are:
4523 #
4524 # - ON (default): The group recreates running VMs that
4525 # fail the application-based health check.
4526 # - OFF: When set to OFF, you can still observe instance
4527 # health state, but the group does not recreate VMs that fail the
4528 # application-based health check. This is useful for troubleshooting and
4529 # setting up your health check configuration.
4530 },
4531 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
4532 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
4533 # initialize and run its startup script. During a VM&#x27;s initial delay
4534 # period, the MIG ignores unsuccessful health checks because the VM might
4535 # be in the startup process. This prevents the MIG from prematurely
4536 # recreating a VM. If the health check receives a healthy response during
4537 # the initial delay, it indicates that the startup process is complete and
4538 # the VM is ready. The value of initial delay must be between 0 and 3600
4539 # seconds. The default value is 0.
4540 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
4541 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
4542 # The instance is considered available if all of the following conditions
4543 # are satisfied:
4544 # 1. Instance&#x27;s status is RUNNING.
4545 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
4546 # check result was observed to be HEALTHY at least once as it passed
4547 # VERIFYING).
4548 # 3. There is no outgoing action on an instance triggered by IGM.
4549 #
4550 # By default, number of concurrently autohealed instances is smaller than
4551 # the managed instance group target size. However, if a zonal managed
4552 # instance group has only one instance, or a regional managed instance
4553 # group has only one instance per zone, autohealing will recreate these
4554 # instances when they become unhealthy.
4555 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4556 #
4557 #
4558 #
4559 # - If the value is fixed, then the calculated
4560 # value is equal to the fixed value.
4561 # - If the value is a percent, then the
4562 # calculated
4563 # value is percent/100 * targetSize. For example,
4564 # the calculated value of a 80% of a managed instance group
4565 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4566 # is a remainder, the number is rounded.
4567 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4568 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4569 # example, specify 80 for 80%.
4570 },
4571 },
4572 ],
4573 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
4574 # all VMs in a MIG. The maximum character length is 58 and the name must
4575 # comply with RFC1035 format.
4576 #
4577 # When a VM is created in the group, the MIG appends a hyphen and a random
4578 # four-character string to the base instance name. If you want the MIG to
4579 # assign sequential numbers instead of a random string, then end the base
4580 # instance name with a hyphen followed by one or more hash symbols. The hash
4581 # symbols indicate the number of digits. For example, a base instance name of
4582 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
4583 # @pattern
4584 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
4585 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
4586 # text format.
4587 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
4588 # in this managed instance group that are scheduled for each of those
4589 # actions.
4590 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
4591 # that are scheduled to be abandoned. Abandoning an instance removes it
4592 # from the managed instance group without deleting it.
4593 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
4594 # are scheduled to be adopted or are currently being adopted.
4595 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
4596 # are scheduled to be created or are currently being created. If the group
4597 # fails to create any of these instances, it tries again until it creates
4598 # the instance successfully.
4599 #
4600 # If you have disabled creation retries, this field will not be populated;
4601 # instead, the creatingWithoutRetries field will be populated.
4602 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
4603 # will attempt to create atomically, in a batch mode. If the desired count
4604 # of instances can not be created, entire batch will be deleted and the
4605 # group will decrease its targetSize value accordingly.
4606 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
4607 # will attempt to create. The group attempts to create each instance
4608 # only once. If the group fails to create any of these instances, it
4609 # decreases the group&#x27;s targetSize value accordingly.
4610 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
4611 # are scheduled to be deleted or are currently being deleted.
4612 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
4613 # are running and have no scheduled actions.
4614 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
4615 # is currently queuing.
4616 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
4617 # are scheduled to be recreated or are currently being being recreated.
4618 # Recreating an instance deletes the existing root persistent disk
4619 # and creates a new disk from the image that is defined in the
4620 # instance template.
4621 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
4622 # are being reconfigured with properties that do not require a restart
4623 # or a recreate action. For example, setting or removing target
4624 # pools for the instance.
4625 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
4626 # are scheduled to be restarted or are currently being restarted.
4627 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
4628 # are scheduled to be restarted or are currently being restarted.
4629 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
4630 # are scheduled to be resumed or are currently being resumed.
4631 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
4632 # are scheduled to be started or are currently being started.
4633 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
4634 # are scheduled to be stopped or are currently being stopped.
4635 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
4636 # are scheduled to be suspended or are currently being suspended.
4637 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
4638 # are being verified. See the managedInstances[].currentAction
4639 # property in the listManagedInstances method documentation.
4640 },
4641 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
4642 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
4643 # zones in a regional managed instance group.
4644 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
4645 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
4646 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
4647 # its instances.
4648 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
4649 # instances, even if an AI zone is available in the specified region. To
4650 # create instances in an AI zone in the selected region, you must explicitly
4651 # specify it in the distribution policy together with the other preferred
4652 # zones.
4653 {
4654 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
4655 # The zone must exist in the region where the managed instance group is
4656 # located.
4657 },
4658 ],
4659 },
4660 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
4661 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
4662 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
4663 # fingerprint must be provided in order to update the InstanceGroupManager,
4664 # otherwise the request will fail with error412 conditionNotMet.
4665 #
4666 # To see the latest fingerprint, make a get() request to
4667 # retrieve an InstanceGroupManager.
4668 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
4669 # generates this identifier.
4670 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
4671 # types of machines.
4672 # Instance flexibility configuration on MIG overrides instance
4673 # template configuration.
4674 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
4675 # when creating new VMs.
4676 &quot;a_key&quot;: {
4677 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
4678 # selection.
4679 { # An instance-attached disk resource.
4680 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
4681 # or X86_64.
4682 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
4683 # deleted (but not when the disk is detached from the instance).
4684 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
4685 # partition of the disk for its root filesystem.
4686 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
4687 # running within the instance. This name can be used to reference the device
4688 # for mounting, resizing, and so on, from within the instance.
4689 #
4690 # If not specified, the server chooses a default device name to apply to this
4691 # disk, in the form persistent-disk-x, where x is a number
4692 # assigned by Google Compute Engine. This field is only applicable for
4693 # persistent disks.
4694 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
4695 # encryption key.
4696 #
4697 # If you are creating a new disk, this field encrypts the new disk using
4698 # an encryption key that you provide. If you are attaching an existing
4699 # disk that is already encrypted, this field decrypts the disk using
4700 # the customer-supplied encryption key.
4701 #
4702 # If you encrypt a disk using a customer-supplied key, you must provide the
4703 # same key again when you attempt to use this resource at a later time. For
4704 # example, you must provide the key when you create a snapshot or an image
4705 # from the disk or when you attach the disk to a virtual machine instance.
4706 #
4707 # If you do not provide an encryption key, then the disk will be encrypted
4708 # using an automatically generated key and you do not need to provide a key
4709 # to use the disk later.
4710 #
4711 # Note:
4712 #
4713 # Instance templates do not storecustomer-supplied
4714 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
4715 #
4716 # You cannot create VMs that have disks with customer-supplied keys using
4717 # the bulk
4718 # insert method.
4719 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4720 # For example:
4721 #
4722 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4723 # key_region/cryptoKeys/key
4724 #
4725 # The fully-qualifed key name may be returned for resource GET requests. For
4726 # example:
4727 #
4728 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4729 # key_region/cryptoKeys/key
4730 # /cryptoKeyVersions/1
4731 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4732 # key. If absent, the Compute Engine default service account is used.
4733 # For example:
4734 #
4735 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4736 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4737 # encryption key, encoded in RFC
4738 # 4648 base64 to either encrypt or decrypt this resource. You can
4739 # provide either the rawKey or thersaEncryptedKey.
4740 # For example:
4741 #
4742 # &quot;rawKey&quot;:
4743 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4744 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4745 # customer-supplied encryption key to either encrypt or decrypt this
4746 # resource. You can provide either the rawKey or thersaEncryptedKey.
4747 # For example:
4748 #
4749 # &quot;rsaEncryptedKey&quot;:
4750 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4751 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4752 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4753 #
4754 # The key must meet the following requirements before you can provide it to
4755 # Compute Engine:
4756 #
4757 # 1. The key is wrapped using a RSA public key certificate provided by
4758 # Google.
4759 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4760 # encoding.
4761 #
4762 # Gets the RSA public key certificate provided by Google at:
4763 #
4764 #
4765 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4766 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4767 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4768 # encryption key that protects this resource.
4769 },
4770 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
4771 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
4772 # currently attached to another instance. If you try to force attach a zonal
4773 # disk to an instance, you will receive an error.
4774 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4775 # only for bootable images. Read
4776 # Enabling guest operating system features to see a list of available
4777 # options.
4778 { # Guest OS features.
4779 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4780 # separate values. Set to one or more of the following values:
4781 #
4782 # - VIRTIO_SCSI_MULTIQUEUE
4783 # - WINDOWS
4784 # - MULTI_IP_SUBNET
4785 # - UEFI_COMPATIBLE
4786 # - GVNIC
4787 # - SEV_CAPABLE
4788 # - SUSPEND_RESUME_COMPATIBLE
4789 # - SEV_LIVE_MIGRATABLE_V2
4790 # - SEV_SNP_CAPABLE
4791 # - TDX_CAPABLE
4792 # - IDPF
4793 # - SNP_SVSM_CAPABLE
4794 # - CCA_CAPABLE
4795 #
4796 #
4797 # For more information, see
4798 # Enabling guest operating system features.
4799 },
4800 ],
4801 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
4802 # boot disk. If you have many disks attached to an instance, each
4803 # disk would have a unique index number.
4804 &quot;initializeParams&quot;: { # [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
4805 # alongside the new instance. Use initialization parameters to create boot
4806 # disks or local SSDs attached to the new instance.
4807 #
4808 # This property is mutually exclusive with the source property;
4809 # you can only define one or the other, but not both.
4810 # alongside the new instance. Use initialization parameters to create boot
4811 # disks or local SSDs attached to the new instance.
4812 #
4813 # This field is persisted and returned for instanceTemplate and not returned
4814 # in the context of instance.
4815 #
4816 # This property is mutually exclusive with the source property;
4817 # you can only define one or the other, but not both.
4818 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
4819 # arm64 or x86_64.
4820 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
4821 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
4822 # of the instance. If a disk with the same name already exists in the given
4823 # region, the existing disk is attached to the new instance and the
4824 # new disk is not created.
4825 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
4826 # 10 GB. If you specify a sourceImage, which is required for
4827 # boot disks, the default size is the size of the sourceImage.
4828 # If you do not specify a sourceImage, the default disk size
4829 # is 500 GB.
4830 &quot;diskType&quot;: &quot;A String&quot;,
4831 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4832 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4833 # only for bootable images. Read
4834 # Enabling guest operating system features to see a list of available
4835 # options.
4836 #
4837 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
4838 { # Guest OS features.
4839 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4840 # separate values. Set to one or more of the following values:
4841 #
4842 # - VIRTIO_SCSI_MULTIQUEUE
4843 # - WINDOWS
4844 # - MULTI_IP_SUBNET
4845 # - UEFI_COMPATIBLE
4846 # - GVNIC
4847 # - SEV_CAPABLE
4848 # - SUSPEND_RESUME_COMPATIBLE
4849 # - SEV_LIVE_MIGRATABLE_V2
4850 # - SEV_SNP_CAPABLE
4851 # - TDX_CAPABLE
4852 # - IDPF
4853 # - SNP_SVSM_CAPABLE
4854 # - CCA_CAPABLE
4855 #
4856 #
4857 # For more information, see
4858 # Enabling guest operating system features.
4859 },
4860 ],
4861 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
4862 # which is either SCSI or NVME. The default isSCSI.
4863 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
4864 # persistent disks.
4865 &quot;a_key&quot;: &quot;A String&quot;,
4866 },
4867 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
4868 # disk.
4869 &quot;A String&quot;,
4870 ],
4871 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4872 &quot;A String&quot;,
4873 ],
4874 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4875 # more than one instance.
4876 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
4877 # is to use the existing disk.
4878 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4879 # of I/O operations per second that the disk can handle. Values must be
4880 # between 10,000 and 120,000. For more details, see theExtreme persistent
4881 # disk documentation.
4882 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4883 # number of throughput mb per second that the disk can handle. Values must
4884 # greater than or equal to 1.
4885 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
4886 # the URLs of the zones where the disk should be replicated to.
4887 # You must provide exactly two replica zones, and one zone must be the same
4888 # as the instance zone.
4889 &quot;A String&quot;,
4890 ],
4891 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4892 # have the same definition as resource
4893 # manager tags. Keys and values can be either in numeric format,
4894 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4895 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4896 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
4897 # empty.
4898 &quot;a_key&quot;: &quot;A String&quot;,
4899 },
4900 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4901 # Specified using the full or partial URL. For instance template, specify
4902 # only the resource policy name.
4903 &quot;A String&quot;,
4904 ],
4905 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
4906 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4907 # is required.
4908 #
4909 # To create a disk with one of the public operating system
4910 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4911 #
4912 # projects/debian-cloud/global/images/family/debian-9
4913 #
4914 #
4915 # Alternatively, use a specific version of a public operating system image:
4916 #
4917 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4918 #
4919 #
4920 # To create a disk with a custom image that you created, specify the
4921 # image name in the following format:
4922 #
4923 # global/images/my-custom-image
4924 #
4925 #
4926 # You can also specify a custom image by its image family, which returns
4927 # the latest version of the image in that family. Replace the image name
4928 # with family/family-name:
4929 #
4930 # global/images/family/my-image-family
4931 #
4932 #
4933 # If the source image is deleted later, this field will not be set.
4934 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4935 # encryption key of the source image. Required if the source image is
4936 # protected by a customer-supplied encryption key.
4937 #
4938 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
4939 # encryption keys, so you cannot create disks for instances in a managed instance group if the
4940 # source images are encrypted with your own keys.
4941 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4942 # For example:
4943 #
4944 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4945 # key_region/cryptoKeys/key
4946 #
4947 # The fully-qualifed key name may be returned for resource GET requests. For
4948 # example:
4949 #
4950 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4951 # key_region/cryptoKeys/key
4952 # /cryptoKeyVersions/1
4953 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4954 # key. If absent, the Compute Engine default service account is used.
4955 # For example:
4956 #
4957 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4958 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4959 # encryption key, encoded in RFC
4960 # 4648 base64 to either encrypt or decrypt this resource. You can
4961 # provide either the rawKey or thersaEncryptedKey.
4962 # For example:
4963 #
4964 # &quot;rawKey&quot;:
4965 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4966 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4967 # customer-supplied encryption key to either encrypt or decrypt this
4968 # resource. You can provide either the rawKey or thersaEncryptedKey.
4969 # For example:
4970 #
4971 # &quot;rsaEncryptedKey&quot;:
4972 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4973 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4974 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4975 #
4976 # The key must meet the following requirements before you can provide it to
4977 # Compute Engine:
4978 #
4979 # 1. The key is wrapped using a RSA public key certificate provided by
4980 # Google.
4981 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4982 # encoding.
4983 #
4984 # Gets the RSA public key certificate provided by Google at:
4985 #
4986 #
4987 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4988 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4989 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4990 # encryption key that protects this resource.
4991 },
4992 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
4993 # instance boot disk, one of initializeParams.sourceSnapshot
4994 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
4995 # is required.
4996 #
4997 # To create a disk with a snapshot that you created, specify the
4998 # snapshot name in the following format:
4999 #
5000 # us-central1-a/instantSnapshots/my-backup
5001 #
5002 #
5003 # If the source instant-snapshot is deleted later, this field will not be
5004 # set.
5005 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5006 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5007 # is required.
5008 #
5009 # To create a disk with a snapshot that you created, specify the
5010 # snapshot name in the following format:
5011 #
5012 # global/snapshots/my-backup
5013 #
5014 #
5015 # If the source snapshot is deleted later, this field will not be set.
5016 #
5017 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5018 # an image instead when you create VMs using
5019 # the bulk
5020 # insert method.
5021 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5022 # encryption key of the source snapshot.
5023 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5024 # For example:
5025 #
5026 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5027 # key_region/cryptoKeys/key
5028 #
5029 # The fully-qualifed key name may be returned for resource GET requests. For
5030 # example:
5031 #
5032 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5033 # key_region/cryptoKeys/key
5034 # /cryptoKeyVersions/1
5035 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5036 # key. If absent, the Compute Engine default service account is used.
5037 # For example:
5038 #
5039 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5040 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5041 # encryption key, encoded in RFC
5042 # 4648 base64 to either encrypt or decrypt this resource. You can
5043 # provide either the rawKey or thersaEncryptedKey.
5044 # For example:
5045 #
5046 # &quot;rawKey&quot;:
5047 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5048 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5049 # customer-supplied encryption key to either encrypt or decrypt this
5050 # resource. You can provide either the rawKey or thersaEncryptedKey.
5051 # For example:
5052 #
5053 # &quot;rsaEncryptedKey&quot;:
5054 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5055 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5056 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5057 #
5058 # The key must meet the following requirements before you can provide it to
5059 # Compute Engine:
5060 #
5061 # 1. The key is wrapped using a RSA public key certificate provided by
5062 # Google.
5063 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5064 # encoding.
5065 #
5066 # Gets the RSA public key certificate provided by Google at:
5067 #
5068 #
5069 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5070 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5071 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5072 # encryption key that protects this resource.
5073 },
5074 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5075 # this as a partial or full URL to the resource. For example, the following
5076 # are valid values:
5077 #
5078 #
5079 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5080 # - projects/project/zones/zone/storagePools/storagePool
5081 # - zones/zone/storagePools/storagePool
5082 },
5083 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5084 # either SCSI or NVME. For most machine types, the
5085 # default is SCSI. Local SSDs can use either NVME or SCSI.
5086 # In certain configurations, persistent disks can use NVMe. For more
5087 # information, seeAbout
5088 # persistent disks.
5089 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5090 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5091 &quot;A String&quot;,
5092 ],
5093 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5094 # disk is not allowed to be detached from the instance, or to be used as the
5095 # source of the snapshot creation, and the image creation. The instance with
5096 # at least one locked attached disk is not allow to be used as source of
5097 # machine image creation, instant snapshot creation, and not allowed to be
5098 # deleted with --keep-disk parameter set to true for locked disks.
5099 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
5100 # in READ_WRITE mode.
5101 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5102 # field is set to PRESERVED if the LocalSSD data has been saved
5103 # to a persistent location by customer request. (see the
5104 # discard_local_ssd option on Stop/Suspend).
5105 # Read-only in the api.
5106 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5107 # these are public keys which are safe to store in public
5108 &quot;dbs&quot;: [ # The Key Database (db).
5109 {
5110 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5111 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5112 },
5113 ],
5114 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5115 {
5116 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5117 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5118 },
5119 ],
5120 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5121 {
5122 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5123 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5124 },
5125 ],
5126 &quot;pk&quot;: { # The Platform Key (PK).
5127 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5128 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5129 },
5130 },
5131 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5132 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5133 # is required.
5134 #
5135 # If desired, you can also attach existing non-root persistent disks using
5136 # this property. This field is only applicable for persistent disks.
5137 #
5138 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5139 # and the URL for regional disk.
5140 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5141 },
5142 ],
5143 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
5144 &quot;A String&quot;,
5145 ],
5146 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
5147 # e.g. &#x27;Intel Ice Lake&#x27;.
5148 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
5149 # preference. MIG will first try to create a VM based on the machine-type
5150 # with lowest rank and fallback to next rank based on availability.
5151 # Machine types and instance selections with the same rank have the same
5152 # preference.
5153 },
5154 },
5155 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
5156 # when creating new VMs.
5157 &quot;a_key&quot;: {
5158 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
5159 # selection.
5160 { # An instance-attached disk resource.
5161 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
5162 # or X86_64.
5163 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5164 # deleted (but not when the disk is detached from the instance).
5165 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
5166 # partition of the disk for its root filesystem.
5167 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
5168 # running within the instance. This name can be used to reference the device
5169 # for mounting, resizing, and so on, from within the instance.
5170 #
5171 # If not specified, the server chooses a default device name to apply to this
5172 # disk, in the form persistent-disk-x, where x is a number
5173 # assigned by Google Compute Engine. This field is only applicable for
5174 # persistent disks.
5175 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
5176 # encryption key.
5177 #
5178 # If you are creating a new disk, this field encrypts the new disk using
5179 # an encryption key that you provide. If you are attaching an existing
5180 # disk that is already encrypted, this field decrypts the disk using
5181 # the customer-supplied encryption key.
5182 #
5183 # If you encrypt a disk using a customer-supplied key, you must provide the
5184 # same key again when you attempt to use this resource at a later time. For
5185 # example, you must provide the key when you create a snapshot or an image
5186 # from the disk or when you attach the disk to a virtual machine instance.
5187 #
5188 # If you do not provide an encryption key, then the disk will be encrypted
5189 # using an automatically generated key and you do not need to provide a key
5190 # to use the disk later.
5191 #
5192 # Note:
5193 #
5194 # Instance templates do not storecustomer-supplied
5195 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
5196 #
5197 # You cannot create VMs that have disks with customer-supplied keys using
5198 # the bulk
5199 # insert method.
5200 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5201 # For example:
5202 #
5203 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5204 # key_region/cryptoKeys/key
5205 #
5206 # The fully-qualifed key name may be returned for resource GET requests. For
5207 # example:
5208 #
5209 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5210 # key_region/cryptoKeys/key
5211 # /cryptoKeyVersions/1
5212 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5213 # key. If absent, the Compute Engine default service account is used.
5214 # For example:
5215 #
5216 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5217 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5218 # encryption key, encoded in RFC
5219 # 4648 base64 to either encrypt or decrypt this resource. You can
5220 # provide either the rawKey or thersaEncryptedKey.
5221 # For example:
5222 #
5223 # &quot;rawKey&quot;:
5224 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5225 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5226 # customer-supplied encryption key to either encrypt or decrypt this
5227 # resource. You can provide either the rawKey or thersaEncryptedKey.
5228 # For example:
5229 #
5230 # &quot;rsaEncryptedKey&quot;:
5231 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5232 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5233 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5234 #
5235 # The key must meet the following requirements before you can provide it to
5236 # Compute Engine:
5237 #
5238 # 1. The key is wrapped using a RSA public key certificate provided by
5239 # Google.
5240 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5241 # encoding.
5242 #
5243 # Gets the RSA public key certificate provided by Google at:
5244 #
5245 #
5246 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5247 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5248 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5249 # encryption key that protects this resource.
5250 },
5251 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
5252 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
5253 # currently attached to another instance. If you try to force attach a zonal
5254 # disk to an instance, you will receive an error.
5255 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5256 # only for bootable images. Read
5257 # Enabling guest operating system features to see a list of available
5258 # options.
5259 { # Guest OS features.
5260 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5261 # separate values. Set to one or more of the following values:
5262 #
5263 # - VIRTIO_SCSI_MULTIQUEUE
5264 # - WINDOWS
5265 # - MULTI_IP_SUBNET
5266 # - UEFI_COMPATIBLE
5267 # - GVNIC
5268 # - SEV_CAPABLE
5269 # - SUSPEND_RESUME_COMPATIBLE
5270 # - SEV_LIVE_MIGRATABLE_V2
5271 # - SEV_SNP_CAPABLE
5272 # - TDX_CAPABLE
5273 # - IDPF
5274 # - SNP_SVSM_CAPABLE
5275 # - CCA_CAPABLE
5276 #
5277 #
5278 # For more information, see
5279 # Enabling guest operating system features.
5280 },
5281 ],
5282 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
5283 # boot disk. If you have many disks attached to an instance, each
5284 # disk would have a unique index number.
5285 &quot;initializeParams&quot;: { # [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
5286 # alongside the new instance. Use initialization parameters to create boot
5287 # disks or local SSDs attached to the new instance.
5288 #
5289 # This property is mutually exclusive with the source property;
5290 # you can only define one or the other, but not both.
5291 # alongside the new instance. Use initialization parameters to create boot
5292 # disks or local SSDs attached to the new instance.
5293 #
5294 # This field is persisted and returned for instanceTemplate and not returned
5295 # in the context of instance.
5296 #
5297 # This property is mutually exclusive with the source property;
5298 # you can only define one or the other, but not both.
5299 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
5300 # arm64 or x86_64.
5301 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
5302 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
5303 # of the instance. If a disk with the same name already exists in the given
5304 # region, the existing disk is attached to the new instance and the
5305 # new disk is not created.
5306 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
5307 # 10 GB. If you specify a sourceImage, which is required for
5308 # boot disks, the default size is the size of the sourceImage.
5309 # If you do not specify a sourceImage, the default disk size
5310 # is 500 GB.
5311 &quot;diskType&quot;: &quot;A String&quot;,
5312 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5313 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5314 # only for bootable images. Read
5315 # Enabling guest operating system features to see a list of available
5316 # options.
5317 #
5318 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
5319 { # Guest OS features.
5320 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5321 # separate values. Set to one or more of the following values:
5322 #
5323 # - VIRTIO_SCSI_MULTIQUEUE
5324 # - WINDOWS
5325 # - MULTI_IP_SUBNET
5326 # - UEFI_COMPATIBLE
5327 # - GVNIC
5328 # - SEV_CAPABLE
5329 # - SUSPEND_RESUME_COMPATIBLE
5330 # - SEV_LIVE_MIGRATABLE_V2
5331 # - SEV_SNP_CAPABLE
5332 # - TDX_CAPABLE
5333 # - IDPF
5334 # - SNP_SVSM_CAPABLE
5335 # - CCA_CAPABLE
5336 #
5337 #
5338 # For more information, see
5339 # Enabling guest operating system features.
5340 },
5341 ],
5342 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
5343 # which is either SCSI or NVME. The default isSCSI.
5344 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
5345 # persistent disks.
5346 &quot;a_key&quot;: &quot;A String&quot;,
5347 },
5348 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
5349 # disk.
5350 &quot;A String&quot;,
5351 ],
5352 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5353 &quot;A String&quot;,
5354 ],
5355 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5356 # more than one instance.
5357 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
5358 # is to use the existing disk.
5359 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5360 # of I/O operations per second that the disk can handle. Values must be
5361 # between 10,000 and 120,000. For more details, see theExtreme persistent
5362 # disk documentation.
5363 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5364 # number of throughput mb per second that the disk can handle. Values must
5365 # greater than or equal to 1.
5366 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
5367 # the URLs of the zones where the disk should be replicated to.
5368 # You must provide exactly two replica zones, and one zone must be the same
5369 # as the instance zone.
5370 &quot;A String&quot;,
5371 ],
5372 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5373 # have the same definition as resource
5374 # manager tags. Keys and values can be either in numeric format,
5375 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5376 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5377 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
5378 # empty.
5379 &quot;a_key&quot;: &quot;A String&quot;,
5380 },
5381 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5382 # Specified using the full or partial URL. For instance template, specify
5383 # only the resource policy name.
5384 &quot;A String&quot;,
5385 ],
5386 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
5387 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5388 # is required.
5389 #
5390 # To create a disk with one of the public operating system
5391 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5392 #
5393 # projects/debian-cloud/global/images/family/debian-9
5394 #
5395 #
5396 # Alternatively, use a specific version of a public operating system image:
5397 #
5398 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5399 #
5400 #
5401 # To create a disk with a custom image that you created, specify the
5402 # image name in the following format:
5403 #
5404 # global/images/my-custom-image
5405 #
5406 #
5407 # You can also specify a custom image by its image family, which returns
5408 # the latest version of the image in that family. Replace the image name
5409 # with family/family-name:
5410 #
5411 # global/images/family/my-image-family
5412 #
5413 #
5414 # If the source image is deleted later, this field will not be set.
5415 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5416 # encryption key of the source image. Required if the source image is
5417 # protected by a customer-supplied encryption key.
5418 #
5419 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
5420 # encryption keys, so you cannot create disks for instances in a managed instance group if the
5421 # source images are encrypted with your own keys.
5422 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5423 # For example:
5424 #
5425 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5426 # key_region/cryptoKeys/key
5427 #
5428 # The fully-qualifed key name may be returned for resource GET requests. For
5429 # example:
5430 #
5431 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5432 # key_region/cryptoKeys/key
5433 # /cryptoKeyVersions/1
5434 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5435 # key. If absent, the Compute Engine default service account is used.
5436 # For example:
5437 #
5438 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5439 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5440 # encryption key, encoded in RFC
5441 # 4648 base64 to either encrypt or decrypt this resource. You can
5442 # provide either the rawKey or thersaEncryptedKey.
5443 # For example:
5444 #
5445 # &quot;rawKey&quot;:
5446 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5447 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5448 # customer-supplied encryption key to either encrypt or decrypt this
5449 # resource. You can provide either the rawKey or thersaEncryptedKey.
5450 # For example:
5451 #
5452 # &quot;rsaEncryptedKey&quot;:
5453 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5454 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5455 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5456 #
5457 # The key must meet the following requirements before you can provide it to
5458 # Compute Engine:
5459 #
5460 # 1. The key is wrapped using a RSA public key certificate provided by
5461 # Google.
5462 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5463 # encoding.
5464 #
5465 # Gets the RSA public key certificate provided by Google at:
5466 #
5467 #
5468 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5469 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5470 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5471 # encryption key that protects this resource.
5472 },
5473 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
5474 # instance boot disk, one of initializeParams.sourceSnapshot
5475 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
5476 # is required.
5477 #
5478 # To create a disk with a snapshot that you created, specify the
5479 # snapshot name in the following format:
5480 #
5481 # us-central1-a/instantSnapshots/my-backup
5482 #
5483 #
5484 # If the source instant-snapshot is deleted later, this field will not be
5485 # set.
5486 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5487 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5488 # is required.
5489 #
5490 # To create a disk with a snapshot that you created, specify the
5491 # snapshot name in the following format:
5492 #
5493 # global/snapshots/my-backup
5494 #
5495 #
5496 # If the source snapshot is deleted later, this field will not be set.
5497 #
5498 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5499 # an image instead when you create VMs using
5500 # the bulk
5501 # insert method.
5502 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5503 # encryption key of the source snapshot.
5504 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5505 # For example:
5506 #
5507 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5508 # key_region/cryptoKeys/key
5509 #
5510 # The fully-qualifed key name may be returned for resource GET requests. For
5511 # example:
5512 #
5513 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5514 # key_region/cryptoKeys/key
5515 # /cryptoKeyVersions/1
5516 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5517 # key. If absent, the Compute Engine default service account is used.
5518 # For example:
5519 #
5520 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5521 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5522 # encryption key, encoded in RFC
5523 # 4648 base64 to either encrypt or decrypt this resource. You can
5524 # provide either the rawKey or thersaEncryptedKey.
5525 # For example:
5526 #
5527 # &quot;rawKey&quot;:
5528 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5529 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5530 # customer-supplied encryption key to either encrypt or decrypt this
5531 # resource. You can provide either the rawKey or thersaEncryptedKey.
5532 # For example:
5533 #
5534 # &quot;rsaEncryptedKey&quot;:
5535 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5536 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5537 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5538 #
5539 # The key must meet the following requirements before you can provide it to
5540 # Compute Engine:
5541 #
5542 # 1. The key is wrapped using a RSA public key certificate provided by
5543 # Google.
5544 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5545 # encoding.
5546 #
5547 # Gets the RSA public key certificate provided by Google at:
5548 #
5549 #
5550 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5551 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5552 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5553 # encryption key that protects this resource.
5554 },
5555 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5556 # this as a partial or full URL to the resource. For example, the following
5557 # are valid values:
5558 #
5559 #
5560 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5561 # - projects/project/zones/zone/storagePools/storagePool
5562 # - zones/zone/storagePools/storagePool
5563 },
5564 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5565 # either SCSI or NVME. For most machine types, the
5566 # default is SCSI. Local SSDs can use either NVME or SCSI.
5567 # In certain configurations, persistent disks can use NVMe. For more
5568 # information, seeAbout
5569 # persistent disks.
5570 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5571 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5572 &quot;A String&quot;,
5573 ],
5574 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5575 # disk is not allowed to be detached from the instance, or to be used as the
5576 # source of the snapshot creation, and the image creation. The instance with
5577 # at least one locked attached disk is not allow to be used as source of
5578 # machine image creation, instant snapshot creation, and not allowed to be
5579 # deleted with --keep-disk parameter set to true for locked disks.
5580 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
5581 # in READ_WRITE mode.
5582 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5583 # field is set to PRESERVED if the LocalSSD data has been saved
5584 # to a persistent location by customer request. (see the
5585 # discard_local_ssd option on Stop/Suspend).
5586 # Read-only in the api.
5587 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5588 # these are public keys which are safe to store in public
5589 &quot;dbs&quot;: [ # The Key Database (db).
5590 {
5591 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5592 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5593 },
5594 ],
5595 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5596 {
5597 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5598 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5599 },
5600 ],
5601 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5602 {
5603 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5604 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5605 },
5606 ],
5607 &quot;pk&quot;: { # The Platform Key (PK).
5608 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5609 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5610 },
5611 },
5612 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5613 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5614 # is required.
5615 #
5616 # If desired, you can also attach existing non-root persistent disks using
5617 # this property. This field is only applicable for persistent disks.
5618 #
5619 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5620 # and the URL for regional disk.
5621 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5622 },
5623 ],
5624 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
5625 &quot;A String&quot;,
5626 ],
5627 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
5628 # e.g. &#x27;Intel Ice Lake&#x27;.
5629 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
5630 # preference. MIG will first try to create a VM based on the machine-type
5631 # with lowest rank and fallback to next rank based on availability.
5632 # Machine types and instance selections with the same rank have the same
5633 # preference.
5634 },
5635 },
5636 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
5637 # create instances.
5638 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
5639 # more preemption than the minimum capacity user needs. MIG will create
5640 # only Standard VMs until it reaches standard_capacity_base and only
5641 # then will start using standard_capacity_percent_above_base to mix Spot
5642 # with Standard VMs.
5643 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
5644 # remaining percentage will use Spot VMs. The percentage applies only to
5645 # the capacity above standard_capacity_base.
5646 },
5647 },
5648 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
5649 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
5650 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
5651 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
5652 # applies to the VMs on which your application fails a health check.
5653 # Valid values are
5654 #
5655 # - REPAIR (default): MIG automatically repairs a failed VM
5656 # by recreating it. For more information, see About
5657 # repairing VMs in a MIG.
5658 # - DO_NOTHING: MIG does not repair a failed VM.
5659 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
5660 # configuration when repairing a VM. Valid options are:
5661 #
5662 #
5663 #
5664 # - NO (default): If configuration updates are available, they are not
5665 # forcefully applied during repair. Instead, configuration updates are
5666 # applied according to the group&#x27;s update policy.
5667 #
5668 # - YES: If configuration updates are available, they are applied
5669 # during repair.
5670 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
5671 # instance during initialization when stopping / suspending an instance.
5672 # The Instance Group Manager will wait for a signal that indicates
5673 # successful initialization before stopping / suspending an instance.
5674 #
5675 # If a successful readiness signal is not sent before timeout, the
5676 # corresponding instance will not be stopped / suspended. Instead,
5677 # an error will be visible in the lastAttempt.errors field of
5678 # the managed instance in the listmanagedinstances
5679 # method.
5680 #
5681 # If metadataBasedReadinessSignal.timeoutSec is unset,
5682 # the Instance Group Manager will directly proceed to suspend / stop
5683 # instances, skipping initialization on them.
5684 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
5685 # initialization before timing out.
5686 },
5687 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
5688 # unhealthy when the application running on that VM fails a health check.
5689 # Valid values are:
5690 #
5691 # - DEFAULT_ACTION (default): MIG uses the same action
5692 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
5693 # - REPAIR: MIG automatically repairs an unhealthy VM by
5694 # recreating it.
5695 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
5696 # For more information, see
5697 # About repairing VMs in a MIG.
5698 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
5699 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
5700 # Valid values are:
5701 #
5702 # - NO (default): MIG cannot change a VM&#x27;s zone during a
5703 # repair.
5704 # - YES: MIG can select a different zone for the VM during
5705 # a repair.
5706 },
5707 },
5708 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
5709 # instance group. The group uses this template to create all new instances
5710 # in the managed instance group. The templates for existing instances in the
5711 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
5712 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
5713 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
5714 # this managed instance group.
5715 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
5716 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
5717 # long, and comply withRFC1035.
5718 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
5719 # to this Instance Group Manager.
5720 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
5721 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
5722 # The name must be 1-63 characters long, and comply withRFC1035.
5723 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
5724 },
5725 ],
5726 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
5727 # as part of resource payload.
5728 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
5729 # key-value pairs. Keys and values can be either in numeric format,
5730 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
5731 # format such as `{org_id|project_id}/{tag_key_short_name}` and
5732 # `{tag_value_short_name}`. For more information, seeManage tags
5733 # for resources.
5734 &quot;a_key&quot;: &quot;A String&quot;,
5735 },
5736 },
5737 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
5738 # where the managed instance group resides (for regional resources).
5739 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
5740 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
5741 # instance group.
5742 # It can be a full or partial URL. For example, the following are
5743 # all valid URLs to a workload policy:
5744 #
5745 #
5746 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
5747 # - projects/project/regions/region/resourcePolicies/resourcePolicy
5748 # - regions/region/resourcePolicies/resourcePolicy
5749 },
5750 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
5751 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
5752 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
5753 # this URL.
5754 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
5755 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
5756 # by the managed instance group on instances. The service accounts needs all
5757 # permissions required to create and delete instances.
5758 # By default, the service account
5759 # {projectNumber}@cloudservices.gserviceaccount.com is used.
5760 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
5761 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
5762 # stop a VM after that VM was created. The initial delay gives the
5763 # initialization script the time to prepare your VM for a quick scale out.
5764 # The value of initial delay must be between 0 and 3600 seconds. The
5765 # default value is 0.
5766 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
5767 # group scales out. The default mode is `MANUAL`.
5768 },
5769 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
5770 &quot;preservedState&quot;: { # Configuration of preserved resources.
5771 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
5772 # delete, update, etc. This map is keyed with the device names of
5773 # the disks.
5774 &quot;a_key&quot;: {
5775 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
5776 # update or VM instance recreate operations.
5777 # This flag is used to configure if the disk should be deleted after it
5778 # is no longer used by the group, e.g. when the given instance or
5779 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
5780 },
5781 },
5782 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
5783 # instance delete, update, etc. This map is keyed with the network
5784 # interface name.
5785 &quot;a_key&quot;: {
5786 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
5787 # update or VM instance recreate operations.
5788 # This flag is used to configure if the IP reservation should be deleted
5789 # after it is no longer used by the group, e.g. when the given instance
5790 # or the whole group is deleted.
5791 },
5792 },
5793 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
5794 # instance delete, update, etc. This map is keyed with the network
5795 # interface name.
5796 &quot;a_key&quot;: {
5797 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
5798 # update or VM instance recreate operations.
5799 # This flag is used to configure if the IP reservation should be deleted
5800 # after it is no longer used by the group, e.g. when the given instance
5801 # or the whole group is deleted.
5802 },
5803 },
5804 },
5805 },
5806 &quot;status&quot;: { # Output only. The status of this managed instance group.
5807 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
5808 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
5809 # This value is in RFC3339 text format.
5810 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
5811 # been applied to all managed instances in the group.
5812 },
5813 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
5814 # Currently only one accelerator topology is supported.
5815 {
5816 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
5817 # The value is the same as configured in the WorkloadPolicy.
5818 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
5819 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
5820 # check.
5821 &quot;error&quot;: { # Output only. Encountered errors.
5822 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5823 # operation.
5824 {
5825 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5826 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5827 # details. There is a set of defined message types to use for providing
5828 # details.The syntax depends on the error code. For example,
5829 # QuotaExceededInfo will have details when the error code is
5830 # QUOTA_EXCEEDED.
5831 {
5832 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5833 #
5834 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5835 # is not enabled:
5836 #
5837 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5838 # &quot;domain&quot;: &quot;googleapis.com&quot;
5839 # &quot;metadata&quot;: {
5840 # &quot;resource&quot;: &quot;projects/123&quot;,
5841 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5842 # }
5843 # }
5844 #
5845 # This response indicates that the pubsub.googleapis.com API is not enabled.
5846 #
5847 # Example of an error that is returned when attempting to create a Spanner
5848 # instance in a region that is out of stock:
5849 #
5850 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5851 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5852 # &quot;metadata&quot;: {
5853 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5854 # }
5855 # }
5856 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5857 # is typically the registered service name of the tool or product that
5858 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5859 # generated by some common infrastructure, the error domain must be a
5860 # globally unique value that identifies the infrastructure. For Google API
5861 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5862 &quot;metadatas&quot;: { # Additional structured details about this error.
5863 #
5864 # Keys must match a regular expression of `a-z+` but should
5865 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5866 # length. When identifying the current value of an exceeded limit, the units
5867 # should be contained in the key, not the value. For example, rather than
5868 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5869 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5870 # instances that can be created in a single (batch) request.
5871 &quot;a_key&quot;: &quot;A String&quot;,
5872 },
5873 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5874 # proximate cause of the error. Error reasons are unique within a particular
5875 # domain of errors. This should be at most 63 characters and match a
5876 # regular expression of `A-Z+[A-Z0-9]`, which represents
5877 # UPPER_SNAKE_CASE.
5878 },
5879 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5880 #
5881 # For example, if a quota check failed with an error indicating the calling
5882 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5883 # directly to the right place in the developer console to flip the bit.
5884 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5885 { # Describes a URL link.
5886 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5887 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5888 },
5889 ],
5890 },
5891 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
5892 # which can be attached to an RPC error.
5893 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
5894 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
5895 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
5896 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
5897 },
5898 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
5899 &quot;dimensions&quot;: { # The map holding related quota dimensions.
5900 &quot;a_key&quot;: &quot;A String&quot;,
5901 },
5902 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
5903 # type or metric.
5904 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
5905 # or metric.
5906 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
5907 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
5908 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
5909 },
5910 },
5911 ],
5912 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
5913 # This property is optional.
5914 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
5915 },
5916 ],
5917 },
5918 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
5919 # has // RFC3339 //
5920 # text format.
5921 },
5922 },
5923 ],
5924 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
5925 # that targets this instance group manager.
5926 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
5927 # targetSizePolicy.mode is set to BULK.
5928 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
5929 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
5930 # operation.
5931 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
5932 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5933 # operation.
5934 {
5935 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5936 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5937 # details. There is a set of defined message types to use for providing
5938 # details.The syntax depends on the error code. For example,
5939 # QuotaExceededInfo will have details when the error code is
5940 # QUOTA_EXCEEDED.
5941 {
5942 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5943 #
5944 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5945 # is not enabled:
5946 #
5947 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5948 # &quot;domain&quot;: &quot;googleapis.com&quot;
5949 # &quot;metadata&quot;: {
5950 # &quot;resource&quot;: &quot;projects/123&quot;,
5951 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5952 # }
5953 # }
5954 #
5955 # This response indicates that the pubsub.googleapis.com API is not enabled.
5956 #
5957 # Example of an error that is returned when attempting to create a Spanner
5958 # instance in a region that is out of stock:
5959 #
5960 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5961 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5962 # &quot;metadata&quot;: {
5963 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5964 # }
5965 # }
5966 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5967 # is typically the registered service name of the tool or product that
5968 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5969 # generated by some common infrastructure, the error domain must be a
5970 # globally unique value that identifies the infrastructure. For Google API
5971 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5972 &quot;metadatas&quot;: { # Additional structured details about this error.
5973 #
5974 # Keys must match a regular expression of `a-z+` but should
5975 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5976 # length. When identifying the current value of an exceeded limit, the units
5977 # should be contained in the key, not the value. For example, rather than
5978 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5979 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5980 # instances that can be created in a single (batch) request.
5981 &quot;a_key&quot;: &quot;A String&quot;,
5982 },
5983 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5984 # proximate cause of the error. Error reasons are unique within a particular
5985 # domain of errors. This should be at most 63 characters and match a
5986 # regular expression of `A-Z+[A-Z0-9]`, which represents
5987 # UPPER_SNAKE_CASE.
5988 },
5989 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5990 #
5991 # For example, if a quota check failed with an error indicating the calling
5992 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5993 # directly to the right place in the developer console to flip the bit.
5994 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5995 { # Describes a URL link.
5996 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5997 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5998 },
5999 ],
6000 },
6001 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6002 # which can be attached to an RPC error.
6003 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6004 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6005 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6006 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6007 },
6008 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6009 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6010 &quot;a_key&quot;: &quot;A String&quot;,
6011 },
6012 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6013 # type or metric.
6014 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6015 # or metric.
6016 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6017 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6018 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6019 },
6020 },
6021 ],
6022 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6023 # This property is optional.
6024 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6025 },
6026 ],
6027 },
6028 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
6029 # operation. Timestamp is in RFC3339 text format.
6030 },
6031 },
6032 &quot;currentInstanceStatuses&quot;: { # 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
6033 # in this managed instance group that have the status. Currently only shown
6034 # for TPU MIGs
6035 # instance group that have the status. For more information about how to
6036 # interpret each status check the instance lifecycle documentation.
6037 # Currently only shown for TPU MIGs.
6038 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
6039 # that have DEPROVISIONING status.
6040 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
6041 # have been deleted. Includes only instances that would be shown in the
6042 # listManagedInstances method and not all instances that have been
6043 # deleted in the lifetime of the MIG.
6044 # Does not include FlexStart instances that are waiting for the resources
6045 # availability, they are considered as &#x27;pending&#x27;.
6046 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
6047 # that have PENDING status, that is FlexStart instances that are waiting
6048 # for resources. Instances that do not exist because of the other reasons
6049 # are counted as &#x27;non_existent&#x27;.
6050 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
6051 # that have PENDING_STOP status.
6052 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
6053 # that have PROVISIONING status.
6054 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
6055 # that have REPAIRING status.
6056 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
6057 # that have RUNNING status.
6058 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
6059 # that have STAGING status.
6060 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
6061 # that have STOPPED status.
6062 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
6063 # that have STOPPING status.
6064 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
6065 # that have SUSPENDED status.
6066 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
6067 # that have SUSPENDING status.
6068 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
6069 # that have TERMINATED status.
6070 },
6071 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
6072 # stable state. A stable state means that: none of the instances in the
6073 # managed instance group is currently undergoing any type of change (for
6074 # example, creation, restart, or deletion); no future changes are scheduled
6075 # for instances in the managed instance group; and the managed instance
6076 # group itself is not being modified.
6077 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
6078 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
6079 # has stateful configuration, that is, if you have configured any items
6080 # in a stateful policy or in per-instance configs.
6081 # The group might report that it has no stateful configuration even when
6082 # there is still some preserved state on a managed instance, for example,
6083 # if you have deleted all PICs but not yet applied those deletions.
6084 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
6085 # has stateful configuration, that is, if you have configured any items
6086 # in a stateful policy or in per-instance configs.
6087 # The group might report that it has no stateful configuration even when
6088 # there is still some preserved state on a managed instance, for example,
6089 # if you have deleted all PICs but not yet applied those deletions. This
6090 # field is deprecated in favor of has_stateful_config.
6091 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
6092 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
6093 # (listed in the output of a listPerInstanceConfigs API call) have
6094 # status EFFECTIVE or there are no per-instance-configs.
6095 },
6096 },
6097 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
6098 # target version specified by version field on Instance Group
6099 # Manager.
6100 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
6101 # in this managed instance group, i.e. all instances are in their target
6102 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
6103 },
6104 },
6105 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
6106 # apply to all of the instances in the managed instance group.
6107 &quot;A String&quot;,
6108 ],
6109 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
6110 # You can reduce this number by using the instanceGroupManager
6111 # deleteInstances or abandonInstances methods. Resizing the group also
6112 # changes this number.
6113 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
6114 # size.
6115 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
6116 # individually or all at once.
6117 },
6118 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
6119 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
6120 # This number changes when you:
6121 #
6122 # - Stop instance using the stopInstances
6123 # method or start instances using the startInstances
6124 # method.
6125 # - Manually change the targetStoppedSize using the update
6126 # method.
6127 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
6128 # This number changes when you:
6129 #
6130 # - Suspend instance using the suspendInstances
6131 # method or resume instances using the resumeInstances
6132 # method.
6133 # - Manually change the targetSuspendedSize using the update
6134 # method.
6135 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
6136 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
6137 &quot;A String&quot;,
6138 ],
6139 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
6140 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
6141 # instance redistribution policy for regional managed instance groups.
6142 # Valid values are:
6143 #
6144 # - PROACTIVE (default): The group attempts to maintain an
6145 # even distribution of VM instances across zones in the region.
6146 # - NONE: For non-autoscaled groups, proactive
6147 # redistribution is disabled.
6148 &quot;maxSurge&quot;: { # 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
6149 # either a fixed number or, if the group has 10 or more instances, a
6150 # percentage. If you set a percentage, the number of instances is rounded
6151 # if necessary. The default value for maxSurge is a fixed
6152 # value equal to the number of zones in which the managed instance group
6153 # operates.
6154 #
6155 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
6156 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6157 #
6158 #
6159 #
6160 # - If the value is fixed, then the calculated
6161 # value is equal to the fixed value.
6162 # - If the value is a percent, then the
6163 # calculated
6164 # value is percent/100 * targetSize. For example,
6165 # the calculated value of a 80% of a managed instance group
6166 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6167 # is a remainder, the number is rounded.
6168 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6169 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6170 # example, specify 80 for 80%.
6171 },
6172 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
6173 # process. An instance is considered available if all of the following
6174 # conditions are satisfied:
6175 #
6176 #
6177 #
6178 # - The instance&#x27;s status is
6179 # RUNNING.
6180 # - If there is a health
6181 # check on the instance group, the instance&#x27;s health check status
6182 # must be HEALTHY at least once. If there is no health check
6183 # on the group, then the instance only needs to have a status of
6184 # RUNNING to be considered available.
6185 #
6186 #
6187 # This value can be either a fixed number or, if the group has 10 or more
6188 # instances, a percentage. If you set a percentage, the number of instances
6189 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
6190 # in which the managed instance group operates.
6191 #
6192 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
6193 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6194 #
6195 #
6196 #
6197 # - If the value is fixed, then the calculated
6198 # value is equal to the fixed value.
6199 # - If the value is a percent, then the
6200 # calculated
6201 # value is percent/100 * targetSize. For example,
6202 # the calculated value of a 80% of a managed instance group
6203 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6204 # is a remainder, the number is rounded.
6205 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6206 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6207 # example, specify 80 for 80%.
6208 },
6209 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
6210 # becomes available. This value must be from range [0, 3600].
6211 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
6212 # disruption as much as possible or to apply a more disruptive action than
6213 # is necessary.
6214 #
6215 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
6216 # Compute Engine performs the necessary action to execute the update.
6217 # - To apply a more disruptive action than is strictly necessary, set the
6218 # minimal action to RESTART or REPLACE. For
6219 # example, Compute Engine does not need to restart a VM to change its
6220 # metadata. But if your application reads instance metadata only when a VM
6221 # is restarted, you can set the minimal action to RESTART in
6222 # order to pick up metadata changes.
6223 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
6224 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
6225 # as much as possible. RESTART to allow actions that can be
6226 # applied without instance replacing or REPLACE to allow all
6227 # possible actions. If the Updater determines that the minimal update
6228 # action needed is more disruptive than most disruptive allowed action you
6229 # specify it will not perform the update at all.
6230 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
6231 # See minimal_action.REPLACE
6232 &quot;type&quot;: &quot;A String&quot;, # The type
6233 # of update process. You can specify either PROACTIVE so
6234 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
6235 # to update.
6236 },
6237 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
6238 # create instances.
6239 #
6240 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
6241 # group. This field overrides the top-level instanceTemplate
6242 # field. Read more about therelationships
6243 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
6244 # remaining instances. For more information, read aboutcanary
6245 # updates.
6246 {
6247 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
6248 # instance group. The group uses this template to create new instances in
6249 # the managed instance group until the `targetSize` for this version is
6250 # reached. The templates for existing instances in the group do not change
6251 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
6252 # existing instances are updated until the `targetSize` for this version is
6253 # reached.
6254 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
6255 # managed instance group.
6256 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
6257 # even if instance_template remains unchanged.
6258 # Deprecated in favor of &#x27;name&#x27;.
6259 &quot;targetSize&quot;: { # 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
6260 # from the template will be equal to:
6261 #
6262 #
6263 # - If expressed as a fixed number, the minimum of either
6264 # targetSize.fixed or
6265 # instanceGroupManager.targetSize is used.
6266 # - if expressed as a percent, the targetSize
6267 # would be (targetSize.percent/100 *
6268 # InstanceGroupManager.targetSize) If there is a remainder, the
6269 # number is rounded.
6270 #
6271 # If unset, this version will update any remaining instances not
6272 # updated by another version. ReadStarting
6273 # a canary update for more information.
6274 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6275 #
6276 #
6277 #
6278 # - If the value is fixed, then the calculated
6279 # value is equal to the fixed value.
6280 # - If the value is a percent, then the
6281 # calculated
6282 # value is percent/100 * targetSize. For example,
6283 # the calculated value of a 80% of a managed instance group
6284 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6285 # is a remainder, the number is rounded.
6286 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6287 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6288 # example, specify 80 for 80%.
6289 },
6290 },
6291 ],
6292 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
6293 # where the managed instance group is located (for zonal resources).
6294 }</pre>
6295 </div>
6296
6297 <div class="method">
6298 <code class="details" id="getAvailableAcceleratorTopologies">getAvailableAcceleratorTopologies(project, zone, resourceId, x__xgafv=None)</code>
6299 <pre>Returns information about available accelerator topologies for a given MIG.
6300
6301 Args:
6302 project: string, Required. Project ID for this request. (required)
6303 zone: string, Required. The name of thezone where the managed
6304 instance group is located.
6305 Name should conform to RFC1035. (required)
6306 resourceId: string, Required. The name of the managed instance group.
6307 It should conform to RFC1035. (required)
6308 x__xgafv: string, V1 error format.
6309 Allowed values
6310 1 - v1 error format
6311 2 - v2 error format
6312
6313 Returns:
6314 An object of the form:
6315
6316 {
6317 &quot;acceleratorTopologiesInfo&quot;: { # The accelerator topology information returned per id of the topology
6318 # location.
6319 &quot;a_key&quot;: {
6320 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
6321 &quot;acceleratorTopologyHealth&quot;: &quot;A String&quot;,
6322 &quot;acceleratorTopologyState&quot;: { # Specifies the topology state
6323 &quot;currentState&quot;: &quot;A String&quot;,
6324 &quot;error&quot;: { # Reason why the topology state change failed
6325 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6326 # operation.
6327 {
6328 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6329 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6330 # details. There is a set of defined message types to use for providing
6331 # details.The syntax depends on the error code. For example,
6332 # QuotaExceededInfo will have details when the error code is
6333 # QUOTA_EXCEEDED.
6334 {
6335 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6336 #
6337 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6338 # is not enabled:
6339 #
6340 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6341 # &quot;domain&quot;: &quot;googleapis.com&quot;
6342 # &quot;metadata&quot;: {
6343 # &quot;resource&quot;: &quot;projects/123&quot;,
6344 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6345 # }
6346 # }
6347 #
6348 # This response indicates that the pubsub.googleapis.com API is not enabled.
6349 #
6350 # Example of an error that is returned when attempting to create a Spanner
6351 # instance in a region that is out of stock:
6352 #
6353 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6354 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6355 # &quot;metadata&quot;: {
6356 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6357 # }
6358 # }
6359 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6360 # is typically the registered service name of the tool or product that
6361 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6362 # generated by some common infrastructure, the error domain must be a
6363 # globally unique value that identifies the infrastructure. For Google API
6364 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6365 &quot;metadatas&quot;: { # Additional structured details about this error.
6366 #
6367 # Keys must match a regular expression of `a-z+` but should
6368 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6369 # length. When identifying the current value of an exceeded limit, the units
6370 # should be contained in the key, not the value. For example, rather than
6371 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6372 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6373 # instances that can be created in a single (batch) request.
6374 &quot;a_key&quot;: &quot;A String&quot;,
6375 },
6376 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6377 # proximate cause of the error. Error reasons are unique within a particular
6378 # domain of errors. This should be at most 63 characters and match a
6379 # regular expression of `A-Z+[A-Z0-9]`, which represents
6380 # UPPER_SNAKE_CASE.
6381 },
6382 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6383 #
6384 # For example, if a quota check failed with an error indicating the calling
6385 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6386 # directly to the right place in the developer console to flip the bit.
6387 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6388 { # Describes a URL link.
6389 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6390 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6391 },
6392 ],
6393 },
6394 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6395 # which can be attached to an RPC error.
6396 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6397 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6398 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6399 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6400 },
6401 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6402 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6403 &quot;a_key&quot;: &quot;A String&quot;,
6404 },
6405 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6406 # type or metric.
6407 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6408 # or metric.
6409 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6410 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6411 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6412 },
6413 },
6414 ],
6415 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6416 # This property is optional.
6417 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6418 },
6419 ],
6420 },
6421 &quot;errorTimestamp&quot;: &quot;A String&quot;, # Timestamp when the last error happened
6422 &quot;externalId&quot;: &quot;A String&quot;, # Identifier of the accelerator topology assigned externally to
6423 # differentiate who is the owner of the topology. This is set in
6424 # ConfigureAcceleratorTopologies. If it is provided on activating the
6425 # sub-slice it will have to be provided on deactivating as well.
6426 # This identifier is cleared on successful deform of a sub-slice.
6427 },
6428 &quot;instancesHealth&quot;: &quot;A String&quot;,
6429 &quot;parent&quot;: &quot;A String&quot;, # Identified by the topology Id in the accelerator_topology_info map. Empty
6430 # for the top-level topology
6431 },
6432 },
6433 &quot;multiMig&quot;: &quot;A String&quot;, # URL to MMIG this MIG belongs to.
6434 }</pre>
6435 </div>
6436
6437 <div class="method">
6438 <code class="details" id="insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</code>
6439 <pre>Creates a managed instance group using the information that you specify
6440 in the request. After the group is created, instances in the group are
6441 created using the specified instance template.
6442 This operation is marked as DONE when the group is created
6443 even if the instances in the group have not yet been created. You
6444 must separately verify the status of the individual instances with thelistmanagedinstances
6445 method.
6446
6447 A managed instance group can have up to 1000 VM instances per group. Please
6448 contact Cloud Support if you need an increase in
6449 this limit.
6450
6451 Args:
6452 project: string, Project ID for this request. (required)
6453 zone: string, The name of the zone
6454 where you want to create the managed instance group. (required)
6455 body: object, The request body.
6456 The object takes the form of:
6457
6458 { # Represents a Managed Instance Group resource.
6459 #
6460 # An instance group is a collection of VM instances that you can manage as a
6461 # single entity. For more information, readInstance groups.
6462 #
6463 # For zonal Managed Instance Group, use the instanceGroupManagers
6464 # resource.
6465 #
6466 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
6467 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
6468 # for the group.
6469 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
6470 #
6471 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
6472 # instances to apply the configuration. To apply the configuration, set the
6473 # group&#x27;s updatePolicy.type field to use proactive updates or
6474 # use the applyUpdatesToInstances method.
6475 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
6476 &quot;a_key&quot;: &quot;A String&quot;,
6477 },
6478 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
6479 # more information, see Project and
6480 # instance metadata.
6481 &quot;a_key&quot;: &quot;A String&quot;,
6482 },
6483 },
6484 },
6485 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
6486 # only one value.
6487 {
6488 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
6489 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
6490 # this field controls whether to trigger VM autohealing based on a failed
6491 # health check. Valid values are:
6492 #
6493 # - ON (default): The group recreates running VMs that
6494 # fail the application-based health check.
6495 # - OFF: When set to OFF, you can still observe instance
6496 # health state, but the group does not recreate VMs that fail the
6497 # application-based health check. This is useful for troubleshooting and
6498 # setting up your health check configuration.
6499 },
6500 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
6501 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
6502 # initialize and run its startup script. During a VM&#x27;s initial delay
6503 # period, the MIG ignores unsuccessful health checks because the VM might
6504 # be in the startup process. This prevents the MIG from prematurely
6505 # recreating a VM. If the health check receives a healthy response during
6506 # the initial delay, it indicates that the startup process is complete and
6507 # the VM is ready. The value of initial delay must be between 0 and 3600
6508 # seconds. The default value is 0.
6509 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
6510 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
6511 # The instance is considered available if all of the following conditions
6512 # are satisfied:
6513 # 1. Instance&#x27;s status is RUNNING.
6514 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
6515 # check result was observed to be HEALTHY at least once as it passed
6516 # VERIFYING).
6517 # 3. There is no outgoing action on an instance triggered by IGM.
6518 #
6519 # By default, number of concurrently autohealed instances is smaller than
6520 # the managed instance group target size. However, if a zonal managed
6521 # instance group has only one instance, or a regional managed instance
6522 # group has only one instance per zone, autohealing will recreate these
6523 # instances when they become unhealthy.
6524 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6525 #
6526 #
6527 #
6528 # - If the value is fixed, then the calculated
6529 # value is equal to the fixed value.
6530 # - If the value is a percent, then the
6531 # calculated
6532 # value is percent/100 * targetSize. For example,
6533 # the calculated value of a 80% of a managed instance group
6534 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6535 # is a remainder, the number is rounded.
6536 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6537 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6538 # example, specify 80 for 80%.
6539 },
6540 },
6541 ],
6542 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
6543 # all VMs in a MIG. The maximum character length is 58 and the name must
6544 # comply with RFC1035 format.
6545 #
6546 # When a VM is created in the group, the MIG appends a hyphen and a random
6547 # four-character string to the base instance name. If you want the MIG to
6548 # assign sequential numbers instead of a random string, then end the base
6549 # instance name with a hyphen followed by one or more hash symbols. The hash
6550 # symbols indicate the number of digits. For example, a base instance name of
6551 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
6552 # @pattern
6553 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
6554 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
6555 # text format.
6556 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
6557 # in this managed instance group that are scheduled for each of those
6558 # actions.
6559 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
6560 # that are scheduled to be abandoned. Abandoning an instance removes it
6561 # from the managed instance group without deleting it.
6562 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
6563 # are scheduled to be adopted or are currently being adopted.
6564 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
6565 # are scheduled to be created or are currently being created. If the group
6566 # fails to create any of these instances, it tries again until it creates
6567 # the instance successfully.
6568 #
6569 # If you have disabled creation retries, this field will not be populated;
6570 # instead, the creatingWithoutRetries field will be populated.
6571 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
6572 # will attempt to create atomically, in a batch mode. If the desired count
6573 # of instances can not be created, entire batch will be deleted and the
6574 # group will decrease its targetSize value accordingly.
6575 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
6576 # will attempt to create. The group attempts to create each instance
6577 # only once. If the group fails to create any of these instances, it
6578 # decreases the group&#x27;s targetSize value accordingly.
6579 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
6580 # are scheduled to be deleted or are currently being deleted.
6581 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
6582 # are running and have no scheduled actions.
6583 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
6584 # is currently queuing.
6585 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
6586 # are scheduled to be recreated or are currently being being recreated.
6587 # Recreating an instance deletes the existing root persistent disk
6588 # and creates a new disk from the image that is defined in the
6589 # instance template.
6590 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
6591 # are being reconfigured with properties that do not require a restart
6592 # or a recreate action. For example, setting or removing target
6593 # pools for the instance.
6594 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
6595 # are scheduled to be restarted or are currently being restarted.
6596 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
6597 # are scheduled to be restarted or are currently being restarted.
6598 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
6599 # are scheduled to be resumed or are currently being resumed.
6600 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
6601 # are scheduled to be started or are currently being started.
6602 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
6603 # are scheduled to be stopped or are currently being stopped.
6604 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
6605 # are scheduled to be suspended or are currently being suspended.
6606 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
6607 # are being verified. See the managedInstances[].currentAction
6608 # property in the listManagedInstances method documentation.
6609 },
6610 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
6611 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
6612 # zones in a regional managed instance group.
6613 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
6614 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
6615 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
6616 # its instances.
6617 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
6618 # instances, even if an AI zone is available in the specified region. To
6619 # create instances in an AI zone in the selected region, you must explicitly
6620 # specify it in the distribution policy together with the other preferred
6621 # zones.
6622 {
6623 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
6624 # The zone must exist in the region where the managed instance group is
6625 # located.
6626 },
6627 ],
6628 },
6629 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
6630 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
6631 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
6632 # fingerprint must be provided in order to update the InstanceGroupManager,
6633 # otherwise the request will fail with error412 conditionNotMet.
6634 #
6635 # To see the latest fingerprint, make a get() request to
6636 # retrieve an InstanceGroupManager.
6637 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
6638 # generates this identifier.
6639 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
6640 # types of machines.
6641 # Instance flexibility configuration on MIG overrides instance
6642 # template configuration.
6643 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
6644 # when creating new VMs.
6645 &quot;a_key&quot;: {
6646 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
6647 # selection.
6648 { # An instance-attached disk resource.
6649 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
6650 # or X86_64.
6651 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
6652 # deleted (but not when the disk is detached from the instance).
6653 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
6654 # partition of the disk for its root filesystem.
6655 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
6656 # running within the instance. This name can be used to reference the device
6657 # for mounting, resizing, and so on, from within the instance.
6658 #
6659 # If not specified, the server chooses a default device name to apply to this
6660 # disk, in the form persistent-disk-x, where x is a number
6661 # assigned by Google Compute Engine. This field is only applicable for
6662 # persistent disks.
6663 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
6664 # encryption key.
6665 #
6666 # If you are creating a new disk, this field encrypts the new disk using
6667 # an encryption key that you provide. If you are attaching an existing
6668 # disk that is already encrypted, this field decrypts the disk using
6669 # the customer-supplied encryption key.
6670 #
6671 # If you encrypt a disk using a customer-supplied key, you must provide the
6672 # same key again when you attempt to use this resource at a later time. For
6673 # example, you must provide the key when you create a snapshot or an image
6674 # from the disk or when you attach the disk to a virtual machine instance.
6675 #
6676 # If you do not provide an encryption key, then the disk will be encrypted
6677 # using an automatically generated key and you do not need to provide a key
6678 # to use the disk later.
6679 #
6680 # Note:
6681 #
6682 # Instance templates do not storecustomer-supplied
6683 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
6684 #
6685 # You cannot create VMs that have disks with customer-supplied keys using
6686 # the bulk
6687 # insert method.
6688 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6689 # For example:
6690 #
6691 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6692 # key_region/cryptoKeys/key
6693 #
6694 # The fully-qualifed key name may be returned for resource GET requests. For
6695 # example:
6696 #
6697 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6698 # key_region/cryptoKeys/key
6699 # /cryptoKeyVersions/1
6700 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6701 # key. If absent, the Compute Engine default service account is used.
6702 # For example:
6703 #
6704 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6705 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6706 # encryption key, encoded in RFC
6707 # 4648 base64 to either encrypt or decrypt this resource. You can
6708 # provide either the rawKey or thersaEncryptedKey.
6709 # For example:
6710 #
6711 # &quot;rawKey&quot;:
6712 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6713 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6714 # customer-supplied encryption key to either encrypt or decrypt this
6715 # resource. You can provide either the rawKey or thersaEncryptedKey.
6716 # For example:
6717 #
6718 # &quot;rsaEncryptedKey&quot;:
6719 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6720 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6721 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6722 #
6723 # The key must meet the following requirements before you can provide it to
6724 # Compute Engine:
6725 #
6726 # 1. The key is wrapped using a RSA public key certificate provided by
6727 # Google.
6728 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6729 # encoding.
6730 #
6731 # Gets the RSA public key certificate provided by Google at:
6732 #
6733 #
6734 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6735 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6736 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6737 # encryption key that protects this resource.
6738 },
6739 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
6740 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
6741 # currently attached to another instance. If you try to force attach a zonal
6742 # disk to an instance, you will receive an error.
6743 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
6744 # only for bootable images. Read
6745 # Enabling guest operating system features to see a list of available
6746 # options.
6747 { # Guest OS features.
6748 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6749 # separate values. Set to one or more of the following values:
6750 #
6751 # - VIRTIO_SCSI_MULTIQUEUE
6752 # - WINDOWS
6753 # - MULTI_IP_SUBNET
6754 # - UEFI_COMPATIBLE
6755 # - GVNIC
6756 # - SEV_CAPABLE
6757 # - SUSPEND_RESUME_COMPATIBLE
6758 # - SEV_LIVE_MIGRATABLE_V2
6759 # - SEV_SNP_CAPABLE
6760 # - TDX_CAPABLE
6761 # - IDPF
6762 # - SNP_SVSM_CAPABLE
6763 # - CCA_CAPABLE
6764 #
6765 #
6766 # For more information, see
6767 # Enabling guest operating system features.
6768 },
6769 ],
6770 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
6771 # boot disk. If you have many disks attached to an instance, each
6772 # disk would have a unique index number.
6773 &quot;initializeParams&quot;: { # [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
6774 # alongside the new instance. Use initialization parameters to create boot
6775 # disks or local SSDs attached to the new instance.
6776 #
6777 # This property is mutually exclusive with the source property;
6778 # you can only define one or the other, but not both.
6779 # alongside the new instance. Use initialization parameters to create boot
6780 # disks or local SSDs attached to the new instance.
6781 #
6782 # This field is persisted and returned for instanceTemplate and not returned
6783 # in the context of instance.
6784 #
6785 # This property is mutually exclusive with the source property;
6786 # you can only define one or the other, but not both.
6787 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
6788 # arm64 or x86_64.
6789 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
6790 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
6791 # of the instance. If a disk with the same name already exists in the given
6792 # region, the existing disk is attached to the new instance and the
6793 # new disk is not created.
6794 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
6795 # 10 GB. If you specify a sourceImage, which is required for
6796 # boot disks, the default size is the size of the sourceImage.
6797 # If you do not specify a sourceImage, the default disk size
6798 # is 500 GB.
6799 &quot;diskType&quot;: &quot;A String&quot;,
6800 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
6801 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
6802 # only for bootable images. Read
6803 # Enabling guest operating system features to see a list of available
6804 # options.
6805 #
6806 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
6807 { # Guest OS features.
6808 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6809 # separate values. Set to one or more of the following values:
6810 #
6811 # - VIRTIO_SCSI_MULTIQUEUE
6812 # - WINDOWS
6813 # - MULTI_IP_SUBNET
6814 # - UEFI_COMPATIBLE
6815 # - GVNIC
6816 # - SEV_CAPABLE
6817 # - SUSPEND_RESUME_COMPATIBLE
6818 # - SEV_LIVE_MIGRATABLE_V2
6819 # - SEV_SNP_CAPABLE
6820 # - TDX_CAPABLE
6821 # - IDPF
6822 # - SNP_SVSM_CAPABLE
6823 # - CCA_CAPABLE
6824 #
6825 #
6826 # For more information, see
6827 # Enabling guest operating system features.
6828 },
6829 ],
6830 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
6831 # which is either SCSI or NVME. The default isSCSI.
6832 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
6833 # persistent disks.
6834 &quot;a_key&quot;: &quot;A String&quot;,
6835 },
6836 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
6837 # disk.
6838 &quot;A String&quot;,
6839 ],
6840 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
6841 &quot;A String&quot;,
6842 ],
6843 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
6844 # more than one instance.
6845 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
6846 # is to use the existing disk.
6847 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
6848 # of I/O operations per second that the disk can handle. Values must be
6849 # between 10,000 and 120,000. For more details, see theExtreme persistent
6850 # disk documentation.
6851 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
6852 # number of throughput mb per second that the disk can handle. Values must
6853 # greater than or equal to 1.
6854 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
6855 # the URLs of the zones where the disk should be replicated to.
6856 # You must provide exactly two replica zones, and one zone must be the same
6857 # as the instance zone.
6858 &quot;A String&quot;,
6859 ],
6860 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
6861 # have the same definition as resource
6862 # manager tags. Keys and values can be either in numeric format,
6863 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
6864 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
6865 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
6866 # empty.
6867 &quot;a_key&quot;: &quot;A String&quot;,
6868 },
6869 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
6870 # Specified using the full or partial URL. For instance template, specify
6871 # only the resource policy name.
6872 &quot;A String&quot;,
6873 ],
6874 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
6875 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
6876 # is required.
6877 #
6878 # To create a disk with one of the public operating system
6879 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
6880 #
6881 # projects/debian-cloud/global/images/family/debian-9
6882 #
6883 #
6884 # Alternatively, use a specific version of a public operating system image:
6885 #
6886 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
6887 #
6888 #
6889 # To create a disk with a custom image that you created, specify the
6890 # image name in the following format:
6891 #
6892 # global/images/my-custom-image
6893 #
6894 #
6895 # You can also specify a custom image by its image family, which returns
6896 # the latest version of the image in that family. Replace the image name
6897 # with family/family-name:
6898 #
6899 # global/images/family/my-image-family
6900 #
6901 #
6902 # If the source image is deleted later, this field will not be set.
6903 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
6904 # encryption key of the source image. Required if the source image is
6905 # protected by a customer-supplied encryption key.
6906 #
6907 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
6908 # encryption keys, so you cannot create disks for instances in a managed instance group if the
6909 # source images are encrypted with your own keys.
6910 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6911 # For example:
6912 #
6913 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6914 # key_region/cryptoKeys/key
6915 #
6916 # The fully-qualifed key name may be returned for resource GET requests. For
6917 # example:
6918 #
6919 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6920 # key_region/cryptoKeys/key
6921 # /cryptoKeyVersions/1
6922 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6923 # key. If absent, the Compute Engine default service account is used.
6924 # For example:
6925 #
6926 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6927 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6928 # encryption key, encoded in RFC
6929 # 4648 base64 to either encrypt or decrypt this resource. You can
6930 # provide either the rawKey or thersaEncryptedKey.
6931 # For example:
6932 #
6933 # &quot;rawKey&quot;:
6934 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6935 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6936 # customer-supplied encryption key to either encrypt or decrypt this
6937 # resource. You can provide either the rawKey or thersaEncryptedKey.
6938 # For example:
6939 #
6940 # &quot;rsaEncryptedKey&quot;:
6941 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6942 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6943 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6944 #
6945 # The key must meet the following requirements before you can provide it to
6946 # Compute Engine:
6947 #
6948 # 1. The key is wrapped using a RSA public key certificate provided by
6949 # Google.
6950 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6951 # encoding.
6952 #
6953 # Gets the RSA public key certificate provided by Google at:
6954 #
6955 #
6956 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6957 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6958 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6959 # encryption key that protects this resource.
6960 },
6961 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
6962 # instance boot disk, one of initializeParams.sourceSnapshot
6963 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
6964 # is required.
6965 #
6966 # To create a disk with a snapshot that you created, specify the
6967 # snapshot name in the following format:
6968 #
6969 # us-central1-a/instantSnapshots/my-backup
6970 #
6971 #
6972 # If the source instant-snapshot is deleted later, this field will not be
6973 # set.
6974 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
6975 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
6976 # is required.
6977 #
6978 # To create a disk with a snapshot that you created, specify the
6979 # snapshot name in the following format:
6980 #
6981 # global/snapshots/my-backup
6982 #
6983 #
6984 # If the source snapshot is deleted later, this field will not be set.
6985 #
6986 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
6987 # an image instead when you create VMs using
6988 # the bulk
6989 # insert method.
6990 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
6991 # encryption key of the source snapshot.
6992 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6993 # For example:
6994 #
6995 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6996 # key_region/cryptoKeys/key
6997 #
6998 # The fully-qualifed key name may be returned for resource GET requests. For
6999 # example:
7000 #
7001 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7002 # key_region/cryptoKeys/key
7003 # /cryptoKeyVersions/1
7004 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7005 # key. If absent, the Compute Engine default service account is used.
7006 # For example:
7007 #
7008 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7009 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7010 # encryption key, encoded in RFC
7011 # 4648 base64 to either encrypt or decrypt this resource. You can
7012 # provide either the rawKey or thersaEncryptedKey.
7013 # For example:
7014 #
7015 # &quot;rawKey&quot;:
7016 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7017 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7018 # customer-supplied encryption key to either encrypt or decrypt this
7019 # resource. You can provide either the rawKey or thersaEncryptedKey.
7020 # For example:
7021 #
7022 # &quot;rsaEncryptedKey&quot;:
7023 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7024 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7025 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7026 #
7027 # The key must meet the following requirements before you can provide it to
7028 # Compute Engine:
7029 #
7030 # 1. The key is wrapped using a RSA public key certificate provided by
7031 # Google.
7032 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7033 # encoding.
7034 #
7035 # Gets the RSA public key certificate provided by Google at:
7036 #
7037 #
7038 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7039 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7040 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7041 # encryption key that protects this resource.
7042 },
7043 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7044 # this as a partial or full URL to the resource. For example, the following
7045 # are valid values:
7046 #
7047 #
7048 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7049 # - projects/project/zones/zone/storagePools/storagePool
7050 # - zones/zone/storagePools/storagePool
7051 },
7052 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7053 # either SCSI or NVME. For most machine types, the
7054 # default is SCSI. Local SSDs can use either NVME or SCSI.
7055 # In certain configurations, persistent disks can use NVMe. For more
7056 # information, seeAbout
7057 # persistent disks.
7058 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7059 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7060 &quot;A String&quot;,
7061 ],
7062 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7063 # disk is not allowed to be detached from the instance, or to be used as the
7064 # source of the snapshot creation, and the image creation. The instance with
7065 # at least one locked attached disk is not allow to be used as source of
7066 # machine image creation, instant snapshot creation, and not allowed to be
7067 # deleted with --keep-disk parameter set to true for locked disks.
7068 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
7069 # in READ_WRITE mode.
7070 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7071 # field is set to PRESERVED if the LocalSSD data has been saved
7072 # to a persistent location by customer request. (see the
7073 # discard_local_ssd option on Stop/Suspend).
7074 # Read-only in the api.
7075 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7076 # these are public keys which are safe to store in public
7077 &quot;dbs&quot;: [ # The Key Database (db).
7078 {
7079 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7080 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7081 },
7082 ],
7083 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7084 {
7085 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7086 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7087 },
7088 ],
7089 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7090 {
7091 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7092 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7093 },
7094 ],
7095 &quot;pk&quot;: { # The Platform Key (PK).
7096 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7097 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7098 },
7099 },
7100 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7101 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7102 # is required.
7103 #
7104 # If desired, you can also attach existing non-root persistent disks using
7105 # this property. This field is only applicable for persistent disks.
7106 #
7107 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7108 # and the URL for regional disk.
7109 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7110 },
7111 ],
7112 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
7113 &quot;A String&quot;,
7114 ],
7115 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
7116 # e.g. &#x27;Intel Ice Lake&#x27;.
7117 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
7118 # preference. MIG will first try to create a VM based on the machine-type
7119 # with lowest rank and fallback to next rank based on availability.
7120 # Machine types and instance selections with the same rank have the same
7121 # preference.
7122 },
7123 },
7124 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
7125 # when creating new VMs.
7126 &quot;a_key&quot;: {
7127 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
7128 # selection.
7129 { # An instance-attached disk resource.
7130 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
7131 # or X86_64.
7132 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
7133 # deleted (but not when the disk is detached from the instance).
7134 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
7135 # partition of the disk for its root filesystem.
7136 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
7137 # running within the instance. This name can be used to reference the device
7138 # for mounting, resizing, and so on, from within the instance.
7139 #
7140 # If not specified, the server chooses a default device name to apply to this
7141 # disk, in the form persistent-disk-x, where x is a number
7142 # assigned by Google Compute Engine. This field is only applicable for
7143 # persistent disks.
7144 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
7145 # encryption key.
7146 #
7147 # If you are creating a new disk, this field encrypts the new disk using
7148 # an encryption key that you provide. If you are attaching an existing
7149 # disk that is already encrypted, this field decrypts the disk using
7150 # the customer-supplied encryption key.
7151 #
7152 # If you encrypt a disk using a customer-supplied key, you must provide the
7153 # same key again when you attempt to use this resource at a later time. For
7154 # example, you must provide the key when you create a snapshot or an image
7155 # from the disk or when you attach the disk to a virtual machine instance.
7156 #
7157 # If you do not provide an encryption key, then the disk will be encrypted
7158 # using an automatically generated key and you do not need to provide a key
7159 # to use the disk later.
7160 #
7161 # Note:
7162 #
7163 # Instance templates do not storecustomer-supplied
7164 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
7165 #
7166 # You cannot create VMs that have disks with customer-supplied keys using
7167 # the bulk
7168 # insert method.
7169 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7170 # For example:
7171 #
7172 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7173 # key_region/cryptoKeys/key
7174 #
7175 # The fully-qualifed key name may be returned for resource GET requests. For
7176 # example:
7177 #
7178 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7179 # key_region/cryptoKeys/key
7180 # /cryptoKeyVersions/1
7181 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7182 # key. If absent, the Compute Engine default service account is used.
7183 # For example:
7184 #
7185 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7186 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7187 # encryption key, encoded in RFC
7188 # 4648 base64 to either encrypt or decrypt this resource. You can
7189 # provide either the rawKey or thersaEncryptedKey.
7190 # For example:
7191 #
7192 # &quot;rawKey&quot;:
7193 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7194 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7195 # customer-supplied encryption key to either encrypt or decrypt this
7196 # resource. You can provide either the rawKey or thersaEncryptedKey.
7197 # For example:
7198 #
7199 # &quot;rsaEncryptedKey&quot;:
7200 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7201 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7202 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7203 #
7204 # The key must meet the following requirements before you can provide it to
7205 # Compute Engine:
7206 #
7207 # 1. The key is wrapped using a RSA public key certificate provided by
7208 # Google.
7209 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7210 # encoding.
7211 #
7212 # Gets the RSA public key certificate provided by Google at:
7213 #
7214 #
7215 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7216 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7217 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7218 # encryption key that protects this resource.
7219 },
7220 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
7221 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
7222 # currently attached to another instance. If you try to force attach a zonal
7223 # disk to an instance, you will receive an error.
7224 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7225 # only for bootable images. Read
7226 # Enabling guest operating system features to see a list of available
7227 # options.
7228 { # Guest OS features.
7229 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7230 # separate values. Set to one or more of the following values:
7231 #
7232 # - VIRTIO_SCSI_MULTIQUEUE
7233 # - WINDOWS
7234 # - MULTI_IP_SUBNET
7235 # - UEFI_COMPATIBLE
7236 # - GVNIC
7237 # - SEV_CAPABLE
7238 # - SUSPEND_RESUME_COMPATIBLE
7239 # - SEV_LIVE_MIGRATABLE_V2
7240 # - SEV_SNP_CAPABLE
7241 # - TDX_CAPABLE
7242 # - IDPF
7243 # - SNP_SVSM_CAPABLE
7244 # - CCA_CAPABLE
7245 #
7246 #
7247 # For more information, see
7248 # Enabling guest operating system features.
7249 },
7250 ],
7251 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
7252 # boot disk. If you have many disks attached to an instance, each
7253 # disk would have a unique index number.
7254 &quot;initializeParams&quot;: { # [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
7255 # alongside the new instance. Use initialization parameters to create boot
7256 # disks or local SSDs attached to the new instance.
7257 #
7258 # This property is mutually exclusive with the source property;
7259 # you can only define one or the other, but not both.
7260 # alongside the new instance. Use initialization parameters to create boot
7261 # disks or local SSDs attached to the new instance.
7262 #
7263 # This field is persisted and returned for instanceTemplate and not returned
7264 # in the context of instance.
7265 #
7266 # This property is mutually exclusive with the source property;
7267 # you can only define one or the other, but not both.
7268 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
7269 # arm64 or x86_64.
7270 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
7271 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
7272 # of the instance. If a disk with the same name already exists in the given
7273 # region, the existing disk is attached to the new instance and the
7274 # new disk is not created.
7275 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
7276 # 10 GB. If you specify a sourceImage, which is required for
7277 # boot disks, the default size is the size of the sourceImage.
7278 # If you do not specify a sourceImage, the default disk size
7279 # is 500 GB.
7280 &quot;diskType&quot;: &quot;A String&quot;,
7281 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7282 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7283 # only for bootable images. Read
7284 # Enabling guest operating system features to see a list of available
7285 # options.
7286 #
7287 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
7288 { # Guest OS features.
7289 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7290 # separate values. Set to one or more of the following values:
7291 #
7292 # - VIRTIO_SCSI_MULTIQUEUE
7293 # - WINDOWS
7294 # - MULTI_IP_SUBNET
7295 # - UEFI_COMPATIBLE
7296 # - GVNIC
7297 # - SEV_CAPABLE
7298 # - SUSPEND_RESUME_COMPATIBLE
7299 # - SEV_LIVE_MIGRATABLE_V2
7300 # - SEV_SNP_CAPABLE
7301 # - TDX_CAPABLE
7302 # - IDPF
7303 # - SNP_SVSM_CAPABLE
7304 # - CCA_CAPABLE
7305 #
7306 #
7307 # For more information, see
7308 # Enabling guest operating system features.
7309 },
7310 ],
7311 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
7312 # which is either SCSI or NVME. The default isSCSI.
7313 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
7314 # persistent disks.
7315 &quot;a_key&quot;: &quot;A String&quot;,
7316 },
7317 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
7318 # disk.
7319 &quot;A String&quot;,
7320 ],
7321 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7322 &quot;A String&quot;,
7323 ],
7324 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7325 # more than one instance.
7326 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
7327 # is to use the existing disk.
7328 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7329 # of I/O operations per second that the disk can handle. Values must be
7330 # between 10,000 and 120,000. For more details, see theExtreme persistent
7331 # disk documentation.
7332 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7333 # number of throughput mb per second that the disk can handle. Values must
7334 # greater than or equal to 1.
7335 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
7336 # the URLs of the zones where the disk should be replicated to.
7337 # You must provide exactly two replica zones, and one zone must be the same
7338 # as the instance zone.
7339 &quot;A String&quot;,
7340 ],
7341 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7342 # have the same definition as resource
7343 # manager tags. Keys and values can be either in numeric format,
7344 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7345 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7346 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
7347 # empty.
7348 &quot;a_key&quot;: &quot;A String&quot;,
7349 },
7350 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7351 # Specified using the full or partial URL. For instance template, specify
7352 # only the resource policy name.
7353 &quot;A String&quot;,
7354 ],
7355 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
7356 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7357 # is required.
7358 #
7359 # To create a disk with one of the public operating system
7360 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7361 #
7362 # projects/debian-cloud/global/images/family/debian-9
7363 #
7364 #
7365 # Alternatively, use a specific version of a public operating system image:
7366 #
7367 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7368 #
7369 #
7370 # To create a disk with a custom image that you created, specify the
7371 # image name in the following format:
7372 #
7373 # global/images/my-custom-image
7374 #
7375 #
7376 # You can also specify a custom image by its image family, which returns
7377 # the latest version of the image in that family. Replace the image name
7378 # with family/family-name:
7379 #
7380 # global/images/family/my-image-family
7381 #
7382 #
7383 # If the source image is deleted later, this field will not be set.
7384 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7385 # encryption key of the source image. Required if the source image is
7386 # protected by a customer-supplied encryption key.
7387 #
7388 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
7389 # encryption keys, so you cannot create disks for instances in a managed instance group if the
7390 # source images are encrypted with your own keys.
7391 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7392 # For example:
7393 #
7394 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7395 # key_region/cryptoKeys/key
7396 #
7397 # The fully-qualifed key name may be returned for resource GET requests. For
7398 # example:
7399 #
7400 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7401 # key_region/cryptoKeys/key
7402 # /cryptoKeyVersions/1
7403 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7404 # key. If absent, the Compute Engine default service account is used.
7405 # For example:
7406 #
7407 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7408 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7409 # encryption key, encoded in RFC
7410 # 4648 base64 to either encrypt or decrypt this resource. You can
7411 # provide either the rawKey or thersaEncryptedKey.
7412 # For example:
7413 #
7414 # &quot;rawKey&quot;:
7415 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7416 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7417 # customer-supplied encryption key to either encrypt or decrypt this
7418 # resource. You can provide either the rawKey or thersaEncryptedKey.
7419 # For example:
7420 #
7421 # &quot;rsaEncryptedKey&quot;:
7422 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7423 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7424 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7425 #
7426 # The key must meet the following requirements before you can provide it to
7427 # Compute Engine:
7428 #
7429 # 1. The key is wrapped using a RSA public key certificate provided by
7430 # Google.
7431 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7432 # encoding.
7433 #
7434 # Gets the RSA public key certificate provided by Google at:
7435 #
7436 #
7437 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7438 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7439 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7440 # encryption key that protects this resource.
7441 },
7442 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7443 # instance boot disk, one of initializeParams.sourceSnapshot
7444 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7445 # is required.
7446 #
7447 # To create a disk with a snapshot that you created, specify the
7448 # snapshot name in the following format:
7449 #
7450 # us-central1-a/instantSnapshots/my-backup
7451 #
7452 #
7453 # If the source instant-snapshot is deleted later, this field will not be
7454 # set.
7455 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7456 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
7457 # is required.
7458 #
7459 # To create a disk with a snapshot that you created, specify the
7460 # snapshot name in the following format:
7461 #
7462 # global/snapshots/my-backup
7463 #
7464 #
7465 # If the source snapshot is deleted later, this field will not be set.
7466 #
7467 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7468 # an image instead when you create VMs using
7469 # the bulk
7470 # insert method.
7471 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7472 # encryption key of the source snapshot.
7473 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7474 # For example:
7475 #
7476 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7477 # key_region/cryptoKeys/key
7478 #
7479 # The fully-qualifed key name may be returned for resource GET requests. For
7480 # example:
7481 #
7482 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7483 # key_region/cryptoKeys/key
7484 # /cryptoKeyVersions/1
7485 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7486 # key. If absent, the Compute Engine default service account is used.
7487 # For example:
7488 #
7489 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7490 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7491 # encryption key, encoded in RFC
7492 # 4648 base64 to either encrypt or decrypt this resource. You can
7493 # provide either the rawKey or thersaEncryptedKey.
7494 # For example:
7495 #
7496 # &quot;rawKey&quot;:
7497 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7498 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7499 # customer-supplied encryption key to either encrypt or decrypt this
7500 # resource. You can provide either the rawKey or thersaEncryptedKey.
7501 # For example:
7502 #
7503 # &quot;rsaEncryptedKey&quot;:
7504 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7505 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7506 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7507 #
7508 # The key must meet the following requirements before you can provide it to
7509 # Compute Engine:
7510 #
7511 # 1. The key is wrapped using a RSA public key certificate provided by
7512 # Google.
7513 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7514 # encoding.
7515 #
7516 # Gets the RSA public key certificate provided by Google at:
7517 #
7518 #
7519 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7520 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7521 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7522 # encryption key that protects this resource.
7523 },
7524 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7525 # this as a partial or full URL to the resource. For example, the following
7526 # are valid values:
7527 #
7528 #
7529 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7530 # - projects/project/zones/zone/storagePools/storagePool
7531 # - zones/zone/storagePools/storagePool
7532 },
7533 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7534 # either SCSI or NVME. For most machine types, the
7535 # default is SCSI. Local SSDs can use either NVME or SCSI.
7536 # In certain configurations, persistent disks can use NVMe. For more
7537 # information, seeAbout
7538 # persistent disks.
7539 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7540 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7541 &quot;A String&quot;,
7542 ],
7543 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7544 # disk is not allowed to be detached from the instance, or to be used as the
7545 # source of the snapshot creation, and the image creation. The instance with
7546 # at least one locked attached disk is not allow to be used as source of
7547 # machine image creation, instant snapshot creation, and not allowed to be
7548 # deleted with --keep-disk parameter set to true for locked disks.
7549 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
7550 # in READ_WRITE mode.
7551 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7552 # field is set to PRESERVED if the LocalSSD data has been saved
7553 # to a persistent location by customer request. (see the
7554 # discard_local_ssd option on Stop/Suspend).
7555 # Read-only in the api.
7556 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7557 # these are public keys which are safe to store in public
7558 &quot;dbs&quot;: [ # The Key Database (db).
7559 {
7560 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7561 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7562 },
7563 ],
7564 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7565 {
7566 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7567 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7568 },
7569 ],
7570 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7571 {
7572 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7573 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7574 },
7575 ],
7576 &quot;pk&quot;: { # The Platform Key (PK).
7577 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7578 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7579 },
7580 },
7581 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7582 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7583 # is required.
7584 #
7585 # If desired, you can also attach existing non-root persistent disks using
7586 # this property. This field is only applicable for persistent disks.
7587 #
7588 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7589 # and the URL for regional disk.
7590 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7591 },
7592 ],
7593 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
7594 &quot;A String&quot;,
7595 ],
7596 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
7597 # e.g. &#x27;Intel Ice Lake&#x27;.
7598 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
7599 # preference. MIG will first try to create a VM based on the machine-type
7600 # with lowest rank and fallback to next rank based on availability.
7601 # Machine types and instance selections with the same rank have the same
7602 # preference.
7603 },
7604 },
7605 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
7606 # create instances.
7607 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
7608 # more preemption than the minimum capacity user needs. MIG will create
7609 # only Standard VMs until it reaches standard_capacity_base and only
7610 # then will start using standard_capacity_percent_above_base to mix Spot
7611 # with Standard VMs.
7612 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
7613 # remaining percentage will use Spot VMs. The percentage applies only to
7614 # the capacity above standard_capacity_base.
7615 },
7616 },
7617 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
7618 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
7619 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
7620 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
7621 # applies to the VMs on which your application fails a health check.
7622 # Valid values are
7623 #
7624 # - REPAIR (default): MIG automatically repairs a failed VM
7625 # by recreating it. For more information, see About
7626 # repairing VMs in a MIG.
7627 # - DO_NOTHING: MIG does not repair a failed VM.
7628 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
7629 # configuration when repairing a VM. Valid options are:
7630 #
7631 #
7632 #
7633 # - NO (default): If configuration updates are available, they are not
7634 # forcefully applied during repair. Instead, configuration updates are
7635 # applied according to the group&#x27;s update policy.
7636 #
7637 # - YES: If configuration updates are available, they are applied
7638 # during repair.
7639 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
7640 # instance during initialization when stopping / suspending an instance.
7641 # The Instance Group Manager will wait for a signal that indicates
7642 # successful initialization before stopping / suspending an instance.
7643 #
7644 # If a successful readiness signal is not sent before timeout, the
7645 # corresponding instance will not be stopped / suspended. Instead,
7646 # an error will be visible in the lastAttempt.errors field of
7647 # the managed instance in the listmanagedinstances
7648 # method.
7649 #
7650 # If metadataBasedReadinessSignal.timeoutSec is unset,
7651 # the Instance Group Manager will directly proceed to suspend / stop
7652 # instances, skipping initialization on them.
7653 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
7654 # initialization before timing out.
7655 },
7656 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
7657 # unhealthy when the application running on that VM fails a health check.
7658 # Valid values are:
7659 #
7660 # - DEFAULT_ACTION (default): MIG uses the same action
7661 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
7662 # - REPAIR: MIG automatically repairs an unhealthy VM by
7663 # recreating it.
7664 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
7665 # For more information, see
7666 # About repairing VMs in a MIG.
7667 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
7668 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
7669 # Valid values are:
7670 #
7671 # - NO (default): MIG cannot change a VM&#x27;s zone during a
7672 # repair.
7673 # - YES: MIG can select a different zone for the VM during
7674 # a repair.
7675 },
7676 },
7677 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
7678 # instance group. The group uses this template to create all new instances
7679 # in the managed instance group. The templates for existing instances in the
7680 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
7681 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
7682 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
7683 # this managed instance group.
7684 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
7685 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
7686 # long, and comply withRFC1035.
7687 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
7688 # to this Instance Group Manager.
7689 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
7690 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
7691 # The name must be 1-63 characters long, and comply withRFC1035.
7692 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
7693 },
7694 ],
7695 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
7696 # as part of resource payload.
7697 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
7698 # key-value pairs. Keys and values can be either in numeric format,
7699 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
7700 # format such as `{org_id|project_id}/{tag_key_short_name}` and
7701 # `{tag_value_short_name}`. For more information, seeManage tags
7702 # for resources.
7703 &quot;a_key&quot;: &quot;A String&quot;,
7704 },
7705 },
7706 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
7707 # where the managed instance group resides (for regional resources).
7708 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
7709 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
7710 # instance group.
7711 # It can be a full or partial URL. For example, the following are
7712 # all valid URLs to a workload policy:
7713 #
7714 #
7715 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
7716 # - projects/project/regions/region/resourcePolicies/resourcePolicy
7717 # - regions/region/resourcePolicies/resourcePolicy
7718 },
7719 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
7720 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
7721 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
7722 # this URL.
7723 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
7724 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
7725 # by the managed instance group on instances. The service accounts needs all
7726 # permissions required to create and delete instances.
7727 # By default, the service account
7728 # {projectNumber}@cloudservices.gserviceaccount.com is used.
7729 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
7730 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
7731 # stop a VM after that VM was created. The initial delay gives the
7732 # initialization script the time to prepare your VM for a quick scale out.
7733 # The value of initial delay must be between 0 and 3600 seconds. The
7734 # default value is 0.
7735 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
7736 # group scales out. The default mode is `MANUAL`.
7737 },
7738 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
7739 &quot;preservedState&quot;: { # Configuration of preserved resources.
7740 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
7741 # delete, update, etc. This map is keyed with the device names of
7742 # the disks.
7743 &quot;a_key&quot;: {
7744 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
7745 # update or VM instance recreate operations.
7746 # This flag is used to configure if the disk should be deleted after it
7747 # is no longer used by the group, e.g. when the given instance or
7748 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
7749 },
7750 },
7751 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
7752 # instance delete, update, etc. This map is keyed with the network
7753 # interface name.
7754 &quot;a_key&quot;: {
7755 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7756 # update or VM instance recreate operations.
7757 # This flag is used to configure if the IP reservation should be deleted
7758 # after it is no longer used by the group, e.g. when the given instance
7759 # or the whole group is deleted.
7760 },
7761 },
7762 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
7763 # instance delete, update, etc. This map is keyed with the network
7764 # interface name.
7765 &quot;a_key&quot;: {
7766 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7767 # update or VM instance recreate operations.
7768 # This flag is used to configure if the IP reservation should be deleted
7769 # after it is no longer used by the group, e.g. when the given instance
7770 # or the whole group is deleted.
7771 },
7772 },
7773 },
7774 },
7775 &quot;status&quot;: { # Output only. The status of this managed instance group.
7776 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
7777 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
7778 # This value is in RFC3339 text format.
7779 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
7780 # been applied to all managed instances in the group.
7781 },
7782 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
7783 # Currently only one accelerator topology is supported.
7784 {
7785 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
7786 # The value is the same as configured in the WorkloadPolicy.
7787 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
7788 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
7789 # check.
7790 &quot;error&quot;: { # Output only. Encountered errors.
7791 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7792 # operation.
7793 {
7794 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7795 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7796 # details. There is a set of defined message types to use for providing
7797 # details.The syntax depends on the error code. For example,
7798 # QuotaExceededInfo will have details when the error code is
7799 # QUOTA_EXCEEDED.
7800 {
7801 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7802 #
7803 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7804 # is not enabled:
7805 #
7806 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7807 # &quot;domain&quot;: &quot;googleapis.com&quot;
7808 # &quot;metadata&quot;: {
7809 # &quot;resource&quot;: &quot;projects/123&quot;,
7810 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7811 # }
7812 # }
7813 #
7814 # This response indicates that the pubsub.googleapis.com API is not enabled.
7815 #
7816 # Example of an error that is returned when attempting to create a Spanner
7817 # instance in a region that is out of stock:
7818 #
7819 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7820 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7821 # &quot;metadata&quot;: {
7822 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7823 # }
7824 # }
7825 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7826 # is typically the registered service name of the tool or product that
7827 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7828 # generated by some common infrastructure, the error domain must be a
7829 # globally unique value that identifies the infrastructure. For Google API
7830 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7831 &quot;metadatas&quot;: { # Additional structured details about this error.
7832 #
7833 # Keys must match a regular expression of `a-z+` but should
7834 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7835 # length. When identifying the current value of an exceeded limit, the units
7836 # should be contained in the key, not the value. For example, rather than
7837 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7838 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7839 # instances that can be created in a single (batch) request.
7840 &quot;a_key&quot;: &quot;A String&quot;,
7841 },
7842 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7843 # proximate cause of the error. Error reasons are unique within a particular
7844 # domain of errors. This should be at most 63 characters and match a
7845 # regular expression of `A-Z+[A-Z0-9]`, which represents
7846 # UPPER_SNAKE_CASE.
7847 },
7848 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7849 #
7850 # For example, if a quota check failed with an error indicating the calling
7851 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7852 # directly to the right place in the developer console to flip the bit.
7853 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7854 { # Describes a URL link.
7855 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7856 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7857 },
7858 ],
7859 },
7860 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7861 # which can be attached to an RPC error.
7862 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7863 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7864 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7865 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7866 },
7867 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7868 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7869 &quot;a_key&quot;: &quot;A String&quot;,
7870 },
7871 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7872 # type or metric.
7873 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7874 # or metric.
7875 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7876 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7877 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7878 },
7879 },
7880 ],
7881 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7882 # This property is optional.
7883 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7884 },
7885 ],
7886 },
7887 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
7888 # has // RFC3339 //
7889 # text format.
7890 },
7891 },
7892 ],
7893 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
7894 # that targets this instance group manager.
7895 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
7896 # targetSizePolicy.mode is set to BULK.
7897 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
7898 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
7899 # operation.
7900 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
7901 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7902 # operation.
7903 {
7904 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7905 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7906 # details. There is a set of defined message types to use for providing
7907 # details.The syntax depends on the error code. For example,
7908 # QuotaExceededInfo will have details when the error code is
7909 # QUOTA_EXCEEDED.
7910 {
7911 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7912 #
7913 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7914 # is not enabled:
7915 #
7916 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7917 # &quot;domain&quot;: &quot;googleapis.com&quot;
7918 # &quot;metadata&quot;: {
7919 # &quot;resource&quot;: &quot;projects/123&quot;,
7920 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7921 # }
7922 # }
7923 #
7924 # This response indicates that the pubsub.googleapis.com API is not enabled.
7925 #
7926 # Example of an error that is returned when attempting to create a Spanner
7927 # instance in a region that is out of stock:
7928 #
7929 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7930 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7931 # &quot;metadata&quot;: {
7932 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7933 # }
7934 # }
7935 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7936 # is typically the registered service name of the tool or product that
7937 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7938 # generated by some common infrastructure, the error domain must be a
7939 # globally unique value that identifies the infrastructure. For Google API
7940 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7941 &quot;metadatas&quot;: { # Additional structured details about this error.
7942 #
7943 # Keys must match a regular expression of `a-z+` but should
7944 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7945 # length. When identifying the current value of an exceeded limit, the units
7946 # should be contained in the key, not the value. For example, rather than
7947 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7948 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7949 # instances that can be created in a single (batch) request.
7950 &quot;a_key&quot;: &quot;A String&quot;,
7951 },
7952 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7953 # proximate cause of the error. Error reasons are unique within a particular
7954 # domain of errors. This should be at most 63 characters and match a
7955 # regular expression of `A-Z+[A-Z0-9]`, which represents
7956 # UPPER_SNAKE_CASE.
7957 },
7958 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7959 #
7960 # For example, if a quota check failed with an error indicating the calling
7961 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7962 # directly to the right place in the developer console to flip the bit.
7963 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7964 { # Describes a URL link.
7965 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7966 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7967 },
7968 ],
7969 },
7970 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7971 # which can be attached to an RPC error.
7972 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7973 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7974 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7975 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7976 },
7977 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7978 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7979 &quot;a_key&quot;: &quot;A String&quot;,
7980 },
7981 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7982 # type or metric.
7983 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7984 # or metric.
7985 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7986 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7987 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7988 },
7989 },
7990 ],
7991 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7992 # This property is optional.
7993 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7994 },
7995 ],
7996 },
7997 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
7998 # operation. Timestamp is in RFC3339 text format.
7999 },
8000 },
8001 &quot;currentInstanceStatuses&quot;: { # 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
8002 # in this managed instance group that have the status. Currently only shown
8003 # for TPU MIGs
8004 # instance group that have the status. For more information about how to
8005 # interpret each status check the instance lifecycle documentation.
8006 # Currently only shown for TPU MIGs.
8007 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
8008 # that have DEPROVISIONING status.
8009 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
8010 # have been deleted. Includes only instances that would be shown in the
8011 # listManagedInstances method and not all instances that have been
8012 # deleted in the lifetime of the MIG.
8013 # Does not include FlexStart instances that are waiting for the resources
8014 # availability, they are considered as &#x27;pending&#x27;.
8015 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
8016 # that have PENDING status, that is FlexStart instances that are waiting
8017 # for resources. Instances that do not exist because of the other reasons
8018 # are counted as &#x27;non_existent&#x27;.
8019 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
8020 # that have PENDING_STOP status.
8021 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
8022 # that have PROVISIONING status.
8023 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
8024 # that have REPAIRING status.
8025 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
8026 # that have RUNNING status.
8027 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
8028 # that have STAGING status.
8029 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
8030 # that have STOPPED status.
8031 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
8032 # that have STOPPING status.
8033 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
8034 # that have SUSPENDED status.
8035 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
8036 # that have SUSPENDING status.
8037 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
8038 # that have TERMINATED status.
8039 },
8040 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
8041 # stable state. A stable state means that: none of the instances in the
8042 # managed instance group is currently undergoing any type of change (for
8043 # example, creation, restart, or deletion); no future changes are scheduled
8044 # for instances in the managed instance group; and the managed instance
8045 # group itself is not being modified.
8046 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
8047 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
8048 # has stateful configuration, that is, if you have configured any items
8049 # in a stateful policy or in per-instance configs.
8050 # The group might report that it has no stateful configuration even when
8051 # there is still some preserved state on a managed instance, for example,
8052 # if you have deleted all PICs but not yet applied those deletions.
8053 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
8054 # has stateful configuration, that is, if you have configured any items
8055 # in a stateful policy or in per-instance configs.
8056 # The group might report that it has no stateful configuration even when
8057 # there is still some preserved state on a managed instance, for example,
8058 # if you have deleted all PICs but not yet applied those deletions. This
8059 # field is deprecated in favor of has_stateful_config.
8060 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
8061 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
8062 # (listed in the output of a listPerInstanceConfigs API call) have
8063 # status EFFECTIVE or there are no per-instance-configs.
8064 },
8065 },
8066 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
8067 # target version specified by version field on Instance Group
8068 # Manager.
8069 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
8070 # in this managed instance group, i.e. all instances are in their target
8071 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
8072 },
8073 },
8074 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
8075 # apply to all of the instances in the managed instance group.
8076 &quot;A String&quot;,
8077 ],
8078 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
8079 # You can reduce this number by using the instanceGroupManager
8080 # deleteInstances or abandonInstances methods. Resizing the group also
8081 # changes this number.
8082 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
8083 # size.
8084 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
8085 # individually or all at once.
8086 },
8087 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
8088 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
8089 # This number changes when you:
8090 #
8091 # - Stop instance using the stopInstances
8092 # method or start instances using the startInstances
8093 # method.
8094 # - Manually change the targetStoppedSize using the update
8095 # method.
8096 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
8097 # This number changes when you:
8098 #
8099 # - Suspend instance using the suspendInstances
8100 # method or resume instances using the resumeInstances
8101 # method.
8102 # - Manually change the targetSuspendedSize using the update
8103 # method.
8104 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
8105 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
8106 &quot;A String&quot;,
8107 ],
8108 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
8109 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
8110 # instance redistribution policy for regional managed instance groups.
8111 # Valid values are:
8112 #
8113 # - PROACTIVE (default): The group attempts to maintain an
8114 # even distribution of VM instances across zones in the region.
8115 # - NONE: For non-autoscaled groups, proactive
8116 # redistribution is disabled.
8117 &quot;maxSurge&quot;: { # 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
8118 # either a fixed number or, if the group has 10 or more instances, a
8119 # percentage. If you set a percentage, the number of instances is rounded
8120 # if necessary. The default value for maxSurge is a fixed
8121 # value equal to the number of zones in which the managed instance group
8122 # operates.
8123 #
8124 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
8125 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8126 #
8127 #
8128 #
8129 # - If the value is fixed, then the calculated
8130 # value is equal to the fixed value.
8131 # - If the value is a percent, then the
8132 # calculated
8133 # value is percent/100 * targetSize. For example,
8134 # the calculated value of a 80% of a managed instance group
8135 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8136 # is a remainder, the number is rounded.
8137 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8138 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8139 # example, specify 80 for 80%.
8140 },
8141 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
8142 # process. An instance is considered available if all of the following
8143 # conditions are satisfied:
8144 #
8145 #
8146 #
8147 # - The instance&#x27;s status is
8148 # RUNNING.
8149 # - If there is a health
8150 # check on the instance group, the instance&#x27;s health check status
8151 # must be HEALTHY at least once. If there is no health check
8152 # on the group, then the instance only needs to have a status of
8153 # RUNNING to be considered available.
8154 #
8155 #
8156 # This value can be either a fixed number or, if the group has 10 or more
8157 # instances, a percentage. If you set a percentage, the number of instances
8158 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
8159 # in which the managed instance group operates.
8160 #
8161 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
8162 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8163 #
8164 #
8165 #
8166 # - If the value is fixed, then the calculated
8167 # value is equal to the fixed value.
8168 # - If the value is a percent, then the
8169 # calculated
8170 # value is percent/100 * targetSize. For example,
8171 # the calculated value of a 80% of a managed instance group
8172 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8173 # is a remainder, the number is rounded.
8174 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8175 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8176 # example, specify 80 for 80%.
8177 },
8178 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
8179 # becomes available. This value must be from range [0, 3600].
8180 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
8181 # disruption as much as possible or to apply a more disruptive action than
8182 # is necessary.
8183 #
8184 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
8185 # Compute Engine performs the necessary action to execute the update.
8186 # - To apply a more disruptive action than is strictly necessary, set the
8187 # minimal action to RESTART or REPLACE. For
8188 # example, Compute Engine does not need to restart a VM to change its
8189 # metadata. But if your application reads instance metadata only when a VM
8190 # is restarted, you can set the minimal action to RESTART in
8191 # order to pick up metadata changes.
8192 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
8193 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
8194 # as much as possible. RESTART to allow actions that can be
8195 # applied without instance replacing or REPLACE to allow all
8196 # possible actions. If the Updater determines that the minimal update
8197 # action needed is more disruptive than most disruptive allowed action you
8198 # specify it will not perform the update at all.
8199 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
8200 # See minimal_action.REPLACE
8201 &quot;type&quot;: &quot;A String&quot;, # The type
8202 # of update process. You can specify either PROACTIVE so
8203 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
8204 # to update.
8205 },
8206 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
8207 # create instances.
8208 #
8209 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
8210 # group. This field overrides the top-level instanceTemplate
8211 # field. Read more about therelationships
8212 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
8213 # remaining instances. For more information, read aboutcanary
8214 # updates.
8215 {
8216 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
8217 # instance group. The group uses this template to create new instances in
8218 # the managed instance group until the `targetSize` for this version is
8219 # reached. The templates for existing instances in the group do not change
8220 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
8221 # existing instances are updated until the `targetSize` for this version is
8222 # reached.
8223 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
8224 # managed instance group.
8225 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
8226 # even if instance_template remains unchanged.
8227 # Deprecated in favor of &#x27;name&#x27;.
8228 &quot;targetSize&quot;: { # 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
8229 # from the template will be equal to:
8230 #
8231 #
8232 # - If expressed as a fixed number, the minimum of either
8233 # targetSize.fixed or
8234 # instanceGroupManager.targetSize is used.
8235 # - if expressed as a percent, the targetSize
8236 # would be (targetSize.percent/100 *
8237 # InstanceGroupManager.targetSize) If there is a remainder, the
8238 # number is rounded.
8239 #
8240 # If unset, this version will update any remaining instances not
8241 # updated by another version. ReadStarting
8242 # a canary update for more information.
8243 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8244 #
8245 #
8246 #
8247 # - If the value is fixed, then the calculated
8248 # value is equal to the fixed value.
8249 # - If the value is a percent, then the
8250 # calculated
8251 # value is percent/100 * targetSize. For example,
8252 # the calculated value of a 80% of a managed instance group
8253 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8254 # is a remainder, the number is rounded.
8255 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8256 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8257 # example, specify 80 for 80%.
8258 },
8259 },
8260 ],
8261 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
8262 # where the managed instance group is located (for zonal resources).
8263 }
8264
8265 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
8266 that if you must retry your request, the server will know to ignore the
8267 request if it has already been completed.
8268
8269 For example, consider a situation where you make an initial request and
8270 the request times out. If you make the request again with the same
8271 request ID, the server can check if original operation with the same
8272 request ID was received, and if so, will ignore the second request. This
8273 prevents clients from accidentally creating duplicate commitments.
8274
8275 The request ID must be
8276 a valid UUID with the exception that zero UUID is not supported
8277 (00000000-0000-0000-0000-000000000000).
8278 x__xgafv: string, V1 error format.
8279 Allowed values
8280 1 - v1 error format
8281 2 - v2 error format
8282
8283 Returns:
8284 An object of the form:
8285
8286 { # Represents an Operation resource.
8287 #
8288 # Google Compute Engine has three Operation resources:
8289 #
8290 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
8291 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
8292 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
8293 #
8294 # You can use an operation resource to manage asynchronous API requests.
8295 # For more information, readHandling
8296 # API responses.
8297 #
8298 # Operations can be global, regional or zonal.
8299 #
8300 # - For global operations, use the `globalOperations`
8301 # resource.
8302 # - For regional operations, use the
8303 # `regionOperations` resource.
8304 # - For zonal operations, use
8305 # the `zoneOperations` resource.
8306 #
8307 #
8308 #
8309 # For more information, read
8310 # Global, Regional, and Zonal Resources.
8311 #
8312 # Note that completed Operation resources have a limited
8313 # retention period.
8314 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8315 # Not present otherwise.
8316 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8317 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8318 # set when the operation is created.
8319 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8320 # text format.
8321 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8322 # this field will be populated.
8323 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8324 # operation.
8325 {
8326 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8327 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8328 # details. There is a set of defined message types to use for providing
8329 # details.The syntax depends on the error code. For example,
8330 # QuotaExceededInfo will have details when the error code is
8331 # QUOTA_EXCEEDED.
8332 {
8333 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8334 #
8335 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8336 # is not enabled:
8337 #
8338 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8339 # &quot;domain&quot;: &quot;googleapis.com&quot;
8340 # &quot;metadata&quot;: {
8341 # &quot;resource&quot;: &quot;projects/123&quot;,
8342 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8343 # }
8344 # }
8345 #
8346 # This response indicates that the pubsub.googleapis.com API is not enabled.
8347 #
8348 # Example of an error that is returned when attempting to create a Spanner
8349 # instance in a region that is out of stock:
8350 #
8351 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8352 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8353 # &quot;metadata&quot;: {
8354 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8355 # }
8356 # }
8357 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8358 # is typically the registered service name of the tool or product that
8359 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8360 # generated by some common infrastructure, the error domain must be a
8361 # globally unique value that identifies the infrastructure. For Google API
8362 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8363 &quot;metadatas&quot;: { # Additional structured details about this error.
8364 #
8365 # Keys must match a regular expression of `a-z+` but should
8366 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8367 # length. When identifying the current value of an exceeded limit, the units
8368 # should be contained in the key, not the value. For example, rather than
8369 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8370 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8371 # instances that can be created in a single (batch) request.
8372 &quot;a_key&quot;: &quot;A String&quot;,
8373 },
8374 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8375 # proximate cause of the error. Error reasons are unique within a particular
8376 # domain of errors. This should be at most 63 characters and match a
8377 # regular expression of `A-Z+[A-Z0-9]`, which represents
8378 # UPPER_SNAKE_CASE.
8379 },
8380 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8381 #
8382 # For example, if a quota check failed with an error indicating the calling
8383 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8384 # directly to the right place in the developer console to flip the bit.
8385 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8386 { # Describes a URL link.
8387 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8388 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8389 },
8390 ],
8391 },
8392 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8393 # which can be attached to an RPC error.
8394 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8395 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8396 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8397 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8398 },
8399 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8400 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8401 &quot;a_key&quot;: &quot;A String&quot;,
8402 },
8403 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8404 # type or metric.
8405 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8406 # or metric.
8407 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8408 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8409 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8410 },
8411 },
8412 ],
8413 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8414 # This property is optional.
8415 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8416 },
8417 ],
8418 },
8419 &quot;getVersionOperationMetadata&quot;: {
8420 &quot;inlineSbomInfo&quot;: {
8421 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8422 # appropriate identifiers.
8423 &quot;a_key&quot;: &quot;A String&quot;,
8424 },
8425 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8426 # identifiers.
8427 &quot;a_key&quot;: &quot;A String&quot;,
8428 },
8429 },
8430 },
8431 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8432 # message that was returned, such as `NOT FOUND`.
8433 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8434 # status code that was returned. For example, a `404` means the
8435 # resource was not found.
8436 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8437 # defined by the server.
8438 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8439 # This value is inRFC3339
8440 # text format.
8441 &quot;instancesBulkInsertOperationMetadata&quot;: {
8442 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8443 # Example key: zones/us-central1-a
8444 &quot;a_key&quot;: {
8445 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8446 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8447 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8448 # error.
8449 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8450 # if the flow is rolling forward or rolling back.
8451 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8452 },
8453 },
8454 },
8455 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8456 # Operation resources.
8457 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8458 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8459 # group of operations results from a `bulkInsert` API request.
8460 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8461 # `update`, or `delete`, and so on.
8462 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8463 # There is no requirement that this be linear or support any granularity of
8464 # operations. This should not be used to guess when the operation will be
8465 # complete. This number should monotonically increase as the operation
8466 # progresses.
8467 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8468 # applicable when performing regional operations.
8469 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8470 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8471 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8472 # this field will contain information on all underlying zonal actions and
8473 # their state.
8474 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8475 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8476 # Example key: zones/us-central1-a
8477 &quot;a_key&quot;: {
8478 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
8479 # populated.
8480 # different programming environments, including REST APIs and RPC APIs. It is
8481 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8482 # three pieces of data: error code, error message, and error details.
8483 #
8484 # You can find out more about this error model and how to work with it in the
8485 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8486 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8487 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8488 # message types for APIs to use.
8489 {
8490 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8491 },
8492 ],
8493 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8494 # user-facing error message should be localized and sent in the
8495 # google.rpc.Status.details field, or localized by the client.
8496 },
8497 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8498 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8499 },
8500 },
8501 },
8502 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8503 # This value is inRFC3339
8504 # text format.
8505 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8506 # following:
8507 # `PENDING`, `RUNNING`, or `DONE`.
8508 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8509 # operation.
8510 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8511 # of the target resource.
8512 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8513 # operations related to creating a snapshot, this points to the disk
8514 # that the snapshot was created from.
8515 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8516 # `[email protected]` or
8517 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8518 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8519 # operation, this field will be populated.
8520 {
8521 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8522 # Engine returns NO_RESULTS_ON_PAGE if there
8523 # are no results in the response.
8524 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8525 # value format. For example:
8526 #
8527 # &quot;data&quot;: [
8528 # {
8529 # &quot;key&quot;: &quot;scope&quot;,
8530 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8531 # }
8532 {
8533 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8534 # returned. For example, for warnings where there are no results in a list
8535 # request for a particular zone, this key might be scope and
8536 # the key value might be the zone name. Other examples might be a key
8537 # indicating a deprecated resource and a suggested replacement, or a
8538 # warning about invalid network settings (for example, if an instance
8539 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8540 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8541 },
8542 ],
8543 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8544 },
8545 ],
8546 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8547 # applicable when performing per-zone operations.
8548 }</pre>
8549 </div>
8550
8551 <div class="method">
8552 <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8553 <pre>Retrieves a list of managed instance groups that are contained within the
8554 specified project and zone.
8555
8556 Args:
8557 project: string, Project ID for this request. (required)
8558 zone: string, The name of thezone where the managed
8559 instance group is located. (required)
8560 filter: string, A filter expression that filters resources listed in the response. Most
8561 Compute resources support two types of filter expressions:
8562 expressions that support regular expressions and expressions that follow
8563 API improvement proposal AIP-160.
8564 These two types of filter expressions cannot be mixed in one request.
8565
8566 If you want to use AIP-160, your expression must specify the field name, an
8567 operator, and the value that you want to use for filtering. The value
8568 must be a string, a number, or a boolean. The operator
8569 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8570
8571 For example, if you are filtering Compute Engine instances, you can
8572 exclude instances named `example-instance` by specifying
8573 `name != example-instance`.
8574
8575 The `:*` comparison can be used to test whether a key has been defined.
8576 For example, to find all objects with `owner` label use:
8577 ```
8578 labels.owner:*
8579 ```
8580
8581 You can also filter nested fields. For example, you could specify
8582 `scheduling.automaticRestart = false` to include instances only
8583 if they are not scheduled for automatic restarts. You can use filtering
8584 on nested fields to filter based onresource labels.
8585
8586 To filter on multiple expressions, provide each separate expression within
8587 parentheses. For example:
8588 ```
8589 (scheduling.automaticRestart = true)
8590 (cpuPlatform = &quot;Intel Skylake&quot;)
8591 ```
8592 By default, each expression is an `AND` expression. However, you
8593 can include `AND` and `OR` expressions explicitly.
8594 For example:
8595 ```
8596 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8597 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8598 (scheduling.automaticRestart = true)
8599 ```
8600
8601 If you want to use a regular expression, use the `eq` (equal) or `ne`
8602 (not equal) operator against a single un-parenthesized expression with or
8603 without quotes or against multiple parenthesized expressions. Examples:
8604
8605 `fieldname eq unquoted literal`
8606 `fieldname eq &#x27;single quoted literal&#x27;`
8607 `fieldname eq &quot;double quoted literal&quot;`
8608 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8609
8610 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8611 The literal value must match the entire field.
8612
8613 For example, to filter for instances that do not end with name &quot;instance&quot;,
8614 you would use `name ne .*instance`.
8615
8616 You cannot combine constraints on multiple fields using regular
8617 expressions.
8618 maxResults: integer, The maximum number of results per page that should be returned.
8619 If the number of available results is larger than `maxResults`,
8620 Compute Engine returns a `nextPageToken` that can be used to get
8621 the next page of results in subsequent list requests. Acceptable values are
8622 `0` to `500`, inclusive. (Default: `500`)
8623 orderBy: string, Sorts list results by a certain order. By default, results
8624 are returned in alphanumerical order based on the resource name.
8625
8626 You can also sort results in descending order based on the creation
8627 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8628 results based on the `creationTimestamp` field in
8629 reverse chronological order (newest result first). Use this to sort
8630 resources like operations so that the newest operation is returned first.
8631
8632 Currently, only sorting by `name` or
8633 `creationTimestamp desc` is supported.
8634 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8635 `nextPageToken` returned by a previous list request to get
8636 the next page of results.
8637 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8638 of failure. The default value is false.
8639
8640 For example, when partial success behavior is enabled, aggregatedList for a
8641 single zone scope either returns all resources in the zone or no resources,
8642 with an error code.
8643 x__xgafv: string, V1 error format.
8644 Allowed values
8645 1 - v1 error format
8646 2 - v2 error format
8647
8648 Returns:
8649 An object of the form:
8650
8651 { # [Output Only] A list of managed instance groups.
8652 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
8653 &quot;items&quot;: [ # A list of InstanceGroupManager resources.
8654 { # Represents a Managed Instance Group resource.
8655 #
8656 # An instance group is a collection of VM instances that you can manage as a
8657 # single entity. For more information, readInstance groups.
8658 #
8659 # For zonal Managed Instance Group, use the instanceGroupManagers
8660 # resource.
8661 #
8662 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
8663 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
8664 # for the group.
8665 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
8666 #
8667 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
8668 # instances to apply the configuration. To apply the configuration, set the
8669 # group&#x27;s updatePolicy.type field to use proactive updates or
8670 # use the applyUpdatesToInstances method.
8671 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
8672 &quot;a_key&quot;: &quot;A String&quot;,
8673 },
8674 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
8675 # more information, see Project and
8676 # instance metadata.
8677 &quot;a_key&quot;: &quot;A String&quot;,
8678 },
8679 },
8680 },
8681 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
8682 # only one value.
8683 {
8684 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
8685 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
8686 # this field controls whether to trigger VM autohealing based on a failed
8687 # health check. Valid values are:
8688 #
8689 # - ON (default): The group recreates running VMs that
8690 # fail the application-based health check.
8691 # - OFF: When set to OFF, you can still observe instance
8692 # health state, but the group does not recreate VMs that fail the
8693 # application-based health check. This is useful for troubleshooting and
8694 # setting up your health check configuration.
8695 },
8696 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
8697 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
8698 # initialize and run its startup script. During a VM&#x27;s initial delay
8699 # period, the MIG ignores unsuccessful health checks because the VM might
8700 # be in the startup process. This prevents the MIG from prematurely
8701 # recreating a VM. If the health check receives a healthy response during
8702 # the initial delay, it indicates that the startup process is complete and
8703 # the VM is ready. The value of initial delay must be between 0 and 3600
8704 # seconds. The default value is 0.
8705 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
8706 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
8707 # The instance is considered available if all of the following conditions
8708 # are satisfied:
8709 # 1. Instance&#x27;s status is RUNNING.
8710 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
8711 # check result was observed to be HEALTHY at least once as it passed
8712 # VERIFYING).
8713 # 3. There is no outgoing action on an instance triggered by IGM.
8714 #
8715 # By default, number of concurrently autohealed instances is smaller than
8716 # the managed instance group target size. However, if a zonal managed
8717 # instance group has only one instance, or a regional managed instance
8718 # group has only one instance per zone, autohealing will recreate these
8719 # instances when they become unhealthy.
8720 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8721 #
8722 #
8723 #
8724 # - If the value is fixed, then the calculated
8725 # value is equal to the fixed value.
8726 # - If the value is a percent, then the
8727 # calculated
8728 # value is percent/100 * targetSize. For example,
8729 # the calculated value of a 80% of a managed instance group
8730 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8731 # is a remainder, the number is rounded.
8732 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8733 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8734 # example, specify 80 for 80%.
8735 },
8736 },
8737 ],
8738 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
8739 # all VMs in a MIG. The maximum character length is 58 and the name must
8740 # comply with RFC1035 format.
8741 #
8742 # When a VM is created in the group, the MIG appends a hyphen and a random
8743 # four-character string to the base instance name. If you want the MIG to
8744 # assign sequential numbers instead of a random string, then end the base
8745 # instance name with a hyphen followed by one or more hash symbols. The hash
8746 # symbols indicate the number of digits. For example, a base instance name of
8747 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
8748 # @pattern
8749 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
8750 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
8751 # text format.
8752 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
8753 # in this managed instance group that are scheduled for each of those
8754 # actions.
8755 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
8756 # that are scheduled to be abandoned. Abandoning an instance removes it
8757 # from the managed instance group without deleting it.
8758 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
8759 # are scheduled to be adopted or are currently being adopted.
8760 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
8761 # are scheduled to be created or are currently being created. If the group
8762 # fails to create any of these instances, it tries again until it creates
8763 # the instance successfully.
8764 #
8765 # If you have disabled creation retries, this field will not be populated;
8766 # instead, the creatingWithoutRetries field will be populated.
8767 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
8768 # will attempt to create atomically, in a batch mode. If the desired count
8769 # of instances can not be created, entire batch will be deleted and the
8770 # group will decrease its targetSize value accordingly.
8771 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
8772 # will attempt to create. The group attempts to create each instance
8773 # only once. If the group fails to create any of these instances, it
8774 # decreases the group&#x27;s targetSize value accordingly.
8775 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
8776 # are scheduled to be deleted or are currently being deleted.
8777 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
8778 # are running and have no scheduled actions.
8779 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
8780 # is currently queuing.
8781 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
8782 # are scheduled to be recreated or are currently being being recreated.
8783 # Recreating an instance deletes the existing root persistent disk
8784 # and creates a new disk from the image that is defined in the
8785 # instance template.
8786 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
8787 # are being reconfigured with properties that do not require a restart
8788 # or a recreate action. For example, setting or removing target
8789 # pools for the instance.
8790 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
8791 # are scheduled to be restarted or are currently being restarted.
8792 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
8793 # are scheduled to be restarted or are currently being restarted.
8794 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
8795 # are scheduled to be resumed or are currently being resumed.
8796 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
8797 # are scheduled to be started or are currently being started.
8798 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
8799 # are scheduled to be stopped or are currently being stopped.
8800 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
8801 # are scheduled to be suspended or are currently being suspended.
8802 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
8803 # are being verified. See the managedInstances[].currentAction
8804 # property in the listManagedInstances method documentation.
8805 },
8806 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
8807 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
8808 # zones in a regional managed instance group.
8809 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
8810 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
8811 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
8812 # its instances.
8813 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
8814 # instances, even if an AI zone is available in the specified region. To
8815 # create instances in an AI zone in the selected region, you must explicitly
8816 # specify it in the distribution policy together with the other preferred
8817 # zones.
8818 {
8819 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
8820 # The zone must exist in the region where the managed instance group is
8821 # located.
8822 },
8823 ],
8824 },
8825 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
8826 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
8827 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
8828 # fingerprint must be provided in order to update the InstanceGroupManager,
8829 # otherwise the request will fail with error412 conditionNotMet.
8830 #
8831 # To see the latest fingerprint, make a get() request to
8832 # retrieve an InstanceGroupManager.
8833 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
8834 # generates this identifier.
8835 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
8836 # types of machines.
8837 # Instance flexibility configuration on MIG overrides instance
8838 # template configuration.
8839 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
8840 # when creating new VMs.
8841 &quot;a_key&quot;: {
8842 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
8843 # selection.
8844 { # An instance-attached disk resource.
8845 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
8846 # or X86_64.
8847 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
8848 # deleted (but not when the disk is detached from the instance).
8849 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
8850 # partition of the disk for its root filesystem.
8851 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
8852 # running within the instance. This name can be used to reference the device
8853 # for mounting, resizing, and so on, from within the instance.
8854 #
8855 # If not specified, the server chooses a default device name to apply to this
8856 # disk, in the form persistent-disk-x, where x is a number
8857 # assigned by Google Compute Engine. This field is only applicable for
8858 # persistent disks.
8859 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
8860 # encryption key.
8861 #
8862 # If you are creating a new disk, this field encrypts the new disk using
8863 # an encryption key that you provide. If you are attaching an existing
8864 # disk that is already encrypted, this field decrypts the disk using
8865 # the customer-supplied encryption key.
8866 #
8867 # If you encrypt a disk using a customer-supplied key, you must provide the
8868 # same key again when you attempt to use this resource at a later time. For
8869 # example, you must provide the key when you create a snapshot or an image
8870 # from the disk or when you attach the disk to a virtual machine instance.
8871 #
8872 # If you do not provide an encryption key, then the disk will be encrypted
8873 # using an automatically generated key and you do not need to provide a key
8874 # to use the disk later.
8875 #
8876 # Note:
8877 #
8878 # Instance templates do not storecustomer-supplied
8879 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
8880 #
8881 # You cannot create VMs that have disks with customer-supplied keys using
8882 # the bulk
8883 # insert method.
8884 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8885 # For example:
8886 #
8887 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8888 # key_region/cryptoKeys/key
8889 #
8890 # The fully-qualifed key name may be returned for resource GET requests. For
8891 # example:
8892 #
8893 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8894 # key_region/cryptoKeys/key
8895 # /cryptoKeyVersions/1
8896 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8897 # key. If absent, the Compute Engine default service account is used.
8898 # For example:
8899 #
8900 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8901 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8902 # encryption key, encoded in RFC
8903 # 4648 base64 to either encrypt or decrypt this resource. You can
8904 # provide either the rawKey or thersaEncryptedKey.
8905 # For example:
8906 #
8907 # &quot;rawKey&quot;:
8908 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8909 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8910 # customer-supplied encryption key to either encrypt or decrypt this
8911 # resource. You can provide either the rawKey or thersaEncryptedKey.
8912 # For example:
8913 #
8914 # &quot;rsaEncryptedKey&quot;:
8915 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8916 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8917 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8918 #
8919 # The key must meet the following requirements before you can provide it to
8920 # Compute Engine:
8921 #
8922 # 1. The key is wrapped using a RSA public key certificate provided by
8923 # Google.
8924 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8925 # encoding.
8926 #
8927 # Gets the RSA public key certificate provided by Google at:
8928 #
8929 #
8930 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8931 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8932 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8933 # encryption key that protects this resource.
8934 },
8935 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
8936 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
8937 # currently attached to another instance. If you try to force attach a zonal
8938 # disk to an instance, you will receive an error.
8939 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8940 # only for bootable images. Read
8941 # Enabling guest operating system features to see a list of available
8942 # options.
8943 { # Guest OS features.
8944 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8945 # separate values. Set to one or more of the following values:
8946 #
8947 # - VIRTIO_SCSI_MULTIQUEUE
8948 # - WINDOWS
8949 # - MULTI_IP_SUBNET
8950 # - UEFI_COMPATIBLE
8951 # - GVNIC
8952 # - SEV_CAPABLE
8953 # - SUSPEND_RESUME_COMPATIBLE
8954 # - SEV_LIVE_MIGRATABLE_V2
8955 # - SEV_SNP_CAPABLE
8956 # - TDX_CAPABLE
8957 # - IDPF
8958 # - SNP_SVSM_CAPABLE
8959 # - CCA_CAPABLE
8960 #
8961 #
8962 # For more information, see
8963 # Enabling guest operating system features.
8964 },
8965 ],
8966 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
8967 # boot disk. If you have many disks attached to an instance, each
8968 # disk would have a unique index number.
8969 &quot;initializeParams&quot;: { # [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
8970 # alongside the new instance. Use initialization parameters to create boot
8971 # disks or local SSDs attached to the new instance.
8972 #
8973 # This property is mutually exclusive with the source property;
8974 # you can only define one or the other, but not both.
8975 # alongside the new instance. Use initialization parameters to create boot
8976 # disks or local SSDs attached to the new instance.
8977 #
8978 # This field is persisted and returned for instanceTemplate and not returned
8979 # in the context of instance.
8980 #
8981 # This property is mutually exclusive with the source property;
8982 # you can only define one or the other, but not both.
8983 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
8984 # arm64 or x86_64.
8985 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
8986 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
8987 # of the instance. If a disk with the same name already exists in the given
8988 # region, the existing disk is attached to the new instance and the
8989 # new disk is not created.
8990 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
8991 # 10 GB. If you specify a sourceImage, which is required for
8992 # boot disks, the default size is the size of the sourceImage.
8993 # If you do not specify a sourceImage, the default disk size
8994 # is 500 GB.
8995 &quot;diskType&quot;: &quot;A String&quot;,
8996 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
8997 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8998 # only for bootable images. Read
8999 # Enabling guest operating system features to see a list of available
9000 # options.
9001 #
9002 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
9003 { # Guest OS features.
9004 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9005 # separate values. Set to one or more of the following values:
9006 #
9007 # - VIRTIO_SCSI_MULTIQUEUE
9008 # - WINDOWS
9009 # - MULTI_IP_SUBNET
9010 # - UEFI_COMPATIBLE
9011 # - GVNIC
9012 # - SEV_CAPABLE
9013 # - SUSPEND_RESUME_COMPATIBLE
9014 # - SEV_LIVE_MIGRATABLE_V2
9015 # - SEV_SNP_CAPABLE
9016 # - TDX_CAPABLE
9017 # - IDPF
9018 # - SNP_SVSM_CAPABLE
9019 # - CCA_CAPABLE
9020 #
9021 #
9022 # For more information, see
9023 # Enabling guest operating system features.
9024 },
9025 ],
9026 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
9027 # which is either SCSI or NVME. The default isSCSI.
9028 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
9029 # persistent disks.
9030 &quot;a_key&quot;: &quot;A String&quot;,
9031 },
9032 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
9033 # disk.
9034 &quot;A String&quot;,
9035 ],
9036 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
9037 &quot;A String&quot;,
9038 ],
9039 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
9040 # more than one instance.
9041 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
9042 # is to use the existing disk.
9043 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
9044 # of I/O operations per second that the disk can handle. Values must be
9045 # between 10,000 and 120,000. For more details, see theExtreme persistent
9046 # disk documentation.
9047 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
9048 # number of throughput mb per second that the disk can handle. Values must
9049 # greater than or equal to 1.
9050 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
9051 # the URLs of the zones where the disk should be replicated to.
9052 # You must provide exactly two replica zones, and one zone must be the same
9053 # as the instance zone.
9054 &quot;A String&quot;,
9055 ],
9056 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
9057 # have the same definition as resource
9058 # manager tags. Keys and values can be either in numeric format,
9059 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
9060 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
9061 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
9062 # empty.
9063 &quot;a_key&quot;: &quot;A String&quot;,
9064 },
9065 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
9066 # Specified using the full or partial URL. For instance template, specify
9067 # only the resource policy name.
9068 &quot;A String&quot;,
9069 ],
9070 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
9071 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9072 # is required.
9073 #
9074 # To create a disk with one of the public operating system
9075 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
9076 #
9077 # projects/debian-cloud/global/images/family/debian-9
9078 #
9079 #
9080 # Alternatively, use a specific version of a public operating system image:
9081 #
9082 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
9083 #
9084 #
9085 # To create a disk with a custom image that you created, specify the
9086 # image name in the following format:
9087 #
9088 # global/images/my-custom-image
9089 #
9090 #
9091 # You can also specify a custom image by its image family, which returns
9092 # the latest version of the image in that family. Replace the image name
9093 # with family/family-name:
9094 #
9095 # global/images/family/my-image-family
9096 #
9097 #
9098 # If the source image is deleted later, this field will not be set.
9099 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
9100 # encryption key of the source image. Required if the source image is
9101 # protected by a customer-supplied encryption key.
9102 #
9103 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
9104 # encryption keys, so you cannot create disks for instances in a managed instance group if the
9105 # source images are encrypted with your own keys.
9106 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9107 # For example:
9108 #
9109 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9110 # key_region/cryptoKeys/key
9111 #
9112 # The fully-qualifed key name may be returned for resource GET requests. For
9113 # example:
9114 #
9115 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9116 # key_region/cryptoKeys/key
9117 # /cryptoKeyVersions/1
9118 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9119 # key. If absent, the Compute Engine default service account is used.
9120 # For example:
9121 #
9122 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9123 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9124 # encryption key, encoded in RFC
9125 # 4648 base64 to either encrypt or decrypt this resource. You can
9126 # provide either the rawKey or thersaEncryptedKey.
9127 # For example:
9128 #
9129 # &quot;rawKey&quot;:
9130 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9131 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9132 # customer-supplied encryption key to either encrypt or decrypt this
9133 # resource. You can provide either the rawKey or thersaEncryptedKey.
9134 # For example:
9135 #
9136 # &quot;rsaEncryptedKey&quot;:
9137 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9138 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9139 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9140 #
9141 # The key must meet the following requirements before you can provide it to
9142 # Compute Engine:
9143 #
9144 # 1. The key is wrapped using a RSA public key certificate provided by
9145 # Google.
9146 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9147 # encoding.
9148 #
9149 # Gets the RSA public key certificate provided by Google at:
9150 #
9151 #
9152 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9153 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9154 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9155 # encryption key that protects this resource.
9156 },
9157 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
9158 # instance boot disk, one of initializeParams.sourceSnapshot
9159 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
9160 # is required.
9161 #
9162 # To create a disk with a snapshot that you created, specify the
9163 # snapshot name in the following format:
9164 #
9165 # us-central1-a/instantSnapshots/my-backup
9166 #
9167 #
9168 # If the source instant-snapshot is deleted later, this field will not be
9169 # set.
9170 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
9171 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
9172 # is required.
9173 #
9174 # To create a disk with a snapshot that you created, specify the
9175 # snapshot name in the following format:
9176 #
9177 # global/snapshots/my-backup
9178 #
9179 #
9180 # If the source snapshot is deleted later, this field will not be set.
9181 #
9182 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
9183 # an image instead when you create VMs using
9184 # the bulk
9185 # insert method.
9186 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
9187 # encryption key of the source snapshot.
9188 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9189 # For example:
9190 #
9191 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9192 # key_region/cryptoKeys/key
9193 #
9194 # The fully-qualifed key name may be returned for resource GET requests. For
9195 # example:
9196 #
9197 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9198 # key_region/cryptoKeys/key
9199 # /cryptoKeyVersions/1
9200 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9201 # key. If absent, the Compute Engine default service account is used.
9202 # For example:
9203 #
9204 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9205 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9206 # encryption key, encoded in RFC
9207 # 4648 base64 to either encrypt or decrypt this resource. You can
9208 # provide either the rawKey or thersaEncryptedKey.
9209 # For example:
9210 #
9211 # &quot;rawKey&quot;:
9212 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9213 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9214 # customer-supplied encryption key to either encrypt or decrypt this
9215 # resource. You can provide either the rawKey or thersaEncryptedKey.
9216 # For example:
9217 #
9218 # &quot;rsaEncryptedKey&quot;:
9219 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9220 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9221 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9222 #
9223 # The key must meet the following requirements before you can provide it to
9224 # Compute Engine:
9225 #
9226 # 1. The key is wrapped using a RSA public key certificate provided by
9227 # Google.
9228 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9229 # encoding.
9230 #
9231 # Gets the RSA public key certificate provided by Google at:
9232 #
9233 #
9234 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9235 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9236 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9237 # encryption key that protects this resource.
9238 },
9239 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
9240 # this as a partial or full URL to the resource. For example, the following
9241 # are valid values:
9242 #
9243 #
9244 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
9245 # - projects/project/zones/zone/storagePools/storagePool
9246 # - zones/zone/storagePools/storagePool
9247 },
9248 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
9249 # either SCSI or NVME. For most machine types, the
9250 # default is SCSI. Local SSDs can use either NVME or SCSI.
9251 # In certain configurations, persistent disks can use NVMe. For more
9252 # information, seeAbout
9253 # persistent disks.
9254 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
9255 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
9256 &quot;A String&quot;,
9257 ],
9258 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
9259 # disk is not allowed to be detached from the instance, or to be used as the
9260 # source of the snapshot creation, and the image creation. The instance with
9261 # at least one locked attached disk is not allow to be used as source of
9262 # machine image creation, instant snapshot creation, and not allowed to be
9263 # deleted with --keep-disk parameter set to true for locked disks.
9264 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
9265 # in READ_WRITE mode.
9266 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
9267 # field is set to PRESERVED if the LocalSSD data has been saved
9268 # to a persistent location by customer request. (see the
9269 # discard_local_ssd option on Stop/Suspend).
9270 # Read-only in the api.
9271 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
9272 # these are public keys which are safe to store in public
9273 &quot;dbs&quot;: [ # The Key Database (db).
9274 {
9275 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9276 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9277 },
9278 ],
9279 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
9280 {
9281 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9282 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9283 },
9284 ],
9285 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
9286 {
9287 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9288 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9289 },
9290 ],
9291 &quot;pk&quot;: { # The Platform Key (PK).
9292 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9293 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9294 },
9295 },
9296 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
9297 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9298 # is required.
9299 #
9300 # If desired, you can also attach existing non-root persistent disks using
9301 # this property. This field is only applicable for persistent disks.
9302 #
9303 # Note that for InstanceTemplate, specify the disk name for zonal disk,
9304 # and the URL for regional disk.
9305 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
9306 },
9307 ],
9308 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
9309 &quot;A String&quot;,
9310 ],
9311 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
9312 # e.g. &#x27;Intel Ice Lake&#x27;.
9313 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
9314 # preference. MIG will first try to create a VM based on the machine-type
9315 # with lowest rank and fallback to next rank based on availability.
9316 # Machine types and instance selections with the same rank have the same
9317 # preference.
9318 },
9319 },
9320 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
9321 # when creating new VMs.
9322 &quot;a_key&quot;: {
9323 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
9324 # selection.
9325 { # An instance-attached disk resource.
9326 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
9327 # or X86_64.
9328 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
9329 # deleted (but not when the disk is detached from the instance).
9330 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
9331 # partition of the disk for its root filesystem.
9332 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
9333 # running within the instance. This name can be used to reference the device
9334 # for mounting, resizing, and so on, from within the instance.
9335 #
9336 # If not specified, the server chooses a default device name to apply to this
9337 # disk, in the form persistent-disk-x, where x is a number
9338 # assigned by Google Compute Engine. This field is only applicable for
9339 # persistent disks.
9340 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
9341 # encryption key.
9342 #
9343 # If you are creating a new disk, this field encrypts the new disk using
9344 # an encryption key that you provide. If you are attaching an existing
9345 # disk that is already encrypted, this field decrypts the disk using
9346 # the customer-supplied encryption key.
9347 #
9348 # If you encrypt a disk using a customer-supplied key, you must provide the
9349 # same key again when you attempt to use this resource at a later time. For
9350 # example, you must provide the key when you create a snapshot or an image
9351 # from the disk or when you attach the disk to a virtual machine instance.
9352 #
9353 # If you do not provide an encryption key, then the disk will be encrypted
9354 # using an automatically generated key and you do not need to provide a key
9355 # to use the disk later.
9356 #
9357 # Note:
9358 #
9359 # Instance templates do not storecustomer-supplied
9360 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
9361 #
9362 # You cannot create VMs that have disks with customer-supplied keys using
9363 # the bulk
9364 # insert method.
9365 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9366 # For example:
9367 #
9368 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9369 # key_region/cryptoKeys/key
9370 #
9371 # The fully-qualifed key name may be returned for resource GET requests. For
9372 # example:
9373 #
9374 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9375 # key_region/cryptoKeys/key
9376 # /cryptoKeyVersions/1
9377 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9378 # key. If absent, the Compute Engine default service account is used.
9379 # For example:
9380 #
9381 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9382 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9383 # encryption key, encoded in RFC
9384 # 4648 base64 to either encrypt or decrypt this resource. You can
9385 # provide either the rawKey or thersaEncryptedKey.
9386 # For example:
9387 #
9388 # &quot;rawKey&quot;:
9389 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9390 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9391 # customer-supplied encryption key to either encrypt or decrypt this
9392 # resource. You can provide either the rawKey or thersaEncryptedKey.
9393 # For example:
9394 #
9395 # &quot;rsaEncryptedKey&quot;:
9396 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9397 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9398 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9399 #
9400 # The key must meet the following requirements before you can provide it to
9401 # Compute Engine:
9402 #
9403 # 1. The key is wrapped using a RSA public key certificate provided by
9404 # Google.
9405 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9406 # encoding.
9407 #
9408 # Gets the RSA public key certificate provided by Google at:
9409 #
9410 #
9411 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9412 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9413 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9414 # encryption key that protects this resource.
9415 },
9416 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
9417 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
9418 # currently attached to another instance. If you try to force attach a zonal
9419 # disk to an instance, you will receive an error.
9420 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
9421 # only for bootable images. Read
9422 # Enabling guest operating system features to see a list of available
9423 # options.
9424 { # Guest OS features.
9425 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9426 # separate values. Set to one or more of the following values:
9427 #
9428 # - VIRTIO_SCSI_MULTIQUEUE
9429 # - WINDOWS
9430 # - MULTI_IP_SUBNET
9431 # - UEFI_COMPATIBLE
9432 # - GVNIC
9433 # - SEV_CAPABLE
9434 # - SUSPEND_RESUME_COMPATIBLE
9435 # - SEV_LIVE_MIGRATABLE_V2
9436 # - SEV_SNP_CAPABLE
9437 # - TDX_CAPABLE
9438 # - IDPF
9439 # - SNP_SVSM_CAPABLE
9440 # - CCA_CAPABLE
9441 #
9442 #
9443 # For more information, see
9444 # Enabling guest operating system features.
9445 },
9446 ],
9447 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
9448 # boot disk. If you have many disks attached to an instance, each
9449 # disk would have a unique index number.
9450 &quot;initializeParams&quot;: { # [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
9451 # alongside the new instance. Use initialization parameters to create boot
9452 # disks or local SSDs attached to the new instance.
9453 #
9454 # This property is mutually exclusive with the source property;
9455 # you can only define one or the other, but not both.
9456 # alongside the new instance. Use initialization parameters to create boot
9457 # disks or local SSDs attached to the new instance.
9458 #
9459 # This field is persisted and returned for instanceTemplate and not returned
9460 # in the context of instance.
9461 #
9462 # This property is mutually exclusive with the source property;
9463 # you can only define one or the other, but not both.
9464 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
9465 # arm64 or x86_64.
9466 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
9467 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
9468 # of the instance. If a disk with the same name already exists in the given
9469 # region, the existing disk is attached to the new instance and the
9470 # new disk is not created.
9471 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
9472 # 10 GB. If you specify a sourceImage, which is required for
9473 # boot disks, the default size is the size of the sourceImage.
9474 # If you do not specify a sourceImage, the default disk size
9475 # is 500 GB.
9476 &quot;diskType&quot;: &quot;A String&quot;,
9477 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
9478 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
9479 # only for bootable images. Read
9480 # Enabling guest operating system features to see a list of available
9481 # options.
9482 #
9483 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
9484 { # Guest OS features.
9485 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9486 # separate values. Set to one or more of the following values:
9487 #
9488 # - VIRTIO_SCSI_MULTIQUEUE
9489 # - WINDOWS
9490 # - MULTI_IP_SUBNET
9491 # - UEFI_COMPATIBLE
9492 # - GVNIC
9493 # - SEV_CAPABLE
9494 # - SUSPEND_RESUME_COMPATIBLE
9495 # - SEV_LIVE_MIGRATABLE_V2
9496 # - SEV_SNP_CAPABLE
9497 # - TDX_CAPABLE
9498 # - IDPF
9499 # - SNP_SVSM_CAPABLE
9500 # - CCA_CAPABLE
9501 #
9502 #
9503 # For more information, see
9504 # Enabling guest operating system features.
9505 },
9506 ],
9507 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
9508 # which is either SCSI or NVME. The default isSCSI.
9509 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
9510 # persistent disks.
9511 &quot;a_key&quot;: &quot;A String&quot;,
9512 },
9513 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
9514 # disk.
9515 &quot;A String&quot;,
9516 ],
9517 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
9518 &quot;A String&quot;,
9519 ],
9520 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
9521 # more than one instance.
9522 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
9523 # is to use the existing disk.
9524 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
9525 # of I/O operations per second that the disk can handle. Values must be
9526 # between 10,000 and 120,000. For more details, see theExtreme persistent
9527 # disk documentation.
9528 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
9529 # number of throughput mb per second that the disk can handle. Values must
9530 # greater than or equal to 1.
9531 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
9532 # the URLs of the zones where the disk should be replicated to.
9533 # You must provide exactly two replica zones, and one zone must be the same
9534 # as the instance zone.
9535 &quot;A String&quot;,
9536 ],
9537 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
9538 # have the same definition as resource
9539 # manager tags. Keys and values can be either in numeric format,
9540 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
9541 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
9542 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
9543 # empty.
9544 &quot;a_key&quot;: &quot;A String&quot;,
9545 },
9546 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
9547 # Specified using the full or partial URL. For instance template, specify
9548 # only the resource policy name.
9549 &quot;A String&quot;,
9550 ],
9551 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
9552 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9553 # is required.
9554 #
9555 # To create a disk with one of the public operating system
9556 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
9557 #
9558 # projects/debian-cloud/global/images/family/debian-9
9559 #
9560 #
9561 # Alternatively, use a specific version of a public operating system image:
9562 #
9563 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
9564 #
9565 #
9566 # To create a disk with a custom image that you created, specify the
9567 # image name in the following format:
9568 #
9569 # global/images/my-custom-image
9570 #
9571 #
9572 # You can also specify a custom image by its image family, which returns
9573 # the latest version of the image in that family. Replace the image name
9574 # with family/family-name:
9575 #
9576 # global/images/family/my-image-family
9577 #
9578 #
9579 # If the source image is deleted later, this field will not be set.
9580 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
9581 # encryption key of the source image. Required if the source image is
9582 # protected by a customer-supplied encryption key.
9583 #
9584 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
9585 # encryption keys, so you cannot create disks for instances in a managed instance group if the
9586 # source images are encrypted with your own keys.
9587 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9588 # For example:
9589 #
9590 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9591 # key_region/cryptoKeys/key
9592 #
9593 # The fully-qualifed key name may be returned for resource GET requests. For
9594 # example:
9595 #
9596 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9597 # key_region/cryptoKeys/key
9598 # /cryptoKeyVersions/1
9599 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9600 # key. If absent, the Compute Engine default service account is used.
9601 # For example:
9602 #
9603 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9604 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9605 # encryption key, encoded in RFC
9606 # 4648 base64 to either encrypt or decrypt this resource. You can
9607 # provide either the rawKey or thersaEncryptedKey.
9608 # For example:
9609 #
9610 # &quot;rawKey&quot;:
9611 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9612 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9613 # customer-supplied encryption key to either encrypt or decrypt this
9614 # resource. You can provide either the rawKey or thersaEncryptedKey.
9615 # For example:
9616 #
9617 # &quot;rsaEncryptedKey&quot;:
9618 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9619 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9620 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9621 #
9622 # The key must meet the following requirements before you can provide it to
9623 # Compute Engine:
9624 #
9625 # 1. The key is wrapped using a RSA public key certificate provided by
9626 # Google.
9627 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9628 # encoding.
9629 #
9630 # Gets the RSA public key certificate provided by Google at:
9631 #
9632 #
9633 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9634 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9635 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9636 # encryption key that protects this resource.
9637 },
9638 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
9639 # instance boot disk, one of initializeParams.sourceSnapshot
9640 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
9641 # is required.
9642 #
9643 # To create a disk with a snapshot that you created, specify the
9644 # snapshot name in the following format:
9645 #
9646 # us-central1-a/instantSnapshots/my-backup
9647 #
9648 #
9649 # If the source instant-snapshot is deleted later, this field will not be
9650 # set.
9651 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
9652 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
9653 # is required.
9654 #
9655 # To create a disk with a snapshot that you created, specify the
9656 # snapshot name in the following format:
9657 #
9658 # global/snapshots/my-backup
9659 #
9660 #
9661 # If the source snapshot is deleted later, this field will not be set.
9662 #
9663 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
9664 # an image instead when you create VMs using
9665 # the bulk
9666 # insert method.
9667 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
9668 # encryption key of the source snapshot.
9669 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9670 # For example:
9671 #
9672 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9673 # key_region/cryptoKeys/key
9674 #
9675 # The fully-qualifed key name may be returned for resource GET requests. For
9676 # example:
9677 #
9678 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9679 # key_region/cryptoKeys/key
9680 # /cryptoKeyVersions/1
9681 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9682 # key. If absent, the Compute Engine default service account is used.
9683 # For example:
9684 #
9685 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9686 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9687 # encryption key, encoded in RFC
9688 # 4648 base64 to either encrypt or decrypt this resource. You can
9689 # provide either the rawKey or thersaEncryptedKey.
9690 # For example:
9691 #
9692 # &quot;rawKey&quot;:
9693 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9694 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9695 # customer-supplied encryption key to either encrypt or decrypt this
9696 # resource. You can provide either the rawKey or thersaEncryptedKey.
9697 # For example:
9698 #
9699 # &quot;rsaEncryptedKey&quot;:
9700 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9701 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9702 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9703 #
9704 # The key must meet the following requirements before you can provide it to
9705 # Compute Engine:
9706 #
9707 # 1. The key is wrapped using a RSA public key certificate provided by
9708 # Google.
9709 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9710 # encoding.
9711 #
9712 # Gets the RSA public key certificate provided by Google at:
9713 #
9714 #
9715 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9716 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9717 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9718 # encryption key that protects this resource.
9719 },
9720 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
9721 # this as a partial or full URL to the resource. For example, the following
9722 # are valid values:
9723 #
9724 #
9725 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
9726 # - projects/project/zones/zone/storagePools/storagePool
9727 # - zones/zone/storagePools/storagePool
9728 },
9729 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
9730 # either SCSI or NVME. For most machine types, the
9731 # default is SCSI. Local SSDs can use either NVME or SCSI.
9732 # In certain configurations, persistent disks can use NVMe. For more
9733 # information, seeAbout
9734 # persistent disks.
9735 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
9736 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
9737 &quot;A String&quot;,
9738 ],
9739 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
9740 # disk is not allowed to be detached from the instance, or to be used as the
9741 # source of the snapshot creation, and the image creation. The instance with
9742 # at least one locked attached disk is not allow to be used as source of
9743 # machine image creation, instant snapshot creation, and not allowed to be
9744 # deleted with --keep-disk parameter set to true for locked disks.
9745 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
9746 # in READ_WRITE mode.
9747 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
9748 # field is set to PRESERVED if the LocalSSD data has been saved
9749 # to a persistent location by customer request. (see the
9750 # discard_local_ssd option on Stop/Suspend).
9751 # Read-only in the api.
9752 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
9753 # these are public keys which are safe to store in public
9754 &quot;dbs&quot;: [ # The Key Database (db).
9755 {
9756 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9757 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9758 },
9759 ],
9760 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
9761 {
9762 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9763 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9764 },
9765 ],
9766 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
9767 {
9768 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9769 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9770 },
9771 ],
9772 &quot;pk&quot;: { # The Platform Key (PK).
9773 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9774 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9775 },
9776 },
9777 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
9778 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9779 # is required.
9780 #
9781 # If desired, you can also attach existing non-root persistent disks using
9782 # this property. This field is only applicable for persistent disks.
9783 #
9784 # Note that for InstanceTemplate, specify the disk name for zonal disk,
9785 # and the URL for regional disk.
9786 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
9787 },
9788 ],
9789 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
9790 &quot;A String&quot;,
9791 ],
9792 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
9793 # e.g. &#x27;Intel Ice Lake&#x27;.
9794 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
9795 # preference. MIG will first try to create a VM based on the machine-type
9796 # with lowest rank and fallback to next rank based on availability.
9797 # Machine types and instance selections with the same rank have the same
9798 # preference.
9799 },
9800 },
9801 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
9802 # create instances.
9803 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
9804 # more preemption than the minimum capacity user needs. MIG will create
9805 # only Standard VMs until it reaches standard_capacity_base and only
9806 # then will start using standard_capacity_percent_above_base to mix Spot
9807 # with Standard VMs.
9808 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
9809 # remaining percentage will use Spot VMs. The percentage applies only to
9810 # the capacity above standard_capacity_base.
9811 },
9812 },
9813 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
9814 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
9815 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
9816 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
9817 # applies to the VMs on which your application fails a health check.
9818 # Valid values are
9819 #
9820 # - REPAIR (default): MIG automatically repairs a failed VM
9821 # by recreating it. For more information, see About
9822 # repairing VMs in a MIG.
9823 # - DO_NOTHING: MIG does not repair a failed VM.
9824 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
9825 # configuration when repairing a VM. Valid options are:
9826 #
9827 #
9828 #
9829 # - NO (default): If configuration updates are available, they are not
9830 # forcefully applied during repair. Instead, configuration updates are
9831 # applied according to the group&#x27;s update policy.
9832 #
9833 # - YES: If configuration updates are available, they are applied
9834 # during repair.
9835 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
9836 # instance during initialization when stopping / suspending an instance.
9837 # The Instance Group Manager will wait for a signal that indicates
9838 # successful initialization before stopping / suspending an instance.
9839 #
9840 # If a successful readiness signal is not sent before timeout, the
9841 # corresponding instance will not be stopped / suspended. Instead,
9842 # an error will be visible in the lastAttempt.errors field of
9843 # the managed instance in the listmanagedinstances
9844 # method.
9845 #
9846 # If metadataBasedReadinessSignal.timeoutSec is unset,
9847 # the Instance Group Manager will directly proceed to suspend / stop
9848 # instances, skipping initialization on them.
9849 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
9850 # initialization before timing out.
9851 },
9852 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
9853 # unhealthy when the application running on that VM fails a health check.
9854 # Valid values are:
9855 #
9856 # - DEFAULT_ACTION (default): MIG uses the same action
9857 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
9858 # - REPAIR: MIG automatically repairs an unhealthy VM by
9859 # recreating it.
9860 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
9861 # For more information, see
9862 # About repairing VMs in a MIG.
9863 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
9864 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
9865 # Valid values are:
9866 #
9867 # - NO (default): MIG cannot change a VM&#x27;s zone during a
9868 # repair.
9869 # - YES: MIG can select a different zone for the VM during
9870 # a repair.
9871 },
9872 },
9873 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
9874 # instance group. The group uses this template to create all new instances
9875 # in the managed instance group. The templates for existing instances in the
9876 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
9877 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
9878 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
9879 # this managed instance group.
9880 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
9881 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
9882 # long, and comply withRFC1035.
9883 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
9884 # to this Instance Group Manager.
9885 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
9886 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
9887 # The name must be 1-63 characters long, and comply withRFC1035.
9888 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
9889 },
9890 ],
9891 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
9892 # as part of resource payload.
9893 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
9894 # key-value pairs. Keys and values can be either in numeric format,
9895 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
9896 # format such as `{org_id|project_id}/{tag_key_short_name}` and
9897 # `{tag_value_short_name}`. For more information, seeManage tags
9898 # for resources.
9899 &quot;a_key&quot;: &quot;A String&quot;,
9900 },
9901 },
9902 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
9903 # where the managed instance group resides (for regional resources).
9904 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
9905 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
9906 # instance group.
9907 # It can be a full or partial URL. For example, the following are
9908 # all valid URLs to a workload policy:
9909 #
9910 #
9911 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
9912 # - projects/project/regions/region/resourcePolicies/resourcePolicy
9913 # - regions/region/resourcePolicies/resourcePolicy
9914 },
9915 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
9916 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
9917 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
9918 # this URL.
9919 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
9920 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
9921 # by the managed instance group on instances. The service accounts needs all
9922 # permissions required to create and delete instances.
9923 # By default, the service account
9924 # {projectNumber}@cloudservices.gserviceaccount.com is used.
9925 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
9926 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
9927 # stop a VM after that VM was created. The initial delay gives the
9928 # initialization script the time to prepare your VM for a quick scale out.
9929 # The value of initial delay must be between 0 and 3600 seconds. The
9930 # default value is 0.
9931 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
9932 # group scales out. The default mode is `MANUAL`.
9933 },
9934 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
9935 &quot;preservedState&quot;: { # Configuration of preserved resources.
9936 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
9937 # delete, update, etc. This map is keyed with the device names of
9938 # the disks.
9939 &quot;a_key&quot;: {
9940 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
9941 # update or VM instance recreate operations.
9942 # This flag is used to configure if the disk should be deleted after it
9943 # is no longer used by the group, e.g. when the given instance or
9944 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
9945 },
9946 },
9947 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
9948 # instance delete, update, etc. This map is keyed with the network
9949 # interface name.
9950 &quot;a_key&quot;: {
9951 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9952 # update or VM instance recreate operations.
9953 # This flag is used to configure if the IP reservation should be deleted
9954 # after it is no longer used by the group, e.g. when the given instance
9955 # or the whole group is deleted.
9956 },
9957 },
9958 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
9959 # instance delete, update, etc. This map is keyed with the network
9960 # interface name.
9961 &quot;a_key&quot;: {
9962 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9963 # update or VM instance recreate operations.
9964 # This flag is used to configure if the IP reservation should be deleted
9965 # after it is no longer used by the group, e.g. when the given instance
9966 # or the whole group is deleted.
9967 },
9968 },
9969 },
9970 },
9971 &quot;status&quot;: { # Output only. The status of this managed instance group.
9972 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
9973 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
9974 # This value is in RFC3339 text format.
9975 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
9976 # been applied to all managed instances in the group.
9977 },
9978 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
9979 # Currently only one accelerator topology is supported.
9980 {
9981 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
9982 # The value is the same as configured in the WorkloadPolicy.
9983 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
9984 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
9985 # check.
9986 &quot;error&quot;: { # Output only. Encountered errors.
9987 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9988 # operation.
9989 {
9990 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9991 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9992 # details. There is a set of defined message types to use for providing
9993 # details.The syntax depends on the error code. For example,
9994 # QuotaExceededInfo will have details when the error code is
9995 # QUOTA_EXCEEDED.
9996 {
9997 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9998 #
9999 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10000 # is not enabled:
10001 #
10002 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10003 # &quot;domain&quot;: &quot;googleapis.com&quot;
10004 # &quot;metadata&quot;: {
10005 # &quot;resource&quot;: &quot;projects/123&quot;,
10006 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10007 # }
10008 # }
10009 #
10010 # This response indicates that the pubsub.googleapis.com API is not enabled.
10011 #
10012 # Example of an error that is returned when attempting to create a Spanner
10013 # instance in a region that is out of stock:
10014 #
10015 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10016 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10017 # &quot;metadata&quot;: {
10018 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10019 # }
10020 # }
10021 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10022 # is typically the registered service name of the tool or product that
10023 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10024 # generated by some common infrastructure, the error domain must be a
10025 # globally unique value that identifies the infrastructure. For Google API
10026 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10027 &quot;metadatas&quot;: { # Additional structured details about this error.
10028 #
10029 # Keys must match a regular expression of `a-z+` but should
10030 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10031 # length. When identifying the current value of an exceeded limit, the units
10032 # should be contained in the key, not the value. For example, rather than
10033 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10034 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10035 # instances that can be created in a single (batch) request.
10036 &quot;a_key&quot;: &quot;A String&quot;,
10037 },
10038 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10039 # proximate cause of the error. Error reasons are unique within a particular
10040 # domain of errors. This should be at most 63 characters and match a
10041 # regular expression of `A-Z+[A-Z0-9]`, which represents
10042 # UPPER_SNAKE_CASE.
10043 },
10044 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10045 #
10046 # For example, if a quota check failed with an error indicating the calling
10047 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10048 # directly to the right place in the developer console to flip the bit.
10049 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10050 { # Describes a URL link.
10051 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10052 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10053 },
10054 ],
10055 },
10056 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10057 # which can be attached to an RPC error.
10058 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10059 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10060 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10061 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10062 },
10063 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10064 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10065 &quot;a_key&quot;: &quot;A String&quot;,
10066 },
10067 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10068 # type or metric.
10069 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10070 # or metric.
10071 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10072 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10073 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10074 },
10075 },
10076 ],
10077 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10078 # This property is optional.
10079 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10080 },
10081 ],
10082 },
10083 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
10084 # has // RFC3339 //
10085 # text format.
10086 },
10087 },
10088 ],
10089 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
10090 # that targets this instance group manager.
10091 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
10092 # targetSizePolicy.mode is set to BULK.
10093 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
10094 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
10095 # operation.
10096 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
10097 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10098 # operation.
10099 {
10100 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10101 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10102 # details. There is a set of defined message types to use for providing
10103 # details.The syntax depends on the error code. For example,
10104 # QuotaExceededInfo will have details when the error code is
10105 # QUOTA_EXCEEDED.
10106 {
10107 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10108 #
10109 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10110 # is not enabled:
10111 #
10112 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10113 # &quot;domain&quot;: &quot;googleapis.com&quot;
10114 # &quot;metadata&quot;: {
10115 # &quot;resource&quot;: &quot;projects/123&quot;,
10116 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10117 # }
10118 # }
10119 #
10120 # This response indicates that the pubsub.googleapis.com API is not enabled.
10121 #
10122 # Example of an error that is returned when attempting to create a Spanner
10123 # instance in a region that is out of stock:
10124 #
10125 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10126 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10127 # &quot;metadata&quot;: {
10128 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10129 # }
10130 # }
10131 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10132 # is typically the registered service name of the tool or product that
10133 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10134 # generated by some common infrastructure, the error domain must be a
10135 # globally unique value that identifies the infrastructure. For Google API
10136 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10137 &quot;metadatas&quot;: { # Additional structured details about this error.
10138 #
10139 # Keys must match a regular expression of `a-z+` but should
10140 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10141 # length. When identifying the current value of an exceeded limit, the units
10142 # should be contained in the key, not the value. For example, rather than
10143 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10144 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10145 # instances that can be created in a single (batch) request.
10146 &quot;a_key&quot;: &quot;A String&quot;,
10147 },
10148 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10149 # proximate cause of the error. Error reasons are unique within a particular
10150 # domain of errors. This should be at most 63 characters and match a
10151 # regular expression of `A-Z+[A-Z0-9]`, which represents
10152 # UPPER_SNAKE_CASE.
10153 },
10154 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10155 #
10156 # For example, if a quota check failed with an error indicating the calling
10157 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10158 # directly to the right place in the developer console to flip the bit.
10159 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10160 { # Describes a URL link.
10161 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10162 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10163 },
10164 ],
10165 },
10166 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10167 # which can be attached to an RPC error.
10168 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10169 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10170 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10171 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10172 },
10173 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10174 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10175 &quot;a_key&quot;: &quot;A String&quot;,
10176 },
10177 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10178 # type or metric.
10179 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10180 # or metric.
10181 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10182 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10183 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10184 },
10185 },
10186 ],
10187 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10188 # This property is optional.
10189 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10190 },
10191 ],
10192 },
10193 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
10194 # operation. Timestamp is in RFC3339 text format.
10195 },
10196 },
10197 &quot;currentInstanceStatuses&quot;: { # 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
10198 # in this managed instance group that have the status. Currently only shown
10199 # for TPU MIGs
10200 # instance group that have the status. For more information about how to
10201 # interpret each status check the instance lifecycle documentation.
10202 # Currently only shown for TPU MIGs.
10203 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
10204 # that have DEPROVISIONING status.
10205 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
10206 # have been deleted. Includes only instances that would be shown in the
10207 # listManagedInstances method and not all instances that have been
10208 # deleted in the lifetime of the MIG.
10209 # Does not include FlexStart instances that are waiting for the resources
10210 # availability, they are considered as &#x27;pending&#x27;.
10211 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
10212 # that have PENDING status, that is FlexStart instances that are waiting
10213 # for resources. Instances that do not exist because of the other reasons
10214 # are counted as &#x27;non_existent&#x27;.
10215 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
10216 # that have PENDING_STOP status.
10217 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
10218 # that have PROVISIONING status.
10219 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
10220 # that have REPAIRING status.
10221 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
10222 # that have RUNNING status.
10223 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
10224 # that have STAGING status.
10225 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
10226 # that have STOPPED status.
10227 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
10228 # that have STOPPING status.
10229 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
10230 # that have SUSPENDED status.
10231 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
10232 # that have SUSPENDING status.
10233 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
10234 # that have TERMINATED status.
10235 },
10236 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
10237 # stable state. A stable state means that: none of the instances in the
10238 # managed instance group is currently undergoing any type of change (for
10239 # example, creation, restart, or deletion); no future changes are scheduled
10240 # for instances in the managed instance group; and the managed instance
10241 # group itself is not being modified.
10242 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
10243 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
10244 # has stateful configuration, that is, if you have configured any items
10245 # in a stateful policy or in per-instance configs.
10246 # The group might report that it has no stateful configuration even when
10247 # there is still some preserved state on a managed instance, for example,
10248 # if you have deleted all PICs but not yet applied those deletions.
10249 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
10250 # has stateful configuration, that is, if you have configured any items
10251 # in a stateful policy or in per-instance configs.
10252 # The group might report that it has no stateful configuration even when
10253 # there is still some preserved state on a managed instance, for example,
10254 # if you have deleted all PICs but not yet applied those deletions. This
10255 # field is deprecated in favor of has_stateful_config.
10256 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
10257 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
10258 # (listed in the output of a listPerInstanceConfigs API call) have
10259 # status EFFECTIVE or there are no per-instance-configs.
10260 },
10261 },
10262 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
10263 # target version specified by version field on Instance Group
10264 # Manager.
10265 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
10266 # in this managed instance group, i.e. all instances are in their target
10267 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
10268 },
10269 },
10270 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
10271 # apply to all of the instances in the managed instance group.
10272 &quot;A String&quot;,
10273 ],
10274 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
10275 # You can reduce this number by using the instanceGroupManager
10276 # deleteInstances or abandonInstances methods. Resizing the group also
10277 # changes this number.
10278 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
10279 # size.
10280 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
10281 # individually or all at once.
10282 },
10283 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
10284 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
10285 # This number changes when you:
10286 #
10287 # - Stop instance using the stopInstances
10288 # method or start instances using the startInstances
10289 # method.
10290 # - Manually change the targetStoppedSize using the update
10291 # method.
10292 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
10293 # This number changes when you:
10294 #
10295 # - Suspend instance using the suspendInstances
10296 # method or resume instances using the resumeInstances
10297 # method.
10298 # - Manually change the targetSuspendedSize using the update
10299 # method.
10300 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
10301 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
10302 &quot;A String&quot;,
10303 ],
10304 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
10305 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
10306 # instance redistribution policy for regional managed instance groups.
10307 # Valid values are:
10308 #
10309 # - PROACTIVE (default): The group attempts to maintain an
10310 # even distribution of VM instances across zones in the region.
10311 # - NONE: For non-autoscaled groups, proactive
10312 # redistribution is disabled.
10313 &quot;maxSurge&quot;: { # 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
10314 # either a fixed number or, if the group has 10 or more instances, a
10315 # percentage. If you set a percentage, the number of instances is rounded
10316 # if necessary. The default value for maxSurge is a fixed
10317 # value equal to the number of zones in which the managed instance group
10318 # operates.
10319 #
10320 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
10321 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10322 #
10323 #
10324 #
10325 # - If the value is fixed, then the calculated
10326 # value is equal to the fixed value.
10327 # - If the value is a percent, then the
10328 # calculated
10329 # value is percent/100 * targetSize. For example,
10330 # the calculated value of a 80% of a managed instance group
10331 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10332 # is a remainder, the number is rounded.
10333 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10334 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10335 # example, specify 80 for 80%.
10336 },
10337 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
10338 # process. An instance is considered available if all of the following
10339 # conditions are satisfied:
10340 #
10341 #
10342 #
10343 # - The instance&#x27;s status is
10344 # RUNNING.
10345 # - If there is a health
10346 # check on the instance group, the instance&#x27;s health check status
10347 # must be HEALTHY at least once. If there is no health check
10348 # on the group, then the instance only needs to have a status of
10349 # RUNNING to be considered available.
10350 #
10351 #
10352 # This value can be either a fixed number or, if the group has 10 or more
10353 # instances, a percentage. If you set a percentage, the number of instances
10354 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
10355 # in which the managed instance group operates.
10356 #
10357 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
10358 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10359 #
10360 #
10361 #
10362 # - If the value is fixed, then the calculated
10363 # value is equal to the fixed value.
10364 # - If the value is a percent, then the
10365 # calculated
10366 # value is percent/100 * targetSize. For example,
10367 # the calculated value of a 80% of a managed instance group
10368 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10369 # is a remainder, the number is rounded.
10370 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10371 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10372 # example, specify 80 for 80%.
10373 },
10374 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
10375 # becomes available. This value must be from range [0, 3600].
10376 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
10377 # disruption as much as possible or to apply a more disruptive action than
10378 # is necessary.
10379 #
10380 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
10381 # Compute Engine performs the necessary action to execute the update.
10382 # - To apply a more disruptive action than is strictly necessary, set the
10383 # minimal action to RESTART or REPLACE. For
10384 # example, Compute Engine does not need to restart a VM to change its
10385 # metadata. But if your application reads instance metadata only when a VM
10386 # is restarted, you can set the minimal action to RESTART in
10387 # order to pick up metadata changes.
10388 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
10389 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
10390 # as much as possible. RESTART to allow actions that can be
10391 # applied without instance replacing or REPLACE to allow all
10392 # possible actions. If the Updater determines that the minimal update
10393 # action needed is more disruptive than most disruptive allowed action you
10394 # specify it will not perform the update at all.
10395 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
10396 # See minimal_action.REPLACE
10397 &quot;type&quot;: &quot;A String&quot;, # The type
10398 # of update process. You can specify either PROACTIVE so
10399 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
10400 # to update.
10401 },
10402 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
10403 # create instances.
10404 #
10405 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
10406 # group. This field overrides the top-level instanceTemplate
10407 # field. Read more about therelationships
10408 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
10409 # remaining instances. For more information, read aboutcanary
10410 # updates.
10411 {
10412 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
10413 # instance group. The group uses this template to create new instances in
10414 # the managed instance group until the `targetSize` for this version is
10415 # reached. The templates for existing instances in the group do not change
10416 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
10417 # existing instances are updated until the `targetSize` for this version is
10418 # reached.
10419 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
10420 # managed instance group.
10421 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
10422 # even if instance_template remains unchanged.
10423 # Deprecated in favor of &#x27;name&#x27;.
10424 &quot;targetSize&quot;: { # 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
10425 # from the template will be equal to:
10426 #
10427 #
10428 # - If expressed as a fixed number, the minimum of either
10429 # targetSize.fixed or
10430 # instanceGroupManager.targetSize is used.
10431 # - if expressed as a percent, the targetSize
10432 # would be (targetSize.percent/100 *
10433 # InstanceGroupManager.targetSize) If there is a remainder, the
10434 # number is rounded.
10435 #
10436 # If unset, this version will update any remaining instances not
10437 # updated by another version. ReadStarting
10438 # a canary update for more information.
10439 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10440 #
10441 #
10442 #
10443 # - If the value is fixed, then the calculated
10444 # value is equal to the fixed value.
10445 # - If the value is a percent, then the
10446 # calculated
10447 # value is percent/100 * targetSize. For example,
10448 # the calculated value of a 80% of a managed instance group
10449 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10450 # is a remainder, the number is rounded.
10451 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10452 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10453 # example, specify 80 for 80%.
10454 },
10455 },
10456 ],
10457 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
10458 # where the managed instance group is located (for zonal resources).
10459 },
10460 ],
10461 &quot;kind&quot;: &quot;compute#instanceGroupManagerList&quot;, # Output only. The resource type, which is always compute#instanceGroupManagerList for a
10462 # list of managed instance groups.
10463 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
10464 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
10465 # the query parameter pageToken in the next list request.
10466 # Subsequent list requests will have their own nextPageToken to
10467 # continue paging through the results.
10468 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
10469 &quot;warning&quot;: { # Output only. Informational warning message.
10470 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
10471 # Engine returns NO_RESULTS_ON_PAGE if there
10472 # are no results in the response.
10473 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
10474 # value format. For example:
10475 #
10476 # &quot;data&quot;: [
10477 # {
10478 # &quot;key&quot;: &quot;scope&quot;,
10479 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
10480 # }
10481 {
10482 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
10483 # returned. For example, for warnings where there are no results in a list
10484 # request for a particular zone, this key might be scope and
10485 # the key value might be the zone name. Other examples might be a key
10486 # indicating a deprecated resource and a suggested replacement, or a
10487 # warning about invalid network settings (for example, if an instance
10488 # attempts to perform IP forwarding but is not enabled for IP forwarding).
10489 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
10490 },
10491 ],
10492 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
10493 },
10494 }</pre>
10495 </div>
10496
10497 <div class="method">
10498 <code class="details" id="listErrors">listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
10499 <pre>Lists all errors thrown by actions on instances for a given managed
10500 instance group. The filter and orderBy query
10501 parameters are not supported.
10502
10503 Args:
10504 project: string, Project ID for this request. (required)
10505 zone: string, The name of thezone where the managed
10506 instance group is located.
10507 It should conform to RFC1035. (required)
10508 instanceGroupManager: string, The name of the managed instance group.
10509 It must be a string that meets the requirements in RFC1035, or an
10510 unsigned long integer: must match regexp pattern:
10511 (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. (required)
10512 filter: string, A filter expression that filters resources listed in the response. Most
10513 Compute resources support two types of filter expressions:
10514 expressions that support regular expressions and expressions that follow
10515 API improvement proposal AIP-160.
10516 These two types of filter expressions cannot be mixed in one request.
10517
10518 If you want to use AIP-160, your expression must specify the field name, an
10519 operator, and the value that you want to use for filtering. The value
10520 must be a string, a number, or a boolean. The operator
10521 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
10522
10523 For example, if you are filtering Compute Engine instances, you can
10524 exclude instances named `example-instance` by specifying
10525 `name != example-instance`.
10526
10527 The `:*` comparison can be used to test whether a key has been defined.
10528 For example, to find all objects with `owner` label use:
10529 ```
10530 labels.owner:*
10531 ```
10532
10533 You can also filter nested fields. For example, you could specify
10534 `scheduling.automaticRestart = false` to include instances only
10535 if they are not scheduled for automatic restarts. You can use filtering
10536 on nested fields to filter based onresource labels.
10537
10538 To filter on multiple expressions, provide each separate expression within
10539 parentheses. For example:
10540 ```
10541 (scheduling.automaticRestart = true)
10542 (cpuPlatform = &quot;Intel Skylake&quot;)
10543 ```
10544 By default, each expression is an `AND` expression. However, you
10545 can include `AND` and `OR` expressions explicitly.
10546 For example:
10547 ```
10548 (cpuPlatform = &quot;Intel Skylake&quot;) OR
10549 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
10550 (scheduling.automaticRestart = true)
10551 ```
10552
10553 If you want to use a regular expression, use the `eq` (equal) or `ne`
10554 (not equal) operator against a single un-parenthesized expression with or
10555 without quotes or against multiple parenthesized expressions. Examples:
10556
10557 `fieldname eq unquoted literal`
10558 `fieldname eq &#x27;single quoted literal&#x27;`
10559 `fieldname eq &quot;double quoted literal&quot;`
10560 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
10561
10562 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
10563 The literal value must match the entire field.
10564
10565 For example, to filter for instances that do not end with name &quot;instance&quot;,
10566 you would use `name ne .*instance`.
10567
10568 You cannot combine constraints on multiple fields using regular
10569 expressions.
10570 maxResults: integer, The maximum number of results per page that should be returned.
10571 If the number of available results is larger than `maxResults`,
10572 Compute Engine returns a `nextPageToken` that can be used to get
10573 the next page of results in subsequent list requests. Acceptable values are
10574 `0` to `500`, inclusive. (Default: `500`)
10575 orderBy: string, Sorts list results by a certain order. By default, results
10576 are returned in alphanumerical order based on the resource name.
10577
10578 You can also sort results in descending order based on the creation
10579 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
10580 results based on the `creationTimestamp` field in
10581 reverse chronological order (newest result first). Use this to sort
10582 resources like operations so that the newest operation is returned first.
10583
10584 Currently, only sorting by `name` or
10585 `creationTimestamp desc` is supported.
10586 pageToken: string, Specifies a page token to use. Set `pageToken` to the
10587 `nextPageToken` returned by a previous list request to get
10588 the next page of results.
10589 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
10590 of failure. The default value is false.
10591
10592 For example, when partial success behavior is enabled, aggregatedList for a
10593 single zone scope either returns all resources in the zone or no resources,
10594 with an error code.
10595 x__xgafv: string, V1 error format.
10596 Allowed values
10597 1 - v1 error format
10598 2 - v2 error format
10599
10600 Returns:
10601 An object of the form:
10602
10603 {
10604 &quot;items&quot;: [ # Output only. [Output Only] The list of errors of the managed instance group.
10605 {
10606 &quot;error&quot;: { # Output only. Contents of the error.
10607 &quot;code&quot;: &quot;A String&quot;, # Output only. Error code.
10608 &quot;message&quot;: &quot;A String&quot;, # Output only. Error message.
10609 },
10610 &quot;instanceActionDetails&quot;: { # Output only. Details of the instance action that triggered this error.
10611 # May be null, if the error was not caused by an action on an instance.
10612 # This field is optional.
10613 &quot;action&quot;: &quot;A String&quot;, # Output only. Action that managed instance group was executing on the instance when the
10614 # error occurred. Possible values:
10615 &quot;instance&quot;: &quot;A String&quot;, # Output only. The URL of the instance. The URL can be set even if the instance has not
10616 # yet been created.
10617 &quot;version&quot;: { # Output only. Version this instance was created from, or was being
10618 # created from, but the creation failed. Corresponds to one of the versions
10619 # that were set on the Instance Group Manager resource at the time this
10620 # instance was being created.
10621 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
10622 # when current_action is one of { DELETING, ABANDONING }.
10623 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
10624 },
10625 },
10626 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. The time that this error occurred. This value is in RFC3339 text format.
10627 },
10628 ],
10629 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
10630 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
10631 # the query parameter pageToken in the next list request.
10632 # Subsequent list requests will have their own nextPageToken to
10633 # continue paging through the results.
10634 }</pre>
10635 </div>
10636
10637 <div class="method">
10638 <code class="details" id="listErrors_next">listErrors_next()</code>
10639 <pre>Retrieves the next page of results.
10640
10641 Args:
10642 previous_request: The request for the previous page. (required)
10643 previous_response: The response from the request for the previous page. (required)
10644
10645 Returns:
10646 A request object that you can call &#x27;execute()&#x27; on to request the next
10647 page. Returns None if there are no more items in the collection.
10648 </pre>
10649 </div>
10650
10651 <div class="method">
10652 <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
10653 <pre>Lists all of the instances in the managed instance group. Each instance
10654 in the list has a currentAction, which indicates the action
10655 that the managed instance group is performing on the instance. For example,
10656 if the group is still creating an instance, the currentAction
10657 is CREATING. If a previous action failed, the
10658 list displays the errors for that failed action. The orderBy
10659 query parameter is not supported. The `pageToken` query parameter is
10660 supported only if the group&#x27;s `listManagedInstancesResults` field is set
10661 to `PAGINATED`.
10662
10663 Args:
10664 project: string, Project ID for this request. (required)
10665 zone: string, The name of thezone where the managed
10666 instance group is located. (required)
10667 instanceGroupManager: string, The name of the managed instance group. (required)
10668 filter: string, A filter expression that filters resources listed in the response. Most
10669 Compute resources support two types of filter expressions:
10670 expressions that support regular expressions and expressions that follow
10671 API improvement proposal AIP-160.
10672 These two types of filter expressions cannot be mixed in one request.
10673
10674 If you want to use AIP-160, your expression must specify the field name, an
10675 operator, and the value that you want to use for filtering. The value
10676 must be a string, a number, or a boolean. The operator
10677 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
10678
10679 For example, if you are filtering Compute Engine instances, you can
10680 exclude instances named `example-instance` by specifying
10681 `name != example-instance`.
10682
10683 The `:*` comparison can be used to test whether a key has been defined.
10684 For example, to find all objects with `owner` label use:
10685 ```
10686 labels.owner:*
10687 ```
10688
10689 You can also filter nested fields. For example, you could specify
10690 `scheduling.automaticRestart = false` to include instances only
10691 if they are not scheduled for automatic restarts. You can use filtering
10692 on nested fields to filter based onresource labels.
10693
10694 To filter on multiple expressions, provide each separate expression within
10695 parentheses. For example:
10696 ```
10697 (scheduling.automaticRestart = true)
10698 (cpuPlatform = &quot;Intel Skylake&quot;)
10699 ```
10700 By default, each expression is an `AND` expression. However, you
10701 can include `AND` and `OR` expressions explicitly.
10702 For example:
10703 ```
10704 (cpuPlatform = &quot;Intel Skylake&quot;) OR
10705 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
10706 (scheduling.automaticRestart = true)
10707 ```
10708
10709 If you want to use a regular expression, use the `eq` (equal) or `ne`
10710 (not equal) operator against a single un-parenthesized expression with or
10711 without quotes or against multiple parenthesized expressions. Examples:
10712
10713 `fieldname eq unquoted literal`
10714 `fieldname eq &#x27;single quoted literal&#x27;`
10715 `fieldname eq &quot;double quoted literal&quot;`
10716 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
10717
10718 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
10719 The literal value must match the entire field.
10720
10721 For example, to filter for instances that do not end with name &quot;instance&quot;,
10722 you would use `name ne .*instance`.
10723
10724 You cannot combine constraints on multiple fields using regular
10725 expressions.
10726 maxResults: integer, The maximum number of results per page that should be returned.
10727 If the number of available results is larger than `maxResults`,
10728 Compute Engine returns a `nextPageToken` that can be used to get
10729 the next page of results in subsequent list requests. Acceptable values are
10730 `0` to `500`, inclusive. (Default: `500`)
10731 orderBy: string, Sorts list results by a certain order. By default, results
10732 are returned in alphanumerical order based on the resource name.
10733
10734 You can also sort results in descending order based on the creation
10735 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
10736 results based on the `creationTimestamp` field in
10737 reverse chronological order (newest result first). Use this to sort
10738 resources like operations so that the newest operation is returned first.
10739
10740 Currently, only sorting by `name` or
10741 `creationTimestamp desc` is supported.
10742 pageToken: string, Specifies a page token to use. Set `pageToken` to the
10743 `nextPageToken` returned by a previous list request to get
10744 the next page of results.
10745 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
10746 of failure. The default value is false.
10747
10748 For example, when partial success behavior is enabled, aggregatedList for a
10749 single zone scope either returns all resources in the zone or no resources,
10750 with an error code.
10751 x__xgafv: string, V1 error format.
10752 Allowed values
10753 1 - v1 error format
10754 2 - v2 error format
10755
10756 Returns:
10757 An object of the form:
10758
10759 {
10760 &quot;managedInstances&quot;: [ # Output only. [Output Only] The list of instances in the managed instance group.
10761 { # A Managed Instance resource.
10762 &quot;allInstancesConfig&quot;: { # Output only. [Output Only] Current all-instances configuration revision applied to this
10763 # instance.
10764 &quot;revision&quot;: &quot;A String&quot;, # Output only. [Output Only] Current all-instances configuration revision.
10765 # This value is in RFC3339 text format.
10766 },
10767 &quot;currentAction&quot;: &quot;A String&quot;, # Output only. [Output Only] The current action that the managed instance group has
10768 # scheduled for the instance. Possible values:
10769 #
10770 # - NONE The instance is running, and the managed
10771 # instance group does not have any scheduled actions for this instance.
10772 # - CREATING The managed instance group is creating this
10773 # instance. If the group fails to create this instance, it will try again
10774 # until it is successful.
10775 # - CREATING_WITHOUT_RETRIES The managed instance group
10776 # is attempting to create this instance only once. If the group fails
10777 # to create this instance, it does not try again and the group&#x27;stargetSize value is decreased instead.
10778 # - RECREATING The managed instance group is recreating
10779 # this instance.
10780 # - DELETING The managed instance group is permanently
10781 # deleting this instance.
10782 # - ABANDONING The managed instance group is abandoning
10783 # this instance. The instance will be removed from the instance group
10784 # and from any target pools that are associated with this group.
10785 # - RESTARTING The managed instance group is restarting
10786 # the instance.
10787 # - REFRESHING The managed instance group is applying
10788 # configuration changes to the instance without stopping it. For example,
10789 # the group can update the target pool list for an instance without
10790 # stopping that instance.
10791 # - VERIFYING The managed instance group has created the
10792 # instance and it is in the process of being verified.
10793 &quot;currentActionDetails&quot;: {
10794 &quot;methodName&quot;: &quot;A String&quot;,
10795 &quot;trigger&quot;: &quot;A String&quot;, # Output only. [Output Only] Details of the current action that the managed instance
10796 # group has scheduled for the instance. Contains trigger for the current
10797 # action, and methodName in case it was triggered by API call. Possible
10798 # values for trigger:
10799 #
10800 # - API Any API call.
10801 # - PROACTIVE_UPDATE Proactive updater scheduled an update
10802 # on this managed instance.
10803 # - AUTOSCALING Instance being deleted/created after a
10804 # decision from the Autoscaler.
10805 # - REDISTRIBUTION The regional managed instance group is
10806 # moving instances between zones to restore balance.
10807 # - STANDBY_REFILL The managed instance group is refilling
10808 # the Standby Pool (stopped/suspended virtual machines) after scale
10809 # up.
10810 # - MAINTENANCE Manual maintenance.
10811 # - FAILED_CREATION The managed instance group is handling
10812 # failed instance creation.
10813 # - INSTANCE_FAILURE The managed instance group is handling
10814 # instance failure, according to
10815 # the Instance Lifecycle Policy.
10816 # - FAILED_HEALTH_CHECK The managed instance group is
10817 # handling failed health check, according to the Instance Lifecycle
10818 # Policy.
10819 # - TERMINATION_TIMESTAMP Instance reached termination time,
10820 # thus managed instance group stops/deletes it.
10821 },
10822 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output only] The unique identifier for this resource. This field is empty
10823 # when instance does not exist.
10824 &quot;instance&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of the instance. The URL can exist even if the
10825 # instance has not yet been created.
10826 &quot;instanceFlexibilityOverride&quot;: { # Output only. [Output Only] The overrides to instance properties resulting from
10827 # InstanceFlexibilityPolicy.
10828 &quot;disks&quot;: [ # List of disks to be attached to the instance.
10829 { # An instance-attached disk resource.
10830 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
10831 # or X86_64.
10832 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
10833 # deleted (but not when the disk is detached from the instance).
10834 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
10835 # partition of the disk for its root filesystem.
10836 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
10837 # running within the instance. This name can be used to reference the device
10838 # for mounting, resizing, and so on, from within the instance.
10839 #
10840 # If not specified, the server chooses a default device name to apply to this
10841 # disk, in the form persistent-disk-x, where x is a number
10842 # assigned by Google Compute Engine. This field is only applicable for
10843 # persistent disks.
10844 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
10845 # encryption key.
10846 #
10847 # If you are creating a new disk, this field encrypts the new disk using
10848 # an encryption key that you provide. If you are attaching an existing
10849 # disk that is already encrypted, this field decrypts the disk using
10850 # the customer-supplied encryption key.
10851 #
10852 # If you encrypt a disk using a customer-supplied key, you must provide the
10853 # same key again when you attempt to use this resource at a later time. For
10854 # example, you must provide the key when you create a snapshot or an image
10855 # from the disk or when you attach the disk to a virtual machine instance.
10856 #
10857 # If you do not provide an encryption key, then the disk will be encrypted
10858 # using an automatically generated key and you do not need to provide a key
10859 # to use the disk later.
10860 #
10861 # Note:
10862 #
10863 # Instance templates do not storecustomer-supplied
10864 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
10865 #
10866 # You cannot create VMs that have disks with customer-supplied keys using
10867 # the bulk
10868 # insert method.
10869 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
10870 # For example:
10871 #
10872 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10873 # key_region/cryptoKeys/key
10874 #
10875 # The fully-qualifed key name may be returned for resource GET requests. For
10876 # example:
10877 #
10878 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10879 # key_region/cryptoKeys/key
10880 # /cryptoKeyVersions/1
10881 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
10882 # key. If absent, the Compute Engine default service account is used.
10883 # For example:
10884 #
10885 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
10886 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
10887 # encryption key, encoded in RFC
10888 # 4648 base64 to either encrypt or decrypt this resource. You can
10889 # provide either the rawKey or thersaEncryptedKey.
10890 # For example:
10891 #
10892 # &quot;rawKey&quot;:
10893 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
10894 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
10895 # customer-supplied encryption key to either encrypt or decrypt this
10896 # resource. You can provide either the rawKey or thersaEncryptedKey.
10897 # For example:
10898 #
10899 # &quot;rsaEncryptedKey&quot;:
10900 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
10901 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
10902 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
10903 #
10904 # The key must meet the following requirements before you can provide it to
10905 # Compute Engine:
10906 #
10907 # 1. The key is wrapped using a RSA public key certificate provided by
10908 # Google.
10909 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
10910 # encoding.
10911 #
10912 # Gets the RSA public key certificate provided by Google at:
10913 #
10914 #
10915 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
10916 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
10917 # 4648 base64 encoded SHA-256 hash of the customer-supplied
10918 # encryption key that protects this resource.
10919 },
10920 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
10921 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
10922 # currently attached to another instance. If you try to force attach a zonal
10923 # disk to an instance, you will receive an error.
10924 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
10925 # only for bootable images. Read
10926 # Enabling guest operating system features to see a list of available
10927 # options.
10928 { # Guest OS features.
10929 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
10930 # separate values. Set to one or more of the following values:
10931 #
10932 # - VIRTIO_SCSI_MULTIQUEUE
10933 # - WINDOWS
10934 # - MULTI_IP_SUBNET
10935 # - UEFI_COMPATIBLE
10936 # - GVNIC
10937 # - SEV_CAPABLE
10938 # - SUSPEND_RESUME_COMPATIBLE
10939 # - SEV_LIVE_MIGRATABLE_V2
10940 # - SEV_SNP_CAPABLE
10941 # - TDX_CAPABLE
10942 # - IDPF
10943 # - SNP_SVSM_CAPABLE
10944 # - CCA_CAPABLE
10945 #
10946 #
10947 # For more information, see
10948 # Enabling guest operating system features.
10949 },
10950 ],
10951 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
10952 # boot disk. If you have many disks attached to an instance, each
10953 # disk would have a unique index number.
10954 &quot;initializeParams&quot;: { # [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
10955 # alongside the new instance. Use initialization parameters to create boot
10956 # disks or local SSDs attached to the new instance.
10957 #
10958 # This property is mutually exclusive with the source property;
10959 # you can only define one or the other, but not both.
10960 # alongside the new instance. Use initialization parameters to create boot
10961 # disks or local SSDs attached to the new instance.
10962 #
10963 # This field is persisted and returned for instanceTemplate and not returned
10964 # in the context of instance.
10965 #
10966 # This property is mutually exclusive with the source property;
10967 # you can only define one or the other, but not both.
10968 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
10969 # arm64 or x86_64.
10970 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
10971 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
10972 # of the instance. If a disk with the same name already exists in the given
10973 # region, the existing disk is attached to the new instance and the
10974 # new disk is not created.
10975 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
10976 # 10 GB. If you specify a sourceImage, which is required for
10977 # boot disks, the default size is the size of the sourceImage.
10978 # If you do not specify a sourceImage, the default disk size
10979 # is 500 GB.
10980 &quot;diskType&quot;: &quot;A String&quot;,
10981 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
10982 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
10983 # only for bootable images. Read
10984 # Enabling guest operating system features to see a list of available
10985 # options.
10986 #
10987 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
10988 { # Guest OS features.
10989 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
10990 # separate values. Set to one or more of the following values:
10991 #
10992 # - VIRTIO_SCSI_MULTIQUEUE
10993 # - WINDOWS
10994 # - MULTI_IP_SUBNET
10995 # - UEFI_COMPATIBLE
10996 # - GVNIC
10997 # - SEV_CAPABLE
10998 # - SUSPEND_RESUME_COMPATIBLE
10999 # - SEV_LIVE_MIGRATABLE_V2
11000 # - SEV_SNP_CAPABLE
11001 # - TDX_CAPABLE
11002 # - IDPF
11003 # - SNP_SVSM_CAPABLE
11004 # - CCA_CAPABLE
11005 #
11006 #
11007 # For more information, see
11008 # Enabling guest operating system features.
11009 },
11010 ],
11011 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
11012 # which is either SCSI or NVME. The default isSCSI.
11013 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
11014 # persistent disks.
11015 &quot;a_key&quot;: &quot;A String&quot;,
11016 },
11017 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
11018 # disk.
11019 &quot;A String&quot;,
11020 ],
11021 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
11022 &quot;A String&quot;,
11023 ],
11024 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
11025 # more than one instance.
11026 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
11027 # is to use the existing disk.
11028 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
11029 # of I/O operations per second that the disk can handle. Values must be
11030 # between 10,000 and 120,000. For more details, see theExtreme persistent
11031 # disk documentation.
11032 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
11033 # number of throughput mb per second that the disk can handle. Values must
11034 # greater than or equal to 1.
11035 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
11036 # the URLs of the zones where the disk should be replicated to.
11037 # You must provide exactly two replica zones, and one zone must be the same
11038 # as the instance zone.
11039 &quot;A String&quot;,
11040 ],
11041 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
11042 # have the same definition as resource
11043 # manager tags. Keys and values can be either in numeric format,
11044 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
11045 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
11046 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
11047 # empty.
11048 &quot;a_key&quot;: &quot;A String&quot;,
11049 },
11050 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
11051 # Specified using the full or partial URL. For instance template, specify
11052 # only the resource policy name.
11053 &quot;A String&quot;,
11054 ],
11055 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
11056 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
11057 # is required.
11058 #
11059 # To create a disk with one of the public operating system
11060 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
11061 #
11062 # projects/debian-cloud/global/images/family/debian-9
11063 #
11064 #
11065 # Alternatively, use a specific version of a public operating system image:
11066 #
11067 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
11068 #
11069 #
11070 # To create a disk with a custom image that you created, specify the
11071 # image name in the following format:
11072 #
11073 # global/images/my-custom-image
11074 #
11075 #
11076 # You can also specify a custom image by its image family, which returns
11077 # the latest version of the image in that family. Replace the image name
11078 # with family/family-name:
11079 #
11080 # global/images/family/my-image-family
11081 #
11082 #
11083 # If the source image is deleted later, this field will not be set.
11084 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
11085 # encryption key of the source image. Required if the source image is
11086 # protected by a customer-supplied encryption key.
11087 #
11088 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
11089 # encryption keys, so you cannot create disks for instances in a managed instance group if the
11090 # source images are encrypted with your own keys.
11091 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11092 # For example:
11093 #
11094 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11095 # key_region/cryptoKeys/key
11096 #
11097 # The fully-qualifed key name may be returned for resource GET requests. For
11098 # example:
11099 #
11100 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11101 # key_region/cryptoKeys/key
11102 # /cryptoKeyVersions/1
11103 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11104 # key. If absent, the Compute Engine default service account is used.
11105 # For example:
11106 #
11107 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11108 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11109 # encryption key, encoded in RFC
11110 # 4648 base64 to either encrypt or decrypt this resource. You can
11111 # provide either the rawKey or thersaEncryptedKey.
11112 # For example:
11113 #
11114 # &quot;rawKey&quot;:
11115 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11116 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11117 # customer-supplied encryption key to either encrypt or decrypt this
11118 # resource. You can provide either the rawKey or thersaEncryptedKey.
11119 # For example:
11120 #
11121 # &quot;rsaEncryptedKey&quot;:
11122 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11123 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11124 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11125 #
11126 # The key must meet the following requirements before you can provide it to
11127 # Compute Engine:
11128 #
11129 # 1. The key is wrapped using a RSA public key certificate provided by
11130 # Google.
11131 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11132 # encoding.
11133 #
11134 # Gets the RSA public key certificate provided by Google at:
11135 #
11136 #
11137 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11138 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11139 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11140 # encryption key that protects this resource.
11141 },
11142 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
11143 # instance boot disk, one of initializeParams.sourceSnapshot
11144 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
11145 # is required.
11146 #
11147 # To create a disk with a snapshot that you created, specify the
11148 # snapshot name in the following format:
11149 #
11150 # us-central1-a/instantSnapshots/my-backup
11151 #
11152 #
11153 # If the source instant-snapshot is deleted later, this field will not be
11154 # set.
11155 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
11156 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
11157 # is required.
11158 #
11159 # To create a disk with a snapshot that you created, specify the
11160 # snapshot name in the following format:
11161 #
11162 # global/snapshots/my-backup
11163 #
11164 #
11165 # If the source snapshot is deleted later, this field will not be set.
11166 #
11167 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
11168 # an image instead when you create VMs using
11169 # the bulk
11170 # insert method.
11171 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
11172 # encryption key of the source snapshot.
11173 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11174 # For example:
11175 #
11176 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11177 # key_region/cryptoKeys/key
11178 #
11179 # The fully-qualifed key name may be returned for resource GET requests. For
11180 # example:
11181 #
11182 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11183 # key_region/cryptoKeys/key
11184 # /cryptoKeyVersions/1
11185 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11186 # key. If absent, the Compute Engine default service account is used.
11187 # For example:
11188 #
11189 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11190 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11191 # encryption key, encoded in RFC
11192 # 4648 base64 to either encrypt or decrypt this resource. You can
11193 # provide either the rawKey or thersaEncryptedKey.
11194 # For example:
11195 #
11196 # &quot;rawKey&quot;:
11197 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11198 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11199 # customer-supplied encryption key to either encrypt or decrypt this
11200 # resource. You can provide either the rawKey or thersaEncryptedKey.
11201 # For example:
11202 #
11203 # &quot;rsaEncryptedKey&quot;:
11204 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11205 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11206 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11207 #
11208 # The key must meet the following requirements before you can provide it to
11209 # Compute Engine:
11210 #
11211 # 1. The key is wrapped using a RSA public key certificate provided by
11212 # Google.
11213 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11214 # encoding.
11215 #
11216 # Gets the RSA public key certificate provided by Google at:
11217 #
11218 #
11219 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11220 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11221 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11222 # encryption key that protects this resource.
11223 },
11224 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
11225 # this as a partial or full URL to the resource. For example, the following
11226 # are valid values:
11227 #
11228 #
11229 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
11230 # - projects/project/zones/zone/storagePools/storagePool
11231 # - zones/zone/storagePools/storagePool
11232 },
11233 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
11234 # either SCSI or NVME. For most machine types, the
11235 # default is SCSI. Local SSDs can use either NVME or SCSI.
11236 # In certain configurations, persistent disks can use NVMe. For more
11237 # information, seeAbout
11238 # persistent disks.
11239 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
11240 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
11241 &quot;A String&quot;,
11242 ],
11243 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
11244 # disk is not allowed to be detached from the instance, or to be used as the
11245 # source of the snapshot creation, and the image creation. The instance with
11246 # at least one locked attached disk is not allow to be used as source of
11247 # machine image creation, instant snapshot creation, and not allowed to be
11248 # deleted with --keep-disk parameter set to true for locked disks.
11249 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
11250 # in READ_WRITE mode.
11251 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
11252 # field is set to PRESERVED if the LocalSSD data has been saved
11253 # to a persistent location by customer request. (see the
11254 # discard_local_ssd option on Stop/Suspend).
11255 # Read-only in the api.
11256 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
11257 # these are public keys which are safe to store in public
11258 &quot;dbs&quot;: [ # The Key Database (db).
11259 {
11260 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11261 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11262 },
11263 ],
11264 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
11265 {
11266 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11267 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11268 },
11269 ],
11270 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
11271 {
11272 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11273 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11274 },
11275 ],
11276 &quot;pk&quot;: { # The Platform Key (PK).
11277 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11278 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11279 },
11280 },
11281 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
11282 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
11283 # is required.
11284 #
11285 # If desired, you can also attach existing non-root persistent disks using
11286 # this property. This field is only applicable for persistent disks.
11287 #
11288 # Note that for InstanceTemplate, specify the disk name for zonal disk,
11289 # and the URL for regional disk.
11290 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
11291 },
11292 ],
11293 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to be used for this instance.
11294 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance.
11295 # e.g. &#x27;Intel Ice Lake&#x27;.
11296 &quot;provisioningModel&quot;: &quot;A String&quot;, # The provisioning model to be used for this instance.
11297 },
11298 &quot;instanceHealth&quot;: [ # Output only. [Output Only] Health state of the instance per health-check.
11299 {
11300 &quot;detailedHealthState&quot;: &quot;A String&quot;, # Output only. [Output Only] The current detailed instance health state.
11301 &quot;healthCheck&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for the health check that verifies whether the
11302 # instance is healthy.
11303 &quot;healthState&quot;: &quot;A String&quot;, # Output only. [Output Only] The current instance health state.
11304 # This field will not get promoted to beta/GA and might be removed from
11305 # alpha APIs after 01/12/2019. Please use detailed_health_state field
11306 # instead.
11307 },
11308 ],
11309 &quot;instanceStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the instance. This field is empty when
11310 # the instance does not exist.
11311 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
11312 # when current_action is one of { DELETING, ABANDONING }.
11313 &quot;lastAttempt&quot;: { # Output only. [Output Only] Information about the last attempt to create or delete
11314 # the instance.
11315 &quot;errors&quot;: { # Output only. [Output Only] Encountered errors during the last attempt to create or
11316 # delete the instance.
11317 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11318 # operation.
11319 {
11320 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11321 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11322 # details. There is a set of defined message types to use for providing
11323 # details.The syntax depends on the error code. For example,
11324 # QuotaExceededInfo will have details when the error code is
11325 # QUOTA_EXCEEDED.
11326 {
11327 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11328 #
11329 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11330 # is not enabled:
11331 #
11332 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11333 # &quot;domain&quot;: &quot;googleapis.com&quot;
11334 # &quot;metadata&quot;: {
11335 # &quot;resource&quot;: &quot;projects/123&quot;,
11336 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11337 # }
11338 # }
11339 #
11340 # This response indicates that the pubsub.googleapis.com API is not enabled.
11341 #
11342 # Example of an error that is returned when attempting to create a Spanner
11343 # instance in a region that is out of stock:
11344 #
11345 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11346 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11347 # &quot;metadata&quot;: {
11348 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11349 # }
11350 # }
11351 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11352 # is typically the registered service name of the tool or product that
11353 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11354 # generated by some common infrastructure, the error domain must be a
11355 # globally unique value that identifies the infrastructure. For Google API
11356 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11357 &quot;metadatas&quot;: { # Additional structured details about this error.
11358 #
11359 # Keys must match a regular expression of `a-z+` but should
11360 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11361 # length. When identifying the current value of an exceeded limit, the units
11362 # should be contained in the key, not the value. For example, rather than
11363 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11364 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11365 # instances that can be created in a single (batch) request.
11366 &quot;a_key&quot;: &quot;A String&quot;,
11367 },
11368 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11369 # proximate cause of the error. Error reasons are unique within a particular
11370 # domain of errors. This should be at most 63 characters and match a
11371 # regular expression of `A-Z+[A-Z0-9]`, which represents
11372 # UPPER_SNAKE_CASE.
11373 },
11374 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11375 #
11376 # For example, if a quota check failed with an error indicating the calling
11377 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11378 # directly to the right place in the developer console to flip the bit.
11379 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11380 { # Describes a URL link.
11381 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11382 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11383 },
11384 ],
11385 },
11386 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11387 # which can be attached to an RPC error.
11388 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11389 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11390 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11391 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11392 },
11393 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11394 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11395 &quot;a_key&quot;: &quot;A String&quot;,
11396 },
11397 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11398 # type or metric.
11399 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11400 # or metric.
11401 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11402 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11403 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11404 },
11405 },
11406 ],
11407 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11408 # This property is optional.
11409 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11410 },
11411 ],
11412 },
11413 },
11414 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of the instance. The name always exists even if the
11415 # instance has not yet been created.
11416 &quot;preservedStateFromConfig&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state applied from per-instance config
11417 # for this instance.
11418 &quot;disks&quot;: { # Preserved disks defined for this instance.
11419 # This map is keyed with the device names of the disks.
11420 &quot;a_key&quot;: {
11421 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
11422 # update, instance recreate operations. This flag is used to configure
11423 # if the disk should be deleted after it is no longer used by the group,
11424 # e.g. when the given instance or the whole MIG is deleted.
11425 # Note: disks attached in READ_ONLY mode cannot be
11426 # auto-deleted.
11427 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
11428 # disk in READ_WRITE mode.
11429 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
11430 # to the VM instance.
11431 },
11432 },
11433 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
11434 # This map is keyed with the name of the network interface.
11435 &quot;a_key&quot;: {
11436 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11437 # update or VM instance recreate operations.
11438 # This flag is used to configure if the IP reservation should be deleted
11439 # after it is no longer used by the group, e.g. when the given instance
11440 # or the whole group is deleted.
11441 &quot;ipAddress&quot;: { # Ip address representation
11442 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
11443 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
11444 # network interface.
11445 },
11446 },
11447 },
11448 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
11449 # This map is keyed with the name of the network interface.
11450 &quot;a_key&quot;: {
11451 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11452 # update or VM instance recreate operations.
11453 # This flag is used to configure if the IP reservation should be deleted
11454 # after it is no longer used by the group, e.g. when the given instance
11455 # or the whole group is deleted.
11456 &quot;ipAddress&quot;: { # Ip address representation
11457 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
11458 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
11459 # network interface.
11460 },
11461 },
11462 },
11463 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
11464 &quot;a_key&quot;: &quot;A String&quot;,
11465 },
11466 },
11467 &quot;preservedStateFromPolicy&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state generated based on stateful policy
11468 # for this instance.
11469 &quot;disks&quot;: { # Preserved disks defined for this instance.
11470 # This map is keyed with the device names of the disks.
11471 &quot;a_key&quot;: {
11472 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
11473 # update, instance recreate operations. This flag is used to configure
11474 # if the disk should be deleted after it is no longer used by the group,
11475 # e.g. when the given instance or the whole MIG is deleted.
11476 # Note: disks attached in READ_ONLY mode cannot be
11477 # auto-deleted.
11478 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
11479 # disk in READ_WRITE mode.
11480 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
11481 # to the VM instance.
11482 },
11483 },
11484 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
11485 # This map is keyed with the name of the network interface.
11486 &quot;a_key&quot;: {
11487 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11488 # update or VM instance recreate operations.
11489 # This flag is used to configure if the IP reservation should be deleted
11490 # after it is no longer used by the group, e.g. when the given instance
11491 # or the whole group is deleted.
11492 &quot;ipAddress&quot;: { # Ip address representation
11493 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
11494 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
11495 # network interface.
11496 },
11497 },
11498 },
11499 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
11500 # This map is keyed with the name of the network interface.
11501 &quot;a_key&quot;: {
11502 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11503 # update or VM instance recreate operations.
11504 # This flag is used to configure if the IP reservation should be deleted
11505 # after it is no longer used by the group, e.g. when the given instance
11506 # or the whole group is deleted.
11507 &quot;ipAddress&quot;: { # Ip address representation
11508 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
11509 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
11510 # network interface.
11511 },
11512 },
11513 },
11514 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
11515 &quot;a_key&quot;: &quot;A String&quot;,
11516 },
11517 },
11518 &quot;propertiesFromFlexibilityPolicy&quot;: { # Output only. [Output Only] Instance properties selected for this instance resulting from
11519 # InstanceFlexibilityPolicy.
11520 &quot;disks&quot;: [ # List of disks to be attached to the instance.
11521 { # An instance-attached disk resource.
11522 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
11523 # or X86_64.
11524 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
11525 # deleted (but not when the disk is detached from the instance).
11526 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
11527 # partition of the disk for its root filesystem.
11528 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
11529 # running within the instance. This name can be used to reference the device
11530 # for mounting, resizing, and so on, from within the instance.
11531 #
11532 # If not specified, the server chooses a default device name to apply to this
11533 # disk, in the form persistent-disk-x, where x is a number
11534 # assigned by Google Compute Engine. This field is only applicable for
11535 # persistent disks.
11536 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
11537 # encryption key.
11538 #
11539 # If you are creating a new disk, this field encrypts the new disk using
11540 # an encryption key that you provide. If you are attaching an existing
11541 # disk that is already encrypted, this field decrypts the disk using
11542 # the customer-supplied encryption key.
11543 #
11544 # If you encrypt a disk using a customer-supplied key, you must provide the
11545 # same key again when you attempt to use this resource at a later time. For
11546 # example, you must provide the key when you create a snapshot or an image
11547 # from the disk or when you attach the disk to a virtual machine instance.
11548 #
11549 # If you do not provide an encryption key, then the disk will be encrypted
11550 # using an automatically generated key and you do not need to provide a key
11551 # to use the disk later.
11552 #
11553 # Note:
11554 #
11555 # Instance templates do not storecustomer-supplied
11556 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
11557 #
11558 # You cannot create VMs that have disks with customer-supplied keys using
11559 # the bulk
11560 # insert method.
11561 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11562 # For example:
11563 #
11564 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11565 # key_region/cryptoKeys/key
11566 #
11567 # The fully-qualifed key name may be returned for resource GET requests. For
11568 # example:
11569 #
11570 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11571 # key_region/cryptoKeys/key
11572 # /cryptoKeyVersions/1
11573 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11574 # key. If absent, the Compute Engine default service account is used.
11575 # For example:
11576 #
11577 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11578 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11579 # encryption key, encoded in RFC
11580 # 4648 base64 to either encrypt or decrypt this resource. You can
11581 # provide either the rawKey or thersaEncryptedKey.
11582 # For example:
11583 #
11584 # &quot;rawKey&quot;:
11585 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11586 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11587 # customer-supplied encryption key to either encrypt or decrypt this
11588 # resource. You can provide either the rawKey or thersaEncryptedKey.
11589 # For example:
11590 #
11591 # &quot;rsaEncryptedKey&quot;:
11592 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11593 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11594 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11595 #
11596 # The key must meet the following requirements before you can provide it to
11597 # Compute Engine:
11598 #
11599 # 1. The key is wrapped using a RSA public key certificate provided by
11600 # Google.
11601 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11602 # encoding.
11603 #
11604 # Gets the RSA public key certificate provided by Google at:
11605 #
11606 #
11607 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11608 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11609 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11610 # encryption key that protects this resource.
11611 },
11612 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
11613 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
11614 # currently attached to another instance. If you try to force attach a zonal
11615 # disk to an instance, you will receive an error.
11616 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
11617 # only for bootable images. Read
11618 # Enabling guest operating system features to see a list of available
11619 # options.
11620 { # Guest OS features.
11621 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
11622 # separate values. Set to one or more of the following values:
11623 #
11624 # - VIRTIO_SCSI_MULTIQUEUE
11625 # - WINDOWS
11626 # - MULTI_IP_SUBNET
11627 # - UEFI_COMPATIBLE
11628 # - GVNIC
11629 # - SEV_CAPABLE
11630 # - SUSPEND_RESUME_COMPATIBLE
11631 # - SEV_LIVE_MIGRATABLE_V2
11632 # - SEV_SNP_CAPABLE
11633 # - TDX_CAPABLE
11634 # - IDPF
11635 # - SNP_SVSM_CAPABLE
11636 # - CCA_CAPABLE
11637 #
11638 #
11639 # For more information, see
11640 # Enabling guest operating system features.
11641 },
11642 ],
11643 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
11644 # boot disk. If you have many disks attached to an instance, each
11645 # disk would have a unique index number.
11646 &quot;initializeParams&quot;: { # [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
11647 # alongside the new instance. Use initialization parameters to create boot
11648 # disks or local SSDs attached to the new instance.
11649 #
11650 # This property is mutually exclusive with the source property;
11651 # you can only define one or the other, but not both.
11652 # alongside the new instance. Use initialization parameters to create boot
11653 # disks or local SSDs attached to the new instance.
11654 #
11655 # This field is persisted and returned for instanceTemplate and not returned
11656 # in the context of instance.
11657 #
11658 # This property is mutually exclusive with the source property;
11659 # you can only define one or the other, but not both.
11660 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
11661 # arm64 or x86_64.
11662 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
11663 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
11664 # of the instance. If a disk with the same name already exists in the given
11665 # region, the existing disk is attached to the new instance and the
11666 # new disk is not created.
11667 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
11668 # 10 GB. If you specify a sourceImage, which is required for
11669 # boot disks, the default size is the size of the sourceImage.
11670 # If you do not specify a sourceImage, the default disk size
11671 # is 500 GB.
11672 &quot;diskType&quot;: &quot;A String&quot;,
11673 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
11674 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
11675 # only for bootable images. Read
11676 # Enabling guest operating system features to see a list of available
11677 # options.
11678 #
11679 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
11680 { # Guest OS features.
11681 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
11682 # separate values. Set to one or more of the following values:
11683 #
11684 # - VIRTIO_SCSI_MULTIQUEUE
11685 # - WINDOWS
11686 # - MULTI_IP_SUBNET
11687 # - UEFI_COMPATIBLE
11688 # - GVNIC
11689 # - SEV_CAPABLE
11690 # - SUSPEND_RESUME_COMPATIBLE
11691 # - SEV_LIVE_MIGRATABLE_V2
11692 # - SEV_SNP_CAPABLE
11693 # - TDX_CAPABLE
11694 # - IDPF
11695 # - SNP_SVSM_CAPABLE
11696 # - CCA_CAPABLE
11697 #
11698 #
11699 # For more information, see
11700 # Enabling guest operating system features.
11701 },
11702 ],
11703 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
11704 # which is either SCSI or NVME. The default isSCSI.
11705 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
11706 # persistent disks.
11707 &quot;a_key&quot;: &quot;A String&quot;,
11708 },
11709 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
11710 # disk.
11711 &quot;A String&quot;,
11712 ],
11713 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
11714 &quot;A String&quot;,
11715 ],
11716 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
11717 # more than one instance.
11718 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
11719 # is to use the existing disk.
11720 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
11721 # of I/O operations per second that the disk can handle. Values must be
11722 # between 10,000 and 120,000. For more details, see theExtreme persistent
11723 # disk documentation.
11724 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
11725 # number of throughput mb per second that the disk can handle. Values must
11726 # greater than or equal to 1.
11727 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
11728 # the URLs of the zones where the disk should be replicated to.
11729 # You must provide exactly two replica zones, and one zone must be the same
11730 # as the instance zone.
11731 &quot;A String&quot;,
11732 ],
11733 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
11734 # have the same definition as resource
11735 # manager tags. Keys and values can be either in numeric format,
11736 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
11737 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
11738 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
11739 # empty.
11740 &quot;a_key&quot;: &quot;A String&quot;,
11741 },
11742 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
11743 # Specified using the full or partial URL. For instance template, specify
11744 # only the resource policy name.
11745 &quot;A String&quot;,
11746 ],
11747 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
11748 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
11749 # is required.
11750 #
11751 # To create a disk with one of the public operating system
11752 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
11753 #
11754 # projects/debian-cloud/global/images/family/debian-9
11755 #
11756 #
11757 # Alternatively, use a specific version of a public operating system image:
11758 #
11759 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
11760 #
11761 #
11762 # To create a disk with a custom image that you created, specify the
11763 # image name in the following format:
11764 #
11765 # global/images/my-custom-image
11766 #
11767 #
11768 # You can also specify a custom image by its image family, which returns
11769 # the latest version of the image in that family. Replace the image name
11770 # with family/family-name:
11771 #
11772 # global/images/family/my-image-family
11773 #
11774 #
11775 # If the source image is deleted later, this field will not be set.
11776 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
11777 # encryption key of the source image. Required if the source image is
11778 # protected by a customer-supplied encryption key.
11779 #
11780 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
11781 # encryption keys, so you cannot create disks for instances in a managed instance group if the
11782 # source images are encrypted with your own keys.
11783 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11784 # For example:
11785 #
11786 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11787 # key_region/cryptoKeys/key
11788 #
11789 # The fully-qualifed key name may be returned for resource GET requests. For
11790 # example:
11791 #
11792 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11793 # key_region/cryptoKeys/key
11794 # /cryptoKeyVersions/1
11795 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11796 # key. If absent, the Compute Engine default service account is used.
11797 # For example:
11798 #
11799 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11800 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11801 # encryption key, encoded in RFC
11802 # 4648 base64 to either encrypt or decrypt this resource. You can
11803 # provide either the rawKey or thersaEncryptedKey.
11804 # For example:
11805 #
11806 # &quot;rawKey&quot;:
11807 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11808 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11809 # customer-supplied encryption key to either encrypt or decrypt this
11810 # resource. You can provide either the rawKey or thersaEncryptedKey.
11811 # For example:
11812 #
11813 # &quot;rsaEncryptedKey&quot;:
11814 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11815 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11816 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11817 #
11818 # The key must meet the following requirements before you can provide it to
11819 # Compute Engine:
11820 #
11821 # 1. The key is wrapped using a RSA public key certificate provided by
11822 # Google.
11823 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11824 # encoding.
11825 #
11826 # Gets the RSA public key certificate provided by Google at:
11827 #
11828 #
11829 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11830 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11831 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11832 # encryption key that protects this resource.
11833 },
11834 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
11835 # instance boot disk, one of initializeParams.sourceSnapshot
11836 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
11837 # is required.
11838 #
11839 # To create a disk with a snapshot that you created, specify the
11840 # snapshot name in the following format:
11841 #
11842 # us-central1-a/instantSnapshots/my-backup
11843 #
11844 #
11845 # If the source instant-snapshot is deleted later, this field will not be
11846 # set.
11847 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
11848 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
11849 # is required.
11850 #
11851 # To create a disk with a snapshot that you created, specify the
11852 # snapshot name in the following format:
11853 #
11854 # global/snapshots/my-backup
11855 #
11856 #
11857 # If the source snapshot is deleted later, this field will not be set.
11858 #
11859 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
11860 # an image instead when you create VMs using
11861 # the bulk
11862 # insert method.
11863 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
11864 # encryption key of the source snapshot.
11865 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11866 # For example:
11867 #
11868 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11869 # key_region/cryptoKeys/key
11870 #
11871 # The fully-qualifed key name may be returned for resource GET requests. For
11872 # example:
11873 #
11874 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11875 # key_region/cryptoKeys/key
11876 # /cryptoKeyVersions/1
11877 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11878 # key. If absent, the Compute Engine default service account is used.
11879 # For example:
11880 #
11881 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11882 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11883 # encryption key, encoded in RFC
11884 # 4648 base64 to either encrypt or decrypt this resource. You can
11885 # provide either the rawKey or thersaEncryptedKey.
11886 # For example:
11887 #
11888 # &quot;rawKey&quot;:
11889 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11890 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11891 # customer-supplied encryption key to either encrypt or decrypt this
11892 # resource. You can provide either the rawKey or thersaEncryptedKey.
11893 # For example:
11894 #
11895 # &quot;rsaEncryptedKey&quot;:
11896 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11897 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11898 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11899 #
11900 # The key must meet the following requirements before you can provide it to
11901 # Compute Engine:
11902 #
11903 # 1. The key is wrapped using a RSA public key certificate provided by
11904 # Google.
11905 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11906 # encoding.
11907 #
11908 # Gets the RSA public key certificate provided by Google at:
11909 #
11910 #
11911 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11912 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11913 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11914 # encryption key that protects this resource.
11915 },
11916 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
11917 # this as a partial or full URL to the resource. For example, the following
11918 # are valid values:
11919 #
11920 #
11921 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
11922 # - projects/project/zones/zone/storagePools/storagePool
11923 # - zones/zone/storagePools/storagePool
11924 },
11925 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
11926 # either SCSI or NVME. For most machine types, the
11927 # default is SCSI. Local SSDs can use either NVME or SCSI.
11928 # In certain configurations, persistent disks can use NVMe. For more
11929 # information, seeAbout
11930 # persistent disks.
11931 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
11932 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
11933 &quot;A String&quot;,
11934 ],
11935 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
11936 # disk is not allowed to be detached from the instance, or to be used as the
11937 # source of the snapshot creation, and the image creation. The instance with
11938 # at least one locked attached disk is not allow to be used as source of
11939 # machine image creation, instant snapshot creation, and not allowed to be
11940 # deleted with --keep-disk parameter set to true for locked disks.
11941 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
11942 # in READ_WRITE mode.
11943 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
11944 # field is set to PRESERVED if the LocalSSD data has been saved
11945 # to a persistent location by customer request. (see the
11946 # discard_local_ssd option on Stop/Suspend).
11947 # Read-only in the api.
11948 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
11949 # these are public keys which are safe to store in public
11950 &quot;dbs&quot;: [ # The Key Database (db).
11951 {
11952 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11953 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11954 },
11955 ],
11956 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
11957 {
11958 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11959 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11960 },
11961 ],
11962 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
11963 {
11964 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11965 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11966 },
11967 ],
11968 &quot;pk&quot;: { # The Platform Key (PK).
11969 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11970 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11971 },
11972 },
11973 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
11974 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
11975 # is required.
11976 #
11977 # If desired, you can also attach existing non-root persistent disks using
11978 # this property. This field is only applicable for persistent disks.
11979 #
11980 # Note that for InstanceTemplate, specify the disk name for zonal disk,
11981 # and the URL for regional disk.
11982 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
11983 },
11984 ],
11985 &quot;machineType&quot;: &quot;A String&quot;, # Output only. The machine type to be used for this instance.
11986 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance.
11987 # e.g. &#x27;Intel Ice Lake&#x27;.
11988 &quot;provisioningModel&quot;: &quot;A String&quot;, # Output only. The provisioning model to be used for this instance.
11989 },
11990 &quot;scheduling&quot;: { # Output only. [Output Only] Information about the termination timestamp of the instance,
11991 # if applicable.
11992 &quot;gracefulShutdownTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the underlying instance will be
11993 # triggered for graceful shutdown if it is configured. This is in RFC3339 text format.
11994 &quot;terminationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the managed instance will be
11995 # terminated. This is in RFC3339 text format.
11996 },
11997 &quot;shutdownDetails&quot;: { # Output only. [Output Only] Specifies the graceful shutdown details if the instance is in
11998 # `PENDING_STOP` state or there is a programmed stop scheduled.
11999 &quot;maxDuration&quot;: { # A Duration represents a fixed-length span of time represented # Output only. [Output Only] The duration for graceful shutdown. Only applicable when
12000 # the instance is in `PENDING_STOP` state.
12001 # as a count of seconds and fractions of seconds at nanosecond
12002 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
12003 # or &quot;month&quot;. Range is approximately 10,000 years.
12004 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
12005 # Durations less than one second are represented with a 0
12006 # `seconds` field and a positive `nanos` field. Must be from 0
12007 # to 999,999,999 inclusive.
12008 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
12009 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
12010 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
12011 },
12012 &quot;requestTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Past timestamp indicating the beginning of `PENDING_STOP`
12013 # state of instance in RFC3339 text format.
12014 },
12015 &quot;sizeInUnit&quot;: 3.14, # Output only. [Output only] The size of the VM represented by this Managed Instance.
12016 # This is how much this Managed Instance contributes to the
12017 # size of the group.
12018 &quot;tag&quot;: &quot;A String&quot;, # Output only. [Output Only] Tag describing the version.
12019 &quot;targetStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The eventual status of the instance. The instance group
12020 # manager will not be identified as stable till each managed instance reaches
12021 # its targetStatus.
12022 &quot;version&quot;: { # Output only. [Output Only] Intended version of this instance.
12023 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
12024 # when current_action is one of { DELETING, ABANDONING }.
12025 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
12026 },
12027 },
12028 ],
12029 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
12030 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
12031 # the query parameter pageToken in the next list request.
12032 # Subsequent list requests will have their own nextPageToken to
12033 # continue paging through the results.
12034 }</pre>
12035 </div>
12036
12037 <div class="method">
12038 <code class="details" id="listManagedInstances_next">listManagedInstances_next()</code>
12039 <pre>Retrieves the next page of results.
12040
12041 Args:
12042 previous_request: The request for the previous page. (required)
12043 previous_response: The response from the request for the previous page. (required)
12044
12045 Returns:
12046 A request object that you can call &#x27;execute()&#x27; on to request the next
12047 page. Returns None if there are no more items in the collection.
12048 </pre>
12049 </div>
12050
12051 <div class="method">
12052 <code class="details" id="listPerInstanceConfigs">listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
12053 <pre>Lists all of the per-instance configurations defined for the managed
12054 instance group. The orderBy query parameter is not supported.
12055
12056 Args:
12057 project: string, Project ID for this request. (required)
12058 zone: string, The name of thezone
12059 where the managed instance group is located.
12060 It should conform to RFC1035. (required)
12061 instanceGroupManager: string, The name of the managed instance group. It should conform to RFC1035. (required)
12062 filter: string, A filter expression that filters resources listed in the response. Most
12063 Compute resources support two types of filter expressions:
12064 expressions that support regular expressions and expressions that follow
12065 API improvement proposal AIP-160.
12066 These two types of filter expressions cannot be mixed in one request.
12067
12068 If you want to use AIP-160, your expression must specify the field name, an
12069 operator, and the value that you want to use for filtering. The value
12070 must be a string, a number, or a boolean. The operator
12071 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
12072
12073 For example, if you are filtering Compute Engine instances, you can
12074 exclude instances named `example-instance` by specifying
12075 `name != example-instance`.
12076
12077 The `:*` comparison can be used to test whether a key has been defined.
12078 For example, to find all objects with `owner` label use:
12079 ```
12080 labels.owner:*
12081 ```
12082
12083 You can also filter nested fields. For example, you could specify
12084 `scheduling.automaticRestart = false` to include instances only
12085 if they are not scheduled for automatic restarts. You can use filtering
12086 on nested fields to filter based onresource labels.
12087
12088 To filter on multiple expressions, provide each separate expression within
12089 parentheses. For example:
12090 ```
12091 (scheduling.automaticRestart = true)
12092 (cpuPlatform = &quot;Intel Skylake&quot;)
12093 ```
12094 By default, each expression is an `AND` expression. However, you
12095 can include `AND` and `OR` expressions explicitly.
12096 For example:
12097 ```
12098 (cpuPlatform = &quot;Intel Skylake&quot;) OR
12099 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
12100 (scheduling.automaticRestart = true)
12101 ```
12102
12103 If you want to use a regular expression, use the `eq` (equal) or `ne`
12104 (not equal) operator against a single un-parenthesized expression with or
12105 without quotes or against multiple parenthesized expressions. Examples:
12106
12107 `fieldname eq unquoted literal`
12108 `fieldname eq &#x27;single quoted literal&#x27;`
12109 `fieldname eq &quot;double quoted literal&quot;`
12110 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
12111
12112 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
12113 The literal value must match the entire field.
12114
12115 For example, to filter for instances that do not end with name &quot;instance&quot;,
12116 you would use `name ne .*instance`.
12117
12118 You cannot combine constraints on multiple fields using regular
12119 expressions.
12120 maxResults: integer, The maximum number of results per page that should be returned.
12121 If the number of available results is larger than `maxResults`,
12122 Compute Engine returns a `nextPageToken` that can be used to get
12123 the next page of results in subsequent list requests. Acceptable values are
12124 `0` to `500`, inclusive. (Default: `500`)
12125 orderBy: string, Sorts list results by a certain order. By default, results
12126 are returned in alphanumerical order based on the resource name.
12127
12128 You can also sort results in descending order based on the creation
12129 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
12130 results based on the `creationTimestamp` field in
12131 reverse chronological order (newest result first). Use this to sort
12132 resources like operations so that the newest operation is returned first.
12133
12134 Currently, only sorting by `name` or
12135 `creationTimestamp desc` is supported.
12136 pageToken: string, Specifies a page token to use. Set `pageToken` to the
12137 `nextPageToken` returned by a previous list request to get
12138 the next page of results.
12139 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
12140 of failure. The default value is false.
12141
12142 For example, when partial success behavior is enabled, aggregatedList for a
12143 single zone scope either returns all resources in the zone or no resources,
12144 with an error code.
12145 x__xgafv: string, V1 error format.
12146 Allowed values
12147 1 - v1 error format
12148 2 - v2 error format
12149
12150 Returns:
12151 An object of the form:
12152
12153 {
12154 &quot;items&quot;: [ # Output only. [Output Only] The list of PerInstanceConfig.
12155 {
12156 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
12157 # optimistic locking. It is ignored when inserting a per-instance
12158 # config. An up-to-date fingerprint must be provided in order to update an
12159 # existing per-instance configuration or the field needs to be unset.
12160 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
12161 # Serves as a merge key during UpdatePerInstanceConfigs
12162 # operations, that is, if a per-instance configuration with the same name
12163 # exists then it will be updated, otherwise a new one will be created for the
12164 # VM instance with the same name. An attempt to create a per-instance
12165 # configuration for a VM instance that either doesn&#x27;t exist or is not part
12166 # of the group will result in an error.
12167 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
12168 # preserved state generated from a stateful policy.
12169 &quot;disks&quot;: { # Preserved disks defined for this instance.
12170 # This map is keyed with the device names of the disks.
12171 &quot;a_key&quot;: {
12172 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
12173 # update, instance recreate operations. This flag is used to configure
12174 # if the disk should be deleted after it is no longer used by the group,
12175 # e.g. when the given instance or the whole MIG is deleted.
12176 # Note: disks attached in READ_ONLY mode cannot be
12177 # auto-deleted.
12178 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
12179 # disk in READ_WRITE mode.
12180 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
12181 # to the VM instance.
12182 },
12183 },
12184 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
12185 # This map is keyed with the name of the network interface.
12186 &quot;a_key&quot;: {
12187 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
12188 # update or VM instance recreate operations.
12189 # This flag is used to configure if the IP reservation should be deleted
12190 # after it is no longer used by the group, e.g. when the given instance
12191 # or the whole group is deleted.
12192 &quot;ipAddress&quot;: { # Ip address representation
12193 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
12194 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
12195 # network interface.
12196 },
12197 },
12198 },
12199 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
12200 # This map is keyed with the name of the network interface.
12201 &quot;a_key&quot;: {
12202 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
12203 # update or VM instance recreate operations.
12204 # This flag is used to configure if the IP reservation should be deleted
12205 # after it is no longer used by the group, e.g. when the given instance
12206 # or the whole group is deleted.
12207 &quot;ipAddress&quot;: { # Ip address representation
12208 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
12209 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
12210 # network interface.
12211 },
12212 },
12213 },
12214 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
12215 &quot;a_key&quot;: &quot;A String&quot;,
12216 },
12217 },
12218 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
12219 # managed instance.
12220 },
12221 ],
12222 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
12223 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
12224 # the query parameter pageToken in the next list request.
12225 # Subsequent list requests will have their own nextPageToken to
12226 # continue paging through the results.
12227 &quot;warning&quot;: { # Output only. [Output Only] Informational warning message.
12228 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12229 # Engine returns NO_RESULTS_ON_PAGE if there
12230 # are no results in the response.
12231 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12232 # value format. For example:
12233 #
12234 # &quot;data&quot;: [
12235 # {
12236 # &quot;key&quot;: &quot;scope&quot;,
12237 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12238 # }
12239 {
12240 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12241 # returned. For example, for warnings where there are no results in a list
12242 # request for a particular zone, this key might be scope and
12243 # the key value might be the zone name. Other examples might be a key
12244 # indicating a deprecated resource and a suggested replacement, or a
12245 # warning about invalid network settings (for example, if an instance
12246 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12247 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12248 },
12249 ],
12250 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12251 },
12252 }</pre>
12253 </div>
12254
12255 <div class="method">
12256 <code class="details" id="listPerInstanceConfigs_next">listPerInstanceConfigs_next()</code>
12257 <pre>Retrieves the next page of results.
12258
12259 Args:
12260 previous_request: The request for the previous page. (required)
12261 previous_response: The response from the request for the previous page. (required)
12262
12263 Returns:
12264 A request object that you can call &#x27;execute()&#x27; on to request the next
12265 page. Returns None if there are no more items in the collection.
12266 </pre>
12267 </div>
12268
12269 <div class="method">
12270 <code class="details" id="list_next">list_next()</code>
12271 <pre>Retrieves the next page of results.
12272
12273 Args:
12274 previous_request: The request for the previous page. (required)
12275 previous_response: The response from the request for the previous page. (required)
12276
12277 Returns:
12278 A request object that you can call &#x27;execute()&#x27; on to request the next
12279 page. Returns None if there are no more items in the collection.
12280 </pre>
12281 </div>
12282
12283 <div class="method">
12284 <code class="details" id="patch">patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12285 <pre>Updates a managed instance group using the information that you specify
12286 in the request.
12287 This operation is marked as DONE when the group is patched
12288 even if the instances in the group are still in the process of being
12289 patched. You must separately verify the status of the individual instances
12290 with thelistManagedInstances
12291 method. This method supportsPATCH
12292 semantics and uses theJSON merge
12293 patch format and processing rules.
12294
12295 If you update your group to specify a new template or instance
12296 configuration, it&#x27;s possible that your intended specification for each VM
12297 in the group is different from the current state of that VM. To learn how
12298 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
12299 a MIG.
12300
12301 Args:
12302 project: string, Project ID for this request. (required)
12303 zone: string, The name of the zone where
12304 you want to create the managed instance group. (required)
12305 instanceGroupManager: string, The name of the instance group manager. (required)
12306 body: object, The request body.
12307 The object takes the form of:
12308
12309 { # Represents a Managed Instance Group resource.
12310 #
12311 # An instance group is a collection of VM instances that you can manage as a
12312 # single entity. For more information, readInstance groups.
12313 #
12314 # For zonal Managed Instance Group, use the instanceGroupManagers
12315 # resource.
12316 #
12317 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
12318 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
12319 # for the group.
12320 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
12321 #
12322 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
12323 # instances to apply the configuration. To apply the configuration, set the
12324 # group&#x27;s updatePolicy.type field to use proactive updates or
12325 # use the applyUpdatesToInstances method.
12326 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
12327 &quot;a_key&quot;: &quot;A String&quot;,
12328 },
12329 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
12330 # more information, see Project and
12331 # instance metadata.
12332 &quot;a_key&quot;: &quot;A String&quot;,
12333 },
12334 },
12335 },
12336 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
12337 # only one value.
12338 {
12339 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
12340 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
12341 # this field controls whether to trigger VM autohealing based on a failed
12342 # health check. Valid values are:
12343 #
12344 # - ON (default): The group recreates running VMs that
12345 # fail the application-based health check.
12346 # - OFF: When set to OFF, you can still observe instance
12347 # health state, but the group does not recreate VMs that fail the
12348 # application-based health check. This is useful for troubleshooting and
12349 # setting up your health check configuration.
12350 },
12351 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
12352 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
12353 # initialize and run its startup script. During a VM&#x27;s initial delay
12354 # period, the MIG ignores unsuccessful health checks because the VM might
12355 # be in the startup process. This prevents the MIG from prematurely
12356 # recreating a VM. If the health check receives a healthy response during
12357 # the initial delay, it indicates that the startup process is complete and
12358 # the VM is ready. The value of initial delay must be between 0 and 3600
12359 # seconds. The default value is 0.
12360 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
12361 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
12362 # The instance is considered available if all of the following conditions
12363 # are satisfied:
12364 # 1. Instance&#x27;s status is RUNNING.
12365 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
12366 # check result was observed to be HEALTHY at least once as it passed
12367 # VERIFYING).
12368 # 3. There is no outgoing action on an instance triggered by IGM.
12369 #
12370 # By default, number of concurrently autohealed instances is smaller than
12371 # the managed instance group target size. However, if a zonal managed
12372 # instance group has only one instance, or a regional managed instance
12373 # group has only one instance per zone, autohealing will recreate these
12374 # instances when they become unhealthy.
12375 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
12376 #
12377 #
12378 #
12379 # - If the value is fixed, then the calculated
12380 # value is equal to the fixed value.
12381 # - If the value is a percent, then the
12382 # calculated
12383 # value is percent/100 * targetSize. For example,
12384 # the calculated value of a 80% of a managed instance group
12385 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
12386 # is a remainder, the number is rounded.
12387 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
12388 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
12389 # example, specify 80 for 80%.
12390 },
12391 },
12392 ],
12393 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
12394 # all VMs in a MIG. The maximum character length is 58 and the name must
12395 # comply with RFC1035 format.
12396 #
12397 # When a VM is created in the group, the MIG appends a hyphen and a random
12398 # four-character string to the base instance name. If you want the MIG to
12399 # assign sequential numbers instead of a random string, then end the base
12400 # instance name with a hyphen followed by one or more hash symbols. The hash
12401 # symbols indicate the number of digits. For example, a base instance name of
12402 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
12403 # @pattern
12404 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
12405 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
12406 # text format.
12407 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
12408 # in this managed instance group that are scheduled for each of those
12409 # actions.
12410 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
12411 # that are scheduled to be abandoned. Abandoning an instance removes it
12412 # from the managed instance group without deleting it.
12413 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
12414 # are scheduled to be adopted or are currently being adopted.
12415 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
12416 # are scheduled to be created or are currently being created. If the group
12417 # fails to create any of these instances, it tries again until it creates
12418 # the instance successfully.
12419 #
12420 # If you have disabled creation retries, this field will not be populated;
12421 # instead, the creatingWithoutRetries field will be populated.
12422 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
12423 # will attempt to create atomically, in a batch mode. If the desired count
12424 # of instances can not be created, entire batch will be deleted and the
12425 # group will decrease its targetSize value accordingly.
12426 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
12427 # will attempt to create. The group attempts to create each instance
12428 # only once. If the group fails to create any of these instances, it
12429 # decreases the group&#x27;s targetSize value accordingly.
12430 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
12431 # are scheduled to be deleted or are currently being deleted.
12432 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
12433 # are running and have no scheduled actions.
12434 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
12435 # is currently queuing.
12436 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
12437 # are scheduled to be recreated or are currently being being recreated.
12438 # Recreating an instance deletes the existing root persistent disk
12439 # and creates a new disk from the image that is defined in the
12440 # instance template.
12441 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
12442 # are being reconfigured with properties that do not require a restart
12443 # or a recreate action. For example, setting or removing target
12444 # pools for the instance.
12445 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
12446 # are scheduled to be restarted or are currently being restarted.
12447 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
12448 # are scheduled to be restarted or are currently being restarted.
12449 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
12450 # are scheduled to be resumed or are currently being resumed.
12451 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
12452 # are scheduled to be started or are currently being started.
12453 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
12454 # are scheduled to be stopped or are currently being stopped.
12455 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
12456 # are scheduled to be suspended or are currently being suspended.
12457 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
12458 # are being verified. See the managedInstances[].currentAction
12459 # property in the listManagedInstances method documentation.
12460 },
12461 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
12462 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
12463 # zones in a regional managed instance group.
12464 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
12465 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
12466 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
12467 # its instances.
12468 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
12469 # instances, even if an AI zone is available in the specified region. To
12470 # create instances in an AI zone in the selected region, you must explicitly
12471 # specify it in the distribution policy together with the other preferred
12472 # zones.
12473 {
12474 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
12475 # The zone must exist in the region where the managed instance group is
12476 # located.
12477 },
12478 ],
12479 },
12480 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
12481 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
12482 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
12483 # fingerprint must be provided in order to update the InstanceGroupManager,
12484 # otherwise the request will fail with error412 conditionNotMet.
12485 #
12486 # To see the latest fingerprint, make a get() request to
12487 # retrieve an InstanceGroupManager.
12488 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
12489 # generates this identifier.
12490 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
12491 # types of machines.
12492 # Instance flexibility configuration on MIG overrides instance
12493 # template configuration.
12494 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
12495 # when creating new VMs.
12496 &quot;a_key&quot;: {
12497 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
12498 # selection.
12499 { # An instance-attached disk resource.
12500 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
12501 # or X86_64.
12502 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
12503 # deleted (but not when the disk is detached from the instance).
12504 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
12505 # partition of the disk for its root filesystem.
12506 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
12507 # running within the instance. This name can be used to reference the device
12508 # for mounting, resizing, and so on, from within the instance.
12509 #
12510 # If not specified, the server chooses a default device name to apply to this
12511 # disk, in the form persistent-disk-x, where x is a number
12512 # assigned by Google Compute Engine. This field is only applicable for
12513 # persistent disks.
12514 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
12515 # encryption key.
12516 #
12517 # If you are creating a new disk, this field encrypts the new disk using
12518 # an encryption key that you provide. If you are attaching an existing
12519 # disk that is already encrypted, this field decrypts the disk using
12520 # the customer-supplied encryption key.
12521 #
12522 # If you encrypt a disk using a customer-supplied key, you must provide the
12523 # same key again when you attempt to use this resource at a later time. For
12524 # example, you must provide the key when you create a snapshot or an image
12525 # from the disk or when you attach the disk to a virtual machine instance.
12526 #
12527 # If you do not provide an encryption key, then the disk will be encrypted
12528 # using an automatically generated key and you do not need to provide a key
12529 # to use the disk later.
12530 #
12531 # Note:
12532 #
12533 # Instance templates do not storecustomer-supplied
12534 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
12535 #
12536 # You cannot create VMs that have disks with customer-supplied keys using
12537 # the bulk
12538 # insert method.
12539 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
12540 # For example:
12541 #
12542 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
12543 # key_region/cryptoKeys/key
12544 #
12545 # The fully-qualifed key name may be returned for resource GET requests. For
12546 # example:
12547 #
12548 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
12549 # key_region/cryptoKeys/key
12550 # /cryptoKeyVersions/1
12551 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
12552 # key. If absent, the Compute Engine default service account is used.
12553 # For example:
12554 #
12555 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
12556 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
12557 # encryption key, encoded in RFC
12558 # 4648 base64 to either encrypt or decrypt this resource. You can
12559 # provide either the rawKey or thersaEncryptedKey.
12560 # For example:
12561 #
12562 # &quot;rawKey&quot;:
12563 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
12564 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
12565 # customer-supplied encryption key to either encrypt or decrypt this
12566 # resource. You can provide either the rawKey or thersaEncryptedKey.
12567 # For example:
12568 #
12569 # &quot;rsaEncryptedKey&quot;:
12570 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
12571 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
12572 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
12573 #
12574 # The key must meet the following requirements before you can provide it to
12575 # Compute Engine:
12576 #
12577 # 1. The key is wrapped using a RSA public key certificate provided by
12578 # Google.
12579 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
12580 # encoding.
12581 #
12582 # Gets the RSA public key certificate provided by Google at:
12583 #
12584 #
12585 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
12586 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
12587 # 4648 base64 encoded SHA-256 hash of the customer-supplied
12588 # encryption key that protects this resource.
12589 },
12590 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
12591 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
12592 # currently attached to another instance. If you try to force attach a zonal
12593 # disk to an instance, you will receive an error.
12594 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
12595 # only for bootable images. Read
12596 # Enabling guest operating system features to see a list of available
12597 # options.
12598 { # Guest OS features.
12599 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
12600 # separate values. Set to one or more of the following values:
12601 #
12602 # - VIRTIO_SCSI_MULTIQUEUE
12603 # - WINDOWS
12604 # - MULTI_IP_SUBNET
12605 # - UEFI_COMPATIBLE
12606 # - GVNIC
12607 # - SEV_CAPABLE
12608 # - SUSPEND_RESUME_COMPATIBLE
12609 # - SEV_LIVE_MIGRATABLE_V2
12610 # - SEV_SNP_CAPABLE
12611 # - TDX_CAPABLE
12612 # - IDPF
12613 # - SNP_SVSM_CAPABLE
12614 # - CCA_CAPABLE
12615 #
12616 #
12617 # For more information, see
12618 # Enabling guest operating system features.
12619 },
12620 ],
12621 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
12622 # boot disk. If you have many disks attached to an instance, each
12623 # disk would have a unique index number.
12624 &quot;initializeParams&quot;: { # [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
12625 # alongside the new instance. Use initialization parameters to create boot
12626 # disks or local SSDs attached to the new instance.
12627 #
12628 # This property is mutually exclusive with the source property;
12629 # you can only define one or the other, but not both.
12630 # alongside the new instance. Use initialization parameters to create boot
12631 # disks or local SSDs attached to the new instance.
12632 #
12633 # This field is persisted and returned for instanceTemplate and not returned
12634 # in the context of instance.
12635 #
12636 # This property is mutually exclusive with the source property;
12637 # you can only define one or the other, but not both.
12638 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
12639 # arm64 or x86_64.
12640 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
12641 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
12642 # of the instance. If a disk with the same name already exists in the given
12643 # region, the existing disk is attached to the new instance and the
12644 # new disk is not created.
12645 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
12646 # 10 GB. If you specify a sourceImage, which is required for
12647 # boot disks, the default size is the size of the sourceImage.
12648 # If you do not specify a sourceImage, the default disk size
12649 # is 500 GB.
12650 &quot;diskType&quot;: &quot;A String&quot;,
12651 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
12652 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
12653 # only for bootable images. Read
12654 # Enabling guest operating system features to see a list of available
12655 # options.
12656 #
12657 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
12658 { # Guest OS features.
12659 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
12660 # separate values. Set to one or more of the following values:
12661 #
12662 # - VIRTIO_SCSI_MULTIQUEUE
12663 # - WINDOWS
12664 # - MULTI_IP_SUBNET
12665 # - UEFI_COMPATIBLE
12666 # - GVNIC
12667 # - SEV_CAPABLE
12668 # - SUSPEND_RESUME_COMPATIBLE
12669 # - SEV_LIVE_MIGRATABLE_V2
12670 # - SEV_SNP_CAPABLE
12671 # - TDX_CAPABLE
12672 # - IDPF
12673 # - SNP_SVSM_CAPABLE
12674 # - CCA_CAPABLE
12675 #
12676 #
12677 # For more information, see
12678 # Enabling guest operating system features.
12679 },
12680 ],
12681 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
12682 # which is either SCSI or NVME. The default isSCSI.
12683 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
12684 # persistent disks.
12685 &quot;a_key&quot;: &quot;A String&quot;,
12686 },
12687 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
12688 # disk.
12689 &quot;A String&quot;,
12690 ],
12691 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
12692 &quot;A String&quot;,
12693 ],
12694 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
12695 # more than one instance.
12696 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
12697 # is to use the existing disk.
12698 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
12699 # of I/O operations per second that the disk can handle. Values must be
12700 # between 10,000 and 120,000. For more details, see theExtreme persistent
12701 # disk documentation.
12702 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
12703 # number of throughput mb per second that the disk can handle. Values must
12704 # greater than or equal to 1.
12705 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
12706 # the URLs of the zones where the disk should be replicated to.
12707 # You must provide exactly two replica zones, and one zone must be the same
12708 # as the instance zone.
12709 &quot;A String&quot;,
12710 ],
12711 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
12712 # have the same definition as resource
12713 # manager tags. Keys and values can be either in numeric format,
12714 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
12715 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
12716 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
12717 # empty.
12718 &quot;a_key&quot;: &quot;A String&quot;,
12719 },
12720 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
12721 # Specified using the full or partial URL. For instance template, specify
12722 # only the resource policy name.
12723 &quot;A String&quot;,
12724 ],
12725 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
12726 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
12727 # is required.
12728 #
12729 # To create a disk with one of the public operating system
12730 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
12731 #
12732 # projects/debian-cloud/global/images/family/debian-9
12733 #
12734 #
12735 # Alternatively, use a specific version of a public operating system image:
12736 #
12737 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
12738 #
12739 #
12740 # To create a disk with a custom image that you created, specify the
12741 # image name in the following format:
12742 #
12743 # global/images/my-custom-image
12744 #
12745 #
12746 # You can also specify a custom image by its image family, which returns
12747 # the latest version of the image in that family. Replace the image name
12748 # with family/family-name:
12749 #
12750 # global/images/family/my-image-family
12751 #
12752 #
12753 # If the source image is deleted later, this field will not be set.
12754 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
12755 # encryption key of the source image. Required if the source image is
12756 # protected by a customer-supplied encryption key.
12757 #
12758 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
12759 # encryption keys, so you cannot create disks for instances in a managed instance group if the
12760 # source images are encrypted with your own keys.
12761 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
12762 # For example:
12763 #
12764 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
12765 # key_region/cryptoKeys/key
12766 #
12767 # The fully-qualifed key name may be returned for resource GET requests. For
12768 # example:
12769 #
12770 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
12771 # key_region/cryptoKeys/key
12772 # /cryptoKeyVersions/1
12773 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
12774 # key. If absent, the Compute Engine default service account is used.
12775 # For example:
12776 #
12777 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
12778 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
12779 # encryption key, encoded in RFC
12780 # 4648 base64 to either encrypt or decrypt this resource. You can
12781 # provide either the rawKey or thersaEncryptedKey.
12782 # For example:
12783 #
12784 # &quot;rawKey&quot;:
12785 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
12786 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
12787 # customer-supplied encryption key to either encrypt or decrypt this
12788 # resource. You can provide either the rawKey or thersaEncryptedKey.
12789 # For example:
12790 #
12791 # &quot;rsaEncryptedKey&quot;:
12792 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
12793 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
12794 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
12795 #
12796 # The key must meet the following requirements before you can provide it to
12797 # Compute Engine:
12798 #
12799 # 1. The key is wrapped using a RSA public key certificate provided by
12800 # Google.
12801 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
12802 # encoding.
12803 #
12804 # Gets the RSA public key certificate provided by Google at:
12805 #
12806 #
12807 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
12808 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
12809 # 4648 base64 encoded SHA-256 hash of the customer-supplied
12810 # encryption key that protects this resource.
12811 },
12812 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
12813 # instance boot disk, one of initializeParams.sourceSnapshot
12814 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
12815 # is required.
12816 #
12817 # To create a disk with a snapshot that you created, specify the
12818 # snapshot name in the following format:
12819 #
12820 # us-central1-a/instantSnapshots/my-backup
12821 #
12822 #
12823 # If the source instant-snapshot is deleted later, this field will not be
12824 # set.
12825 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
12826 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
12827 # is required.
12828 #
12829 # To create a disk with a snapshot that you created, specify the
12830 # snapshot name in the following format:
12831 #
12832 # global/snapshots/my-backup
12833 #
12834 #
12835 # If the source snapshot is deleted later, this field will not be set.
12836 #
12837 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
12838 # an image instead when you create VMs using
12839 # the bulk
12840 # insert method.
12841 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
12842 # encryption key of the source snapshot.
12843 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
12844 # For example:
12845 #
12846 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
12847 # key_region/cryptoKeys/key
12848 #
12849 # The fully-qualifed key name may be returned for resource GET requests. For
12850 # example:
12851 #
12852 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
12853 # key_region/cryptoKeys/key
12854 # /cryptoKeyVersions/1
12855 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
12856 # key. If absent, the Compute Engine default service account is used.
12857 # For example:
12858 #
12859 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
12860 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
12861 # encryption key, encoded in RFC
12862 # 4648 base64 to either encrypt or decrypt this resource. You can
12863 # provide either the rawKey or thersaEncryptedKey.
12864 # For example:
12865 #
12866 # &quot;rawKey&quot;:
12867 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
12868 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
12869 # customer-supplied encryption key to either encrypt or decrypt this
12870 # resource. You can provide either the rawKey or thersaEncryptedKey.
12871 # For example:
12872 #
12873 # &quot;rsaEncryptedKey&quot;:
12874 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
12875 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
12876 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
12877 #
12878 # The key must meet the following requirements before you can provide it to
12879 # Compute Engine:
12880 #
12881 # 1. The key is wrapped using a RSA public key certificate provided by
12882 # Google.
12883 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
12884 # encoding.
12885 #
12886 # Gets the RSA public key certificate provided by Google at:
12887 #
12888 #
12889 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
12890 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
12891 # 4648 base64 encoded SHA-256 hash of the customer-supplied
12892 # encryption key that protects this resource.
12893 },
12894 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
12895 # this as a partial or full URL to the resource. For example, the following
12896 # are valid values:
12897 #
12898 #
12899 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
12900 # - projects/project/zones/zone/storagePools/storagePool
12901 # - zones/zone/storagePools/storagePool
12902 },
12903 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
12904 # either SCSI or NVME. For most machine types, the
12905 # default is SCSI. Local SSDs can use either NVME or SCSI.
12906 # In certain configurations, persistent disks can use NVMe. For more
12907 # information, seeAbout
12908 # persistent disks.
12909 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
12910 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
12911 &quot;A String&quot;,
12912 ],
12913 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
12914 # disk is not allowed to be detached from the instance, or to be used as the
12915 # source of the snapshot creation, and the image creation. The instance with
12916 # at least one locked attached disk is not allow to be used as source of
12917 # machine image creation, instant snapshot creation, and not allowed to be
12918 # deleted with --keep-disk parameter set to true for locked disks.
12919 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
12920 # in READ_WRITE mode.
12921 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
12922 # field is set to PRESERVED if the LocalSSD data has been saved
12923 # to a persistent location by customer request. (see the
12924 # discard_local_ssd option on Stop/Suspend).
12925 # Read-only in the api.
12926 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
12927 # these are public keys which are safe to store in public
12928 &quot;dbs&quot;: [ # The Key Database (db).
12929 {
12930 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
12931 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
12932 },
12933 ],
12934 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
12935 {
12936 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
12937 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
12938 },
12939 ],
12940 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
12941 {
12942 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
12943 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
12944 },
12945 ],
12946 &quot;pk&quot;: { # The Platform Key (PK).
12947 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
12948 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
12949 },
12950 },
12951 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
12952 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
12953 # is required.
12954 #
12955 # If desired, you can also attach existing non-root persistent disks using
12956 # this property. This field is only applicable for persistent disks.
12957 #
12958 # Note that for InstanceTemplate, specify the disk name for zonal disk,
12959 # and the URL for regional disk.
12960 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
12961 },
12962 ],
12963 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
12964 &quot;A String&quot;,
12965 ],
12966 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
12967 # e.g. &#x27;Intel Ice Lake&#x27;.
12968 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
12969 # preference. MIG will first try to create a VM based on the machine-type
12970 # with lowest rank and fallback to next rank based on availability.
12971 # Machine types and instance selections with the same rank have the same
12972 # preference.
12973 },
12974 },
12975 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
12976 # when creating new VMs.
12977 &quot;a_key&quot;: {
12978 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
12979 # selection.
12980 { # An instance-attached disk resource.
12981 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
12982 # or X86_64.
12983 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
12984 # deleted (but not when the disk is detached from the instance).
12985 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
12986 # partition of the disk for its root filesystem.
12987 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
12988 # running within the instance. This name can be used to reference the device
12989 # for mounting, resizing, and so on, from within the instance.
12990 #
12991 # If not specified, the server chooses a default device name to apply to this
12992 # disk, in the form persistent-disk-x, where x is a number
12993 # assigned by Google Compute Engine. This field is only applicable for
12994 # persistent disks.
12995 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
12996 # encryption key.
12997 #
12998 # If you are creating a new disk, this field encrypts the new disk using
12999 # an encryption key that you provide. If you are attaching an existing
13000 # disk that is already encrypted, this field decrypts the disk using
13001 # the customer-supplied encryption key.
13002 #
13003 # If you encrypt a disk using a customer-supplied key, you must provide the
13004 # same key again when you attempt to use this resource at a later time. For
13005 # example, you must provide the key when you create a snapshot or an image
13006 # from the disk or when you attach the disk to a virtual machine instance.
13007 #
13008 # If you do not provide an encryption key, then the disk will be encrypted
13009 # using an automatically generated key and you do not need to provide a key
13010 # to use the disk later.
13011 #
13012 # Note:
13013 #
13014 # Instance templates do not storecustomer-supplied
13015 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
13016 #
13017 # You cannot create VMs that have disks with customer-supplied keys using
13018 # the bulk
13019 # insert method.
13020 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
13021 # For example:
13022 #
13023 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13024 # key_region/cryptoKeys/key
13025 #
13026 # The fully-qualifed key name may be returned for resource GET requests. For
13027 # example:
13028 #
13029 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13030 # key_region/cryptoKeys/key
13031 # /cryptoKeyVersions/1
13032 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
13033 # key. If absent, the Compute Engine default service account is used.
13034 # For example:
13035 #
13036 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
13037 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
13038 # encryption key, encoded in RFC
13039 # 4648 base64 to either encrypt or decrypt this resource. You can
13040 # provide either the rawKey or thersaEncryptedKey.
13041 # For example:
13042 #
13043 # &quot;rawKey&quot;:
13044 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
13045 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
13046 # customer-supplied encryption key to either encrypt or decrypt this
13047 # resource. You can provide either the rawKey or thersaEncryptedKey.
13048 # For example:
13049 #
13050 # &quot;rsaEncryptedKey&quot;:
13051 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
13052 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
13053 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
13054 #
13055 # The key must meet the following requirements before you can provide it to
13056 # Compute Engine:
13057 #
13058 # 1. The key is wrapped using a RSA public key certificate provided by
13059 # Google.
13060 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
13061 # encoding.
13062 #
13063 # Gets the RSA public key certificate provided by Google at:
13064 #
13065 #
13066 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
13067 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
13068 # 4648 base64 encoded SHA-256 hash of the customer-supplied
13069 # encryption key that protects this resource.
13070 },
13071 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
13072 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
13073 # currently attached to another instance. If you try to force attach a zonal
13074 # disk to an instance, you will receive an error.
13075 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
13076 # only for bootable images. Read
13077 # Enabling guest operating system features to see a list of available
13078 # options.
13079 { # Guest OS features.
13080 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
13081 # separate values. Set to one or more of the following values:
13082 #
13083 # - VIRTIO_SCSI_MULTIQUEUE
13084 # - WINDOWS
13085 # - MULTI_IP_SUBNET
13086 # - UEFI_COMPATIBLE
13087 # - GVNIC
13088 # - SEV_CAPABLE
13089 # - SUSPEND_RESUME_COMPATIBLE
13090 # - SEV_LIVE_MIGRATABLE_V2
13091 # - SEV_SNP_CAPABLE
13092 # - TDX_CAPABLE
13093 # - IDPF
13094 # - SNP_SVSM_CAPABLE
13095 # - CCA_CAPABLE
13096 #
13097 #
13098 # For more information, see
13099 # Enabling guest operating system features.
13100 },
13101 ],
13102 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
13103 # boot disk. If you have many disks attached to an instance, each
13104 # disk would have a unique index number.
13105 &quot;initializeParams&quot;: { # [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
13106 # alongside the new instance. Use initialization parameters to create boot
13107 # disks or local SSDs attached to the new instance.
13108 #
13109 # This property is mutually exclusive with the source property;
13110 # you can only define one or the other, but not both.
13111 # alongside the new instance. Use initialization parameters to create boot
13112 # disks or local SSDs attached to the new instance.
13113 #
13114 # This field is persisted and returned for instanceTemplate and not returned
13115 # in the context of instance.
13116 #
13117 # This property is mutually exclusive with the source property;
13118 # you can only define one or the other, but not both.
13119 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
13120 # arm64 or x86_64.
13121 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
13122 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
13123 # of the instance. If a disk with the same name already exists in the given
13124 # region, the existing disk is attached to the new instance and the
13125 # new disk is not created.
13126 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
13127 # 10 GB. If you specify a sourceImage, which is required for
13128 # boot disks, the default size is the size of the sourceImage.
13129 # If you do not specify a sourceImage, the default disk size
13130 # is 500 GB.
13131 &quot;diskType&quot;: &quot;A String&quot;,
13132 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
13133 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
13134 # only for bootable images. Read
13135 # Enabling guest operating system features to see a list of available
13136 # options.
13137 #
13138 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
13139 { # Guest OS features.
13140 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
13141 # separate values. Set to one or more of the following values:
13142 #
13143 # - VIRTIO_SCSI_MULTIQUEUE
13144 # - WINDOWS
13145 # - MULTI_IP_SUBNET
13146 # - UEFI_COMPATIBLE
13147 # - GVNIC
13148 # - SEV_CAPABLE
13149 # - SUSPEND_RESUME_COMPATIBLE
13150 # - SEV_LIVE_MIGRATABLE_V2
13151 # - SEV_SNP_CAPABLE
13152 # - TDX_CAPABLE
13153 # - IDPF
13154 # - SNP_SVSM_CAPABLE
13155 # - CCA_CAPABLE
13156 #
13157 #
13158 # For more information, see
13159 # Enabling guest operating system features.
13160 },
13161 ],
13162 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
13163 # which is either SCSI or NVME. The default isSCSI.
13164 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
13165 # persistent disks.
13166 &quot;a_key&quot;: &quot;A String&quot;,
13167 },
13168 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
13169 # disk.
13170 &quot;A String&quot;,
13171 ],
13172 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
13173 &quot;A String&quot;,
13174 ],
13175 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
13176 # more than one instance.
13177 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
13178 # is to use the existing disk.
13179 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
13180 # of I/O operations per second that the disk can handle. Values must be
13181 # between 10,000 and 120,000. For more details, see theExtreme persistent
13182 # disk documentation.
13183 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
13184 # number of throughput mb per second that the disk can handle. Values must
13185 # greater than or equal to 1.
13186 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
13187 # the URLs of the zones where the disk should be replicated to.
13188 # You must provide exactly two replica zones, and one zone must be the same
13189 # as the instance zone.
13190 &quot;A String&quot;,
13191 ],
13192 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
13193 # have the same definition as resource
13194 # manager tags. Keys and values can be either in numeric format,
13195 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
13196 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
13197 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
13198 # empty.
13199 &quot;a_key&quot;: &quot;A String&quot;,
13200 },
13201 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
13202 # Specified using the full or partial URL. For instance template, specify
13203 # only the resource policy name.
13204 &quot;A String&quot;,
13205 ],
13206 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
13207 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
13208 # is required.
13209 #
13210 # To create a disk with one of the public operating system
13211 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
13212 #
13213 # projects/debian-cloud/global/images/family/debian-9
13214 #
13215 #
13216 # Alternatively, use a specific version of a public operating system image:
13217 #
13218 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
13219 #
13220 #
13221 # To create a disk with a custom image that you created, specify the
13222 # image name in the following format:
13223 #
13224 # global/images/my-custom-image
13225 #
13226 #
13227 # You can also specify a custom image by its image family, which returns
13228 # the latest version of the image in that family. Replace the image name
13229 # with family/family-name:
13230 #
13231 # global/images/family/my-image-family
13232 #
13233 #
13234 # If the source image is deleted later, this field will not be set.
13235 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
13236 # encryption key of the source image. Required if the source image is
13237 # protected by a customer-supplied encryption key.
13238 #
13239 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
13240 # encryption keys, so you cannot create disks for instances in a managed instance group if the
13241 # source images are encrypted with your own keys.
13242 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
13243 # For example:
13244 #
13245 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13246 # key_region/cryptoKeys/key
13247 #
13248 # The fully-qualifed key name may be returned for resource GET requests. For
13249 # example:
13250 #
13251 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13252 # key_region/cryptoKeys/key
13253 # /cryptoKeyVersions/1
13254 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
13255 # key. If absent, the Compute Engine default service account is used.
13256 # For example:
13257 #
13258 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
13259 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
13260 # encryption key, encoded in RFC
13261 # 4648 base64 to either encrypt or decrypt this resource. You can
13262 # provide either the rawKey or thersaEncryptedKey.
13263 # For example:
13264 #
13265 # &quot;rawKey&quot;:
13266 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
13267 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
13268 # customer-supplied encryption key to either encrypt or decrypt this
13269 # resource. You can provide either the rawKey or thersaEncryptedKey.
13270 # For example:
13271 #
13272 # &quot;rsaEncryptedKey&quot;:
13273 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
13274 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
13275 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
13276 #
13277 # The key must meet the following requirements before you can provide it to
13278 # Compute Engine:
13279 #
13280 # 1. The key is wrapped using a RSA public key certificate provided by
13281 # Google.
13282 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
13283 # encoding.
13284 #
13285 # Gets the RSA public key certificate provided by Google at:
13286 #
13287 #
13288 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
13289 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
13290 # 4648 base64 encoded SHA-256 hash of the customer-supplied
13291 # encryption key that protects this resource.
13292 },
13293 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
13294 # instance boot disk, one of initializeParams.sourceSnapshot
13295 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
13296 # is required.
13297 #
13298 # To create a disk with a snapshot that you created, specify the
13299 # snapshot name in the following format:
13300 #
13301 # us-central1-a/instantSnapshots/my-backup
13302 #
13303 #
13304 # If the source instant-snapshot is deleted later, this field will not be
13305 # set.
13306 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
13307 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
13308 # is required.
13309 #
13310 # To create a disk with a snapshot that you created, specify the
13311 # snapshot name in the following format:
13312 #
13313 # global/snapshots/my-backup
13314 #
13315 #
13316 # If the source snapshot is deleted later, this field will not be set.
13317 #
13318 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
13319 # an image instead when you create VMs using
13320 # the bulk
13321 # insert method.
13322 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
13323 # encryption key of the source snapshot.
13324 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
13325 # For example:
13326 #
13327 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13328 # key_region/cryptoKeys/key
13329 #
13330 # The fully-qualifed key name may be returned for resource GET requests. For
13331 # example:
13332 #
13333 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13334 # key_region/cryptoKeys/key
13335 # /cryptoKeyVersions/1
13336 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
13337 # key. If absent, the Compute Engine default service account is used.
13338 # For example:
13339 #
13340 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
13341 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
13342 # encryption key, encoded in RFC
13343 # 4648 base64 to either encrypt or decrypt this resource. You can
13344 # provide either the rawKey or thersaEncryptedKey.
13345 # For example:
13346 #
13347 # &quot;rawKey&quot;:
13348 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
13349 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
13350 # customer-supplied encryption key to either encrypt or decrypt this
13351 # resource. You can provide either the rawKey or thersaEncryptedKey.
13352 # For example:
13353 #
13354 # &quot;rsaEncryptedKey&quot;:
13355 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
13356 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
13357 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
13358 #
13359 # The key must meet the following requirements before you can provide it to
13360 # Compute Engine:
13361 #
13362 # 1. The key is wrapped using a RSA public key certificate provided by
13363 # Google.
13364 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
13365 # encoding.
13366 #
13367 # Gets the RSA public key certificate provided by Google at:
13368 #
13369 #
13370 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
13371 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
13372 # 4648 base64 encoded SHA-256 hash of the customer-supplied
13373 # encryption key that protects this resource.
13374 },
13375 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
13376 # this as a partial or full URL to the resource. For example, the following
13377 # are valid values:
13378 #
13379 #
13380 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
13381 # - projects/project/zones/zone/storagePools/storagePool
13382 # - zones/zone/storagePools/storagePool
13383 },
13384 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
13385 # either SCSI or NVME. For most machine types, the
13386 # default is SCSI. Local SSDs can use either NVME or SCSI.
13387 # In certain configurations, persistent disks can use NVMe. For more
13388 # information, seeAbout
13389 # persistent disks.
13390 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
13391 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
13392 &quot;A String&quot;,
13393 ],
13394 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
13395 # disk is not allowed to be detached from the instance, or to be used as the
13396 # source of the snapshot creation, and the image creation. The instance with
13397 # at least one locked attached disk is not allow to be used as source of
13398 # machine image creation, instant snapshot creation, and not allowed to be
13399 # deleted with --keep-disk parameter set to true for locked disks.
13400 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
13401 # in READ_WRITE mode.
13402 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
13403 # field is set to PRESERVED if the LocalSSD data has been saved
13404 # to a persistent location by customer request. (see the
13405 # discard_local_ssd option on Stop/Suspend).
13406 # Read-only in the api.
13407 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
13408 # these are public keys which are safe to store in public
13409 &quot;dbs&quot;: [ # The Key Database (db).
13410 {
13411 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13412 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13413 },
13414 ],
13415 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
13416 {
13417 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13418 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13419 },
13420 ],
13421 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
13422 {
13423 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13424 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13425 },
13426 ],
13427 &quot;pk&quot;: { # The Platform Key (PK).
13428 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13429 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13430 },
13431 },
13432 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
13433 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
13434 # is required.
13435 #
13436 # If desired, you can also attach existing non-root persistent disks using
13437 # this property. This field is only applicable for persistent disks.
13438 #
13439 # Note that for InstanceTemplate, specify the disk name for zonal disk,
13440 # and the URL for regional disk.
13441 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
13442 },
13443 ],
13444 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
13445 &quot;A String&quot;,
13446 ],
13447 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
13448 # e.g. &#x27;Intel Ice Lake&#x27;.
13449 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
13450 # preference. MIG will first try to create a VM based on the machine-type
13451 # with lowest rank and fallback to next rank based on availability.
13452 # Machine types and instance selections with the same rank have the same
13453 # preference.
13454 },
13455 },
13456 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
13457 # create instances.
13458 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
13459 # more preemption than the minimum capacity user needs. MIG will create
13460 # only Standard VMs until it reaches standard_capacity_base and only
13461 # then will start using standard_capacity_percent_above_base to mix Spot
13462 # with Standard VMs.
13463 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
13464 # remaining percentage will use Spot VMs. The percentage applies only to
13465 # the capacity above standard_capacity_base.
13466 },
13467 },
13468 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
13469 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
13470 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
13471 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
13472 # applies to the VMs on which your application fails a health check.
13473 # Valid values are
13474 #
13475 # - REPAIR (default): MIG automatically repairs a failed VM
13476 # by recreating it. For more information, see About
13477 # repairing VMs in a MIG.
13478 # - DO_NOTHING: MIG does not repair a failed VM.
13479 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
13480 # configuration when repairing a VM. Valid options are:
13481 #
13482 #
13483 #
13484 # - NO (default): If configuration updates are available, they are not
13485 # forcefully applied during repair. Instead, configuration updates are
13486 # applied according to the group&#x27;s update policy.
13487 #
13488 # - YES: If configuration updates are available, they are applied
13489 # during repair.
13490 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
13491 # instance during initialization when stopping / suspending an instance.
13492 # The Instance Group Manager will wait for a signal that indicates
13493 # successful initialization before stopping / suspending an instance.
13494 #
13495 # If a successful readiness signal is not sent before timeout, the
13496 # corresponding instance will not be stopped / suspended. Instead,
13497 # an error will be visible in the lastAttempt.errors field of
13498 # the managed instance in the listmanagedinstances
13499 # method.
13500 #
13501 # If metadataBasedReadinessSignal.timeoutSec is unset,
13502 # the Instance Group Manager will directly proceed to suspend / stop
13503 # instances, skipping initialization on them.
13504 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
13505 # initialization before timing out.
13506 },
13507 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
13508 # unhealthy when the application running on that VM fails a health check.
13509 # Valid values are:
13510 #
13511 # - DEFAULT_ACTION (default): MIG uses the same action
13512 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
13513 # - REPAIR: MIG automatically repairs an unhealthy VM by
13514 # recreating it.
13515 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
13516 # For more information, see
13517 # About repairing VMs in a MIG.
13518 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
13519 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
13520 # Valid values are:
13521 #
13522 # - NO (default): MIG cannot change a VM&#x27;s zone during a
13523 # repair.
13524 # - YES: MIG can select a different zone for the VM during
13525 # a repair.
13526 },
13527 },
13528 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
13529 # instance group. The group uses this template to create all new instances
13530 # in the managed instance group. The templates for existing instances in the
13531 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
13532 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
13533 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
13534 # this managed instance group.
13535 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
13536 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
13537 # long, and comply withRFC1035.
13538 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
13539 # to this Instance Group Manager.
13540 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
13541 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
13542 # The name must be 1-63 characters long, and comply withRFC1035.
13543 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
13544 },
13545 ],
13546 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
13547 # as part of resource payload.
13548 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
13549 # key-value pairs. Keys and values can be either in numeric format,
13550 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
13551 # format such as `{org_id|project_id}/{tag_key_short_name}` and
13552 # `{tag_value_short_name}`. For more information, seeManage tags
13553 # for resources.
13554 &quot;a_key&quot;: &quot;A String&quot;,
13555 },
13556 },
13557 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
13558 # where the managed instance group resides (for regional resources).
13559 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
13560 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
13561 # instance group.
13562 # It can be a full or partial URL. For example, the following are
13563 # all valid URLs to a workload policy:
13564 #
13565 #
13566 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
13567 # - projects/project/regions/region/resourcePolicies/resourcePolicy
13568 # - regions/region/resourcePolicies/resourcePolicy
13569 },
13570 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
13571 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
13572 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
13573 # this URL.
13574 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
13575 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
13576 # by the managed instance group on instances. The service accounts needs all
13577 # permissions required to create and delete instances.
13578 # By default, the service account
13579 # {projectNumber}@cloudservices.gserviceaccount.com is used.
13580 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
13581 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
13582 # stop a VM after that VM was created. The initial delay gives the
13583 # initialization script the time to prepare your VM for a quick scale out.
13584 # The value of initial delay must be between 0 and 3600 seconds. The
13585 # default value is 0.
13586 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
13587 # group scales out. The default mode is `MANUAL`.
13588 },
13589 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
13590 &quot;preservedState&quot;: { # Configuration of preserved resources.
13591 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
13592 # delete, update, etc. This map is keyed with the device names of
13593 # the disks.
13594 &quot;a_key&quot;: {
13595 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
13596 # update or VM instance recreate operations.
13597 # This flag is used to configure if the disk should be deleted after it
13598 # is no longer used by the group, e.g. when the given instance or
13599 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
13600 },
13601 },
13602 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
13603 # instance delete, update, etc. This map is keyed with the network
13604 # interface name.
13605 &quot;a_key&quot;: {
13606 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
13607 # update or VM instance recreate operations.
13608 # This flag is used to configure if the IP reservation should be deleted
13609 # after it is no longer used by the group, e.g. when the given instance
13610 # or the whole group is deleted.
13611 },
13612 },
13613 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
13614 # instance delete, update, etc. This map is keyed with the network
13615 # interface name.
13616 &quot;a_key&quot;: {
13617 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
13618 # update or VM instance recreate operations.
13619 # This flag is used to configure if the IP reservation should be deleted
13620 # after it is no longer used by the group, e.g. when the given instance
13621 # or the whole group is deleted.
13622 },
13623 },
13624 },
13625 },
13626 &quot;status&quot;: { # Output only. The status of this managed instance group.
13627 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
13628 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
13629 # This value is in RFC3339 text format.
13630 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
13631 # been applied to all managed instances in the group.
13632 },
13633 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
13634 # Currently only one accelerator topology is supported.
13635 {
13636 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
13637 # The value is the same as configured in the WorkloadPolicy.
13638 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
13639 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
13640 # check.
13641 &quot;error&quot;: { # Output only. Encountered errors.
13642 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13643 # operation.
13644 {
13645 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13646 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13647 # details. There is a set of defined message types to use for providing
13648 # details.The syntax depends on the error code. For example,
13649 # QuotaExceededInfo will have details when the error code is
13650 # QUOTA_EXCEEDED.
13651 {
13652 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13653 #
13654 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13655 # is not enabled:
13656 #
13657 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13658 # &quot;domain&quot;: &quot;googleapis.com&quot;
13659 # &quot;metadata&quot;: {
13660 # &quot;resource&quot;: &quot;projects/123&quot;,
13661 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13662 # }
13663 # }
13664 #
13665 # This response indicates that the pubsub.googleapis.com API is not enabled.
13666 #
13667 # Example of an error that is returned when attempting to create a Spanner
13668 # instance in a region that is out of stock:
13669 #
13670 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13671 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13672 # &quot;metadata&quot;: {
13673 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13674 # }
13675 # }
13676 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13677 # is typically the registered service name of the tool or product that
13678 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13679 # generated by some common infrastructure, the error domain must be a
13680 # globally unique value that identifies the infrastructure. For Google API
13681 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13682 &quot;metadatas&quot;: { # Additional structured details about this error.
13683 #
13684 # Keys must match a regular expression of `a-z+` but should
13685 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13686 # length. When identifying the current value of an exceeded limit, the units
13687 # should be contained in the key, not the value. For example, rather than
13688 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13689 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13690 # instances that can be created in a single (batch) request.
13691 &quot;a_key&quot;: &quot;A String&quot;,
13692 },
13693 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13694 # proximate cause of the error. Error reasons are unique within a particular
13695 # domain of errors. This should be at most 63 characters and match a
13696 # regular expression of `A-Z+[A-Z0-9]`, which represents
13697 # UPPER_SNAKE_CASE.
13698 },
13699 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13700 #
13701 # For example, if a quota check failed with an error indicating the calling
13702 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13703 # directly to the right place in the developer console to flip the bit.
13704 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13705 { # Describes a URL link.
13706 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13707 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13708 },
13709 ],
13710 },
13711 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13712 # which can be attached to an RPC error.
13713 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13714 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13715 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13716 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13717 },
13718 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13719 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13720 &quot;a_key&quot;: &quot;A String&quot;,
13721 },
13722 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13723 # type or metric.
13724 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13725 # or metric.
13726 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13727 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13728 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13729 },
13730 },
13731 ],
13732 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13733 # This property is optional.
13734 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13735 },
13736 ],
13737 },
13738 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
13739 # has // RFC3339 //
13740 # text format.
13741 },
13742 },
13743 ],
13744 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
13745 # that targets this instance group manager.
13746 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
13747 # targetSizePolicy.mode is set to BULK.
13748 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
13749 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
13750 # operation.
13751 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
13752 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13753 # operation.
13754 {
13755 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13756 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13757 # details. There is a set of defined message types to use for providing
13758 # details.The syntax depends on the error code. For example,
13759 # QuotaExceededInfo will have details when the error code is
13760 # QUOTA_EXCEEDED.
13761 {
13762 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13763 #
13764 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13765 # is not enabled:
13766 #
13767 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13768 # &quot;domain&quot;: &quot;googleapis.com&quot;
13769 # &quot;metadata&quot;: {
13770 # &quot;resource&quot;: &quot;projects/123&quot;,
13771 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13772 # }
13773 # }
13774 #
13775 # This response indicates that the pubsub.googleapis.com API is not enabled.
13776 #
13777 # Example of an error that is returned when attempting to create a Spanner
13778 # instance in a region that is out of stock:
13779 #
13780 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13781 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13782 # &quot;metadata&quot;: {
13783 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13784 # }
13785 # }
13786 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13787 # is typically the registered service name of the tool or product that
13788 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13789 # generated by some common infrastructure, the error domain must be a
13790 # globally unique value that identifies the infrastructure. For Google API
13791 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13792 &quot;metadatas&quot;: { # Additional structured details about this error.
13793 #
13794 # Keys must match a regular expression of `a-z+` but should
13795 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13796 # length. When identifying the current value of an exceeded limit, the units
13797 # should be contained in the key, not the value. For example, rather than
13798 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13799 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13800 # instances that can be created in a single (batch) request.
13801 &quot;a_key&quot;: &quot;A String&quot;,
13802 },
13803 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13804 # proximate cause of the error. Error reasons are unique within a particular
13805 # domain of errors. This should be at most 63 characters and match a
13806 # regular expression of `A-Z+[A-Z0-9]`, which represents
13807 # UPPER_SNAKE_CASE.
13808 },
13809 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13810 #
13811 # For example, if a quota check failed with an error indicating the calling
13812 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13813 # directly to the right place in the developer console to flip the bit.
13814 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13815 { # Describes a URL link.
13816 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13817 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13818 },
13819 ],
13820 },
13821 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13822 # which can be attached to an RPC error.
13823 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13824 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13825 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13826 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13827 },
13828 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13829 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13830 &quot;a_key&quot;: &quot;A String&quot;,
13831 },
13832 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13833 # type or metric.
13834 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13835 # or metric.
13836 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13837 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13838 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13839 },
13840 },
13841 ],
13842 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13843 # This property is optional.
13844 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13845 },
13846 ],
13847 },
13848 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
13849 # operation. Timestamp is in RFC3339 text format.
13850 },
13851 },
13852 &quot;currentInstanceStatuses&quot;: { # 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
13853 # in this managed instance group that have the status. Currently only shown
13854 # for TPU MIGs
13855 # instance group that have the status. For more information about how to
13856 # interpret each status check the instance lifecycle documentation.
13857 # Currently only shown for TPU MIGs.
13858 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
13859 # that have DEPROVISIONING status.
13860 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
13861 # have been deleted. Includes only instances that would be shown in the
13862 # listManagedInstances method and not all instances that have been
13863 # deleted in the lifetime of the MIG.
13864 # Does not include FlexStart instances that are waiting for the resources
13865 # availability, they are considered as &#x27;pending&#x27;.
13866 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
13867 # that have PENDING status, that is FlexStart instances that are waiting
13868 # for resources. Instances that do not exist because of the other reasons
13869 # are counted as &#x27;non_existent&#x27;.
13870 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
13871 # that have PENDING_STOP status.
13872 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
13873 # that have PROVISIONING status.
13874 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
13875 # that have REPAIRING status.
13876 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
13877 # that have RUNNING status.
13878 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
13879 # that have STAGING status.
13880 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
13881 # that have STOPPED status.
13882 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
13883 # that have STOPPING status.
13884 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
13885 # that have SUSPENDED status.
13886 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
13887 # that have SUSPENDING status.
13888 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
13889 # that have TERMINATED status.
13890 },
13891 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
13892 # stable state. A stable state means that: none of the instances in the
13893 # managed instance group is currently undergoing any type of change (for
13894 # example, creation, restart, or deletion); no future changes are scheduled
13895 # for instances in the managed instance group; and the managed instance
13896 # group itself is not being modified.
13897 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
13898 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
13899 # has stateful configuration, that is, if you have configured any items
13900 # in a stateful policy or in per-instance configs.
13901 # The group might report that it has no stateful configuration even when
13902 # there is still some preserved state on a managed instance, for example,
13903 # if you have deleted all PICs but not yet applied those deletions.
13904 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
13905 # has stateful configuration, that is, if you have configured any items
13906 # in a stateful policy or in per-instance configs.
13907 # The group might report that it has no stateful configuration even when
13908 # there is still some preserved state on a managed instance, for example,
13909 # if you have deleted all PICs but not yet applied those deletions. This
13910 # field is deprecated in favor of has_stateful_config.
13911 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
13912 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
13913 # (listed in the output of a listPerInstanceConfigs API call) have
13914 # status EFFECTIVE or there are no per-instance-configs.
13915 },
13916 },
13917 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
13918 # target version specified by version field on Instance Group
13919 # Manager.
13920 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
13921 # in this managed instance group, i.e. all instances are in their target
13922 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
13923 },
13924 },
13925 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
13926 # apply to all of the instances in the managed instance group.
13927 &quot;A String&quot;,
13928 ],
13929 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
13930 # You can reduce this number by using the instanceGroupManager
13931 # deleteInstances or abandonInstances methods. Resizing the group also
13932 # changes this number.
13933 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
13934 # size.
13935 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
13936 # individually or all at once.
13937 },
13938 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
13939 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
13940 # This number changes when you:
13941 #
13942 # - Stop instance using the stopInstances
13943 # method or start instances using the startInstances
13944 # method.
13945 # - Manually change the targetStoppedSize using the update
13946 # method.
13947 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
13948 # This number changes when you:
13949 #
13950 # - Suspend instance using the suspendInstances
13951 # method or resume instances using the resumeInstances
13952 # method.
13953 # - Manually change the targetSuspendedSize using the update
13954 # method.
13955 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
13956 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
13957 &quot;A String&quot;,
13958 ],
13959 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
13960 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
13961 # instance redistribution policy for regional managed instance groups.
13962 # Valid values are:
13963 #
13964 # - PROACTIVE (default): The group attempts to maintain an
13965 # even distribution of VM instances across zones in the region.
13966 # - NONE: For non-autoscaled groups, proactive
13967 # redistribution is disabled.
13968 &quot;maxSurge&quot;: { # 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
13969 # either a fixed number or, if the group has 10 or more instances, a
13970 # percentage. If you set a percentage, the number of instances is rounded
13971 # if necessary. The default value for maxSurge is a fixed
13972 # value equal to the number of zones in which the managed instance group
13973 # operates.
13974 #
13975 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
13976 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
13977 #
13978 #
13979 #
13980 # - If the value is fixed, then the calculated
13981 # value is equal to the fixed value.
13982 # - If the value is a percent, then the
13983 # calculated
13984 # value is percent/100 * targetSize. For example,
13985 # the calculated value of a 80% of a managed instance group
13986 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
13987 # is a remainder, the number is rounded.
13988 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
13989 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
13990 # example, specify 80 for 80%.
13991 },
13992 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
13993 # process. An instance is considered available if all of the following
13994 # conditions are satisfied:
13995 #
13996 #
13997 #
13998 # - The instance&#x27;s status is
13999 # RUNNING.
14000 # - If there is a health
14001 # check on the instance group, the instance&#x27;s health check status
14002 # must be HEALTHY at least once. If there is no health check
14003 # on the group, then the instance only needs to have a status of
14004 # RUNNING to be considered available.
14005 #
14006 #
14007 # This value can be either a fixed number or, if the group has 10 or more
14008 # instances, a percentage. If you set a percentage, the number of instances
14009 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
14010 # in which the managed instance group operates.
14011 #
14012 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
14013 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
14014 #
14015 #
14016 #
14017 # - If the value is fixed, then the calculated
14018 # value is equal to the fixed value.
14019 # - If the value is a percent, then the
14020 # calculated
14021 # value is percent/100 * targetSize. For example,
14022 # the calculated value of a 80% of a managed instance group
14023 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
14024 # is a remainder, the number is rounded.
14025 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
14026 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
14027 # example, specify 80 for 80%.
14028 },
14029 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
14030 # becomes available. This value must be from range [0, 3600].
14031 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
14032 # disruption as much as possible or to apply a more disruptive action than
14033 # is necessary.
14034 #
14035 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
14036 # Compute Engine performs the necessary action to execute the update.
14037 # - To apply a more disruptive action than is strictly necessary, set the
14038 # minimal action to RESTART or REPLACE. For
14039 # example, Compute Engine does not need to restart a VM to change its
14040 # metadata. But if your application reads instance metadata only when a VM
14041 # is restarted, you can set the minimal action to RESTART in
14042 # order to pick up metadata changes.
14043 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
14044 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
14045 # as much as possible. RESTART to allow actions that can be
14046 # applied without instance replacing or REPLACE to allow all
14047 # possible actions. If the Updater determines that the minimal update
14048 # action needed is more disruptive than most disruptive allowed action you
14049 # specify it will not perform the update at all.
14050 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
14051 # See minimal_action.REPLACE
14052 &quot;type&quot;: &quot;A String&quot;, # The type
14053 # of update process. You can specify either PROACTIVE so
14054 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
14055 # to update.
14056 },
14057 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
14058 # create instances.
14059 #
14060 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
14061 # group. This field overrides the top-level instanceTemplate
14062 # field. Read more about therelationships
14063 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
14064 # remaining instances. For more information, read aboutcanary
14065 # updates.
14066 {
14067 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
14068 # instance group. The group uses this template to create new instances in
14069 # the managed instance group until the `targetSize` for this version is
14070 # reached. The templates for existing instances in the group do not change
14071 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
14072 # existing instances are updated until the `targetSize` for this version is
14073 # reached.
14074 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
14075 # managed instance group.
14076 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
14077 # even if instance_template remains unchanged.
14078 # Deprecated in favor of &#x27;name&#x27;.
14079 &quot;targetSize&quot;: { # 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
14080 # from the template will be equal to:
14081 #
14082 #
14083 # - If expressed as a fixed number, the minimum of either
14084 # targetSize.fixed or
14085 # instanceGroupManager.targetSize is used.
14086 # - if expressed as a percent, the targetSize
14087 # would be (targetSize.percent/100 *
14088 # InstanceGroupManager.targetSize) If there is a remainder, the
14089 # number is rounded.
14090 #
14091 # If unset, this version will update any remaining instances not
14092 # updated by another version. ReadStarting
14093 # a canary update for more information.
14094 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
14095 #
14096 #
14097 #
14098 # - If the value is fixed, then the calculated
14099 # value is equal to the fixed value.
14100 # - If the value is a percent, then the
14101 # calculated
14102 # value is percent/100 * targetSize. For example,
14103 # the calculated value of a 80% of a managed instance group
14104 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
14105 # is a remainder, the number is rounded.
14106 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
14107 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
14108 # example, specify 80 for 80%.
14109 },
14110 },
14111 ],
14112 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
14113 # where the managed instance group is located (for zonal resources).
14114 }
14115
14116 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14117 that if you must retry your request, the server will know to ignore the
14118 request if it has already been completed.
14119
14120 For example, consider a situation where you make an initial request and
14121 the request times out. If you make the request again with the same
14122 request ID, the server can check if original operation with the same
14123 request ID was received, and if so, will ignore the second request. This
14124 prevents clients from accidentally creating duplicate commitments.
14125
14126 The request ID must be
14127 a valid UUID with the exception that zero UUID is not supported
14128 (00000000-0000-0000-0000-000000000000).
14129 x__xgafv: string, V1 error format.
14130 Allowed values
14131 1 - v1 error format
14132 2 - v2 error format
14133
14134 Returns:
14135 An object of the form:
14136
14137 { # Represents an Operation resource.
14138 #
14139 # Google Compute Engine has three Operation resources:
14140 #
14141 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14142 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14143 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14144 #
14145 # You can use an operation resource to manage asynchronous API requests.
14146 # For more information, readHandling
14147 # API responses.
14148 #
14149 # Operations can be global, regional or zonal.
14150 #
14151 # - For global operations, use the `globalOperations`
14152 # resource.
14153 # - For regional operations, use the
14154 # `regionOperations` resource.
14155 # - For zonal operations, use
14156 # the `zoneOperations` resource.
14157 #
14158 #
14159 #
14160 # For more information, read
14161 # Global, Regional, and Zonal Resources.
14162 #
14163 # Note that completed Operation resources have a limited
14164 # retention period.
14165 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14166 # Not present otherwise.
14167 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14168 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14169 # set when the operation is created.
14170 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14171 # text format.
14172 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14173 # this field will be populated.
14174 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14175 # operation.
14176 {
14177 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14178 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14179 # details. There is a set of defined message types to use for providing
14180 # details.The syntax depends on the error code. For example,
14181 # QuotaExceededInfo will have details when the error code is
14182 # QUOTA_EXCEEDED.
14183 {
14184 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14185 #
14186 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14187 # is not enabled:
14188 #
14189 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14190 # &quot;domain&quot;: &quot;googleapis.com&quot;
14191 # &quot;metadata&quot;: {
14192 # &quot;resource&quot;: &quot;projects/123&quot;,
14193 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14194 # }
14195 # }
14196 #
14197 # This response indicates that the pubsub.googleapis.com API is not enabled.
14198 #
14199 # Example of an error that is returned when attempting to create a Spanner
14200 # instance in a region that is out of stock:
14201 #
14202 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14203 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14204 # &quot;metadata&quot;: {
14205 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14206 # }
14207 # }
14208 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14209 # is typically the registered service name of the tool or product that
14210 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14211 # generated by some common infrastructure, the error domain must be a
14212 # globally unique value that identifies the infrastructure. For Google API
14213 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14214 &quot;metadatas&quot;: { # Additional structured details about this error.
14215 #
14216 # Keys must match a regular expression of `a-z+` but should
14217 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14218 # length. When identifying the current value of an exceeded limit, the units
14219 # should be contained in the key, not the value. For example, rather than
14220 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14221 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14222 # instances that can be created in a single (batch) request.
14223 &quot;a_key&quot;: &quot;A String&quot;,
14224 },
14225 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14226 # proximate cause of the error. Error reasons are unique within a particular
14227 # domain of errors. This should be at most 63 characters and match a
14228 # regular expression of `A-Z+[A-Z0-9]`, which represents
14229 # UPPER_SNAKE_CASE.
14230 },
14231 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14232 #
14233 # For example, if a quota check failed with an error indicating the calling
14234 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14235 # directly to the right place in the developer console to flip the bit.
14236 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14237 { # Describes a URL link.
14238 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14239 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14240 },
14241 ],
14242 },
14243 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14244 # which can be attached to an RPC error.
14245 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14246 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14247 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14248 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14249 },
14250 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14251 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14252 &quot;a_key&quot;: &quot;A String&quot;,
14253 },
14254 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14255 # type or metric.
14256 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14257 # or metric.
14258 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14259 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14260 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14261 },
14262 },
14263 ],
14264 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14265 # This property is optional.
14266 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14267 },
14268 ],
14269 },
14270 &quot;getVersionOperationMetadata&quot;: {
14271 &quot;inlineSbomInfo&quot;: {
14272 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14273 # appropriate identifiers.
14274 &quot;a_key&quot;: &quot;A String&quot;,
14275 },
14276 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14277 # identifiers.
14278 &quot;a_key&quot;: &quot;A String&quot;,
14279 },
14280 },
14281 },
14282 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14283 # message that was returned, such as `NOT FOUND`.
14284 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14285 # status code that was returned. For example, a `404` means the
14286 # resource was not found.
14287 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14288 # defined by the server.
14289 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14290 # This value is inRFC3339
14291 # text format.
14292 &quot;instancesBulkInsertOperationMetadata&quot;: {
14293 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14294 # Example key: zones/us-central1-a
14295 &quot;a_key&quot;: {
14296 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14297 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14298 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14299 # error.
14300 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14301 # if the flow is rolling forward or rolling back.
14302 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14303 },
14304 },
14305 },
14306 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14307 # Operation resources.
14308 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14309 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14310 # group of operations results from a `bulkInsert` API request.
14311 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14312 # `update`, or `delete`, and so on.
14313 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14314 # There is no requirement that this be linear or support any granularity of
14315 # operations. This should not be used to guess when the operation will be
14316 # complete. This number should monotonically increase as the operation
14317 # progresses.
14318 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14319 # applicable when performing regional operations.
14320 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14321 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
14322 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14323 # this field will contain information on all underlying zonal actions and
14324 # their state.
14325 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14326 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14327 # Example key: zones/us-central1-a
14328 &quot;a_key&quot;: {
14329 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
14330 # populated.
14331 # different programming environments, including REST APIs and RPC APIs. It is
14332 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14333 # three pieces of data: error code, error message, and error details.
14334 #
14335 # You can find out more about this error model and how to work with it in the
14336 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14337 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14338 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14339 # message types for APIs to use.
14340 {
14341 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14342 },
14343 ],
14344 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14345 # user-facing error message should be localized and sent in the
14346 # google.rpc.Status.details field, or localized by the client.
14347 },
14348 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14349 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14350 },
14351 },
14352 },
14353 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14354 # This value is inRFC3339
14355 # text format.
14356 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14357 # following:
14358 # `PENDING`, `RUNNING`, or `DONE`.
14359 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14360 # operation.
14361 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14362 # of the target resource.
14363 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14364 # operations related to creating a snapshot, this points to the disk
14365 # that the snapshot was created from.
14366 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14367 # `[email protected]` or
14368 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14369 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14370 # operation, this field will be populated.
14371 {
14372 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14373 # Engine returns NO_RESULTS_ON_PAGE if there
14374 # are no results in the response.
14375 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14376 # value format. For example:
14377 #
14378 # &quot;data&quot;: [
14379 # {
14380 # &quot;key&quot;: &quot;scope&quot;,
14381 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14382 # }
14383 {
14384 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14385 # returned. For example, for warnings where there are no results in a list
14386 # request for a particular zone, this key might be scope and
14387 # the key value might be the zone name. Other examples might be a key
14388 # indicating a deprecated resource and a suggested replacement, or a
14389 # warning about invalid network settings (for example, if an instance
14390 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14391 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14392 },
14393 ],
14394 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14395 },
14396 ],
14397 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14398 # applicable when performing per-zone operations.
14399 }</pre>
14400 </div>
14401
14402 <div class="method">
14403 <code class="details" id="patchPerInstanceConfigs">patchPerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14404 <pre>Inserts or patches per-instance configurations for the managed instance
14405 group. perInstanceConfig.name serves as a key used to
14406 distinguish whether to perform insert or patch.
14407
14408 Args:
14409 project: string, Project ID for this request. (required)
14410 zone: string, The name of thezone
14411 where the managed instance group is located.
14412 It should conform to RFC1035. (required)
14413 instanceGroupManager: string, The name of the managed instance group.
14414 It should conform to RFC1035. (required)
14415 body: object, The request body.
14416 The object takes the form of:
14417
14418 { # InstanceGroupManagers.patchPerInstanceConfigs
14419 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
14420 # instance group.
14421 {
14422 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
14423 # optimistic locking. It is ignored when inserting a per-instance
14424 # config. An up-to-date fingerprint must be provided in order to update an
14425 # existing per-instance configuration or the field needs to be unset.
14426 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
14427 # Serves as a merge key during UpdatePerInstanceConfigs
14428 # operations, that is, if a per-instance configuration with the same name
14429 # exists then it will be updated, otherwise a new one will be created for the
14430 # VM instance with the same name. An attempt to create a per-instance
14431 # configuration for a VM instance that either doesn&#x27;t exist or is not part
14432 # of the group will result in an error.
14433 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
14434 # preserved state generated from a stateful policy.
14435 &quot;disks&quot;: { # Preserved disks defined for this instance.
14436 # This map is keyed with the device names of the disks.
14437 &quot;a_key&quot;: {
14438 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
14439 # update, instance recreate operations. This flag is used to configure
14440 # if the disk should be deleted after it is no longer used by the group,
14441 # e.g. when the given instance or the whole MIG is deleted.
14442 # Note: disks attached in READ_ONLY mode cannot be
14443 # auto-deleted.
14444 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
14445 # disk in READ_WRITE mode.
14446 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
14447 # to the VM instance.
14448 },
14449 },
14450 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
14451 # This map is keyed with the name of the network interface.
14452 &quot;a_key&quot;: {
14453 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
14454 # update or VM instance recreate operations.
14455 # This flag is used to configure if the IP reservation should be deleted
14456 # after it is no longer used by the group, e.g. when the given instance
14457 # or the whole group is deleted.
14458 &quot;ipAddress&quot;: { # Ip address representation
14459 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
14460 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
14461 # network interface.
14462 },
14463 },
14464 },
14465 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
14466 # This map is keyed with the name of the network interface.
14467 &quot;a_key&quot;: {
14468 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
14469 # update or VM instance recreate operations.
14470 # This flag is used to configure if the IP reservation should be deleted
14471 # after it is no longer used by the group, e.g. when the given instance
14472 # or the whole group is deleted.
14473 &quot;ipAddress&quot;: { # Ip address representation
14474 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
14475 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
14476 # network interface.
14477 },
14478 },
14479 },
14480 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
14481 &quot;a_key&quot;: &quot;A String&quot;,
14482 },
14483 },
14484 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
14485 # managed instance.
14486 },
14487 ],
14488 }
14489
14490 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14491 that if you must retry your request, the server will know to ignore the
14492 request if it has already been completed.
14493
14494 For example, consider a situation where you make an initial request and
14495 the request times out. If you make the request again with the same
14496 request ID, the server can check if original operation with the same
14497 request ID was received, and if so, will ignore the second request. This
14498 prevents clients from accidentally creating duplicate commitments.
14499
14500 The request ID must be
14501 a valid UUID with the exception that zero UUID is not supported
14502 (00000000-0000-0000-0000-000000000000).
14503 x__xgafv: string, V1 error format.
14504 Allowed values
14505 1 - v1 error format
14506 2 - v2 error format
14507
14508 Returns:
14509 An object of the form:
14510
14511 { # Represents an Operation resource.
14512 #
14513 # Google Compute Engine has three Operation resources:
14514 #
14515 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14516 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14517 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14518 #
14519 # You can use an operation resource to manage asynchronous API requests.
14520 # For more information, readHandling
14521 # API responses.
14522 #
14523 # Operations can be global, regional or zonal.
14524 #
14525 # - For global operations, use the `globalOperations`
14526 # resource.
14527 # - For regional operations, use the
14528 # `regionOperations` resource.
14529 # - For zonal operations, use
14530 # the `zoneOperations` resource.
14531 #
14532 #
14533 #
14534 # For more information, read
14535 # Global, Regional, and Zonal Resources.
14536 #
14537 # Note that completed Operation resources have a limited
14538 # retention period.
14539 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14540 # Not present otherwise.
14541 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14542 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14543 # set when the operation is created.
14544 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14545 # text format.
14546 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14547 # this field will be populated.
14548 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14549 # operation.
14550 {
14551 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14552 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14553 # details. There is a set of defined message types to use for providing
14554 # details.The syntax depends on the error code. For example,
14555 # QuotaExceededInfo will have details when the error code is
14556 # QUOTA_EXCEEDED.
14557 {
14558 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14559 #
14560 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14561 # is not enabled:
14562 #
14563 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14564 # &quot;domain&quot;: &quot;googleapis.com&quot;
14565 # &quot;metadata&quot;: {
14566 # &quot;resource&quot;: &quot;projects/123&quot;,
14567 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14568 # }
14569 # }
14570 #
14571 # This response indicates that the pubsub.googleapis.com API is not enabled.
14572 #
14573 # Example of an error that is returned when attempting to create a Spanner
14574 # instance in a region that is out of stock:
14575 #
14576 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14577 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14578 # &quot;metadata&quot;: {
14579 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14580 # }
14581 # }
14582 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14583 # is typically the registered service name of the tool or product that
14584 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14585 # generated by some common infrastructure, the error domain must be a
14586 # globally unique value that identifies the infrastructure. For Google API
14587 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14588 &quot;metadatas&quot;: { # Additional structured details about this error.
14589 #
14590 # Keys must match a regular expression of `a-z+` but should
14591 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14592 # length. When identifying the current value of an exceeded limit, the units
14593 # should be contained in the key, not the value. For example, rather than
14594 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14595 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14596 # instances that can be created in a single (batch) request.
14597 &quot;a_key&quot;: &quot;A String&quot;,
14598 },
14599 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14600 # proximate cause of the error. Error reasons are unique within a particular
14601 # domain of errors. This should be at most 63 characters and match a
14602 # regular expression of `A-Z+[A-Z0-9]`, which represents
14603 # UPPER_SNAKE_CASE.
14604 },
14605 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14606 #
14607 # For example, if a quota check failed with an error indicating the calling
14608 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14609 # directly to the right place in the developer console to flip the bit.
14610 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14611 { # Describes a URL link.
14612 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14613 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14614 },
14615 ],
14616 },
14617 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14618 # which can be attached to an RPC error.
14619 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14620 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14621 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14622 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14623 },
14624 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14625 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14626 &quot;a_key&quot;: &quot;A String&quot;,
14627 },
14628 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14629 # type or metric.
14630 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14631 # or metric.
14632 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14633 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14634 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14635 },
14636 },
14637 ],
14638 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14639 # This property is optional.
14640 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14641 },
14642 ],
14643 },
14644 &quot;getVersionOperationMetadata&quot;: {
14645 &quot;inlineSbomInfo&quot;: {
14646 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14647 # appropriate identifiers.
14648 &quot;a_key&quot;: &quot;A String&quot;,
14649 },
14650 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14651 # identifiers.
14652 &quot;a_key&quot;: &quot;A String&quot;,
14653 },
14654 },
14655 },
14656 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14657 # message that was returned, such as `NOT FOUND`.
14658 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14659 # status code that was returned. For example, a `404` means the
14660 # resource was not found.
14661 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14662 # defined by the server.
14663 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14664 # This value is inRFC3339
14665 # text format.
14666 &quot;instancesBulkInsertOperationMetadata&quot;: {
14667 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14668 # Example key: zones/us-central1-a
14669 &quot;a_key&quot;: {
14670 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14671 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14672 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14673 # error.
14674 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14675 # if the flow is rolling forward or rolling back.
14676 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14677 },
14678 },
14679 },
14680 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14681 # Operation resources.
14682 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14683 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14684 # group of operations results from a `bulkInsert` API request.
14685 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14686 # `update`, or `delete`, and so on.
14687 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14688 # There is no requirement that this be linear or support any granularity of
14689 # operations. This should not be used to guess when the operation will be
14690 # complete. This number should monotonically increase as the operation
14691 # progresses.
14692 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14693 # applicable when performing regional operations.
14694 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14695 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
14696 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14697 # this field will contain information on all underlying zonal actions and
14698 # their state.
14699 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14700 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14701 # Example key: zones/us-central1-a
14702 &quot;a_key&quot;: {
14703 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
14704 # populated.
14705 # different programming environments, including REST APIs and RPC APIs. It is
14706 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14707 # three pieces of data: error code, error message, and error details.
14708 #
14709 # You can find out more about this error model and how to work with it in the
14710 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14711 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14712 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14713 # message types for APIs to use.
14714 {
14715 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14716 },
14717 ],
14718 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14719 # user-facing error message should be localized and sent in the
14720 # google.rpc.Status.details field, or localized by the client.
14721 },
14722 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14723 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14724 },
14725 },
14726 },
14727 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14728 # This value is inRFC3339
14729 # text format.
14730 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14731 # following:
14732 # `PENDING`, `RUNNING`, or `DONE`.
14733 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14734 # operation.
14735 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14736 # of the target resource.
14737 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14738 # operations related to creating a snapshot, this points to the disk
14739 # that the snapshot was created from.
14740 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14741 # `[email protected]` or
14742 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14743 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14744 # operation, this field will be populated.
14745 {
14746 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14747 # Engine returns NO_RESULTS_ON_PAGE if there
14748 # are no results in the response.
14749 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14750 # value format. For example:
14751 #
14752 # &quot;data&quot;: [
14753 # {
14754 # &quot;key&quot;: &quot;scope&quot;,
14755 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14756 # }
14757 {
14758 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14759 # returned. For example, for warnings where there are no results in a list
14760 # request for a particular zone, this key might be scope and
14761 # the key value might be the zone name. Other examples might be a key
14762 # indicating a deprecated resource and a suggested replacement, or a
14763 # warning about invalid network settings (for example, if an instance
14764 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14765 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14766 },
14767 ],
14768 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14769 },
14770 ],
14771 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14772 # applicable when performing per-zone operations.
14773 }</pre>
14774 </div>
14775
14776 <div class="method">
14777 <code class="details" id="recreateInstances">recreateInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
14778 <pre>Flags the specified VM instances in the managed instance group to be
14779 immediately recreated. Each instance is recreated using the group&#x27;s current
14780 configuration. This operation is marked as DONE when the flag
14781 is set even if the instances have not yet been recreated. You must
14782 separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
14783 the status of managed instances.
14784
14785 If the group is part of a backend
14786 service that has enabled
14787 connection draining, it can take up to 60 seconds after the connection
14788 draining duration has elapsed before the VM instance is removed or deleted.
14789
14790 You can specify a maximum of 1000 instances with this method per request.
14791
14792 Args:
14793 project: string, Project ID for this request. (required)
14794 zone: string, The name of thezone where the managed
14795 instance group is located. (required)
14796 instanceGroupManager: string, The name of the managed instance group. (required)
14797 body: object, The request body.
14798 The object takes the form of:
14799
14800 {
14801 &quot;instances&quot;: [ # The URLs of one or more instances to recreate. This can be a full URL or
14802 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
14803 &quot;A String&quot;,
14804 ],
14805 }
14806
14807 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance recreation even if it&#x27;s
14808 configured for the instances.
14809 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14810 that if you must retry your request, the server will know to ignore the
14811 request if it has already been completed.
14812
14813 For example, consider a situation where you make an initial request and
14814 the request times out. If you make the request again with the same
14815 request ID, the server can check if original operation with the same
14816 request ID was received, and if so, will ignore the second request. This
14817 prevents clients from accidentally creating duplicate commitments.
14818
14819 The request ID must be
14820 a valid UUID with the exception that zero UUID is not supported
14821 (00000000-0000-0000-0000-000000000000).
14822 x__xgafv: string, V1 error format.
14823 Allowed values
14824 1 - v1 error format
14825 2 - v2 error format
14826
14827 Returns:
14828 An object of the form:
14829
14830 { # Represents an Operation resource.
14831 #
14832 # Google Compute Engine has three Operation resources:
14833 #
14834 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14835 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14836 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14837 #
14838 # You can use an operation resource to manage asynchronous API requests.
14839 # For more information, readHandling
14840 # API responses.
14841 #
14842 # Operations can be global, regional or zonal.
14843 #
14844 # - For global operations, use the `globalOperations`
14845 # resource.
14846 # - For regional operations, use the
14847 # `regionOperations` resource.
14848 # - For zonal operations, use
14849 # the `zoneOperations` resource.
14850 #
14851 #
14852 #
14853 # For more information, read
14854 # Global, Regional, and Zonal Resources.
14855 #
14856 # Note that completed Operation resources have a limited
14857 # retention period.
14858 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14859 # Not present otherwise.
14860 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14861 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14862 # set when the operation is created.
14863 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14864 # text format.
14865 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14866 # this field will be populated.
14867 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14868 # operation.
14869 {
14870 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14871 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14872 # details. There is a set of defined message types to use for providing
14873 # details.The syntax depends on the error code. For example,
14874 # QuotaExceededInfo will have details when the error code is
14875 # QUOTA_EXCEEDED.
14876 {
14877 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14878 #
14879 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14880 # is not enabled:
14881 #
14882 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14883 # &quot;domain&quot;: &quot;googleapis.com&quot;
14884 # &quot;metadata&quot;: {
14885 # &quot;resource&quot;: &quot;projects/123&quot;,
14886 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14887 # }
14888 # }
14889 #
14890 # This response indicates that the pubsub.googleapis.com API is not enabled.
14891 #
14892 # Example of an error that is returned when attempting to create a Spanner
14893 # instance in a region that is out of stock:
14894 #
14895 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14896 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14897 # &quot;metadata&quot;: {
14898 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14899 # }
14900 # }
14901 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14902 # is typically the registered service name of the tool or product that
14903 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14904 # generated by some common infrastructure, the error domain must be a
14905 # globally unique value that identifies the infrastructure. For Google API
14906 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14907 &quot;metadatas&quot;: { # Additional structured details about this error.
14908 #
14909 # Keys must match a regular expression of `a-z+` but should
14910 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14911 # length. When identifying the current value of an exceeded limit, the units
14912 # should be contained in the key, not the value. For example, rather than
14913 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14914 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14915 # instances that can be created in a single (batch) request.
14916 &quot;a_key&quot;: &quot;A String&quot;,
14917 },
14918 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14919 # proximate cause of the error. Error reasons are unique within a particular
14920 # domain of errors. This should be at most 63 characters and match a
14921 # regular expression of `A-Z+[A-Z0-9]`, which represents
14922 # UPPER_SNAKE_CASE.
14923 },
14924 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14925 #
14926 # For example, if a quota check failed with an error indicating the calling
14927 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14928 # directly to the right place in the developer console to flip the bit.
14929 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14930 { # Describes a URL link.
14931 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14932 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14933 },
14934 ],
14935 },
14936 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14937 # which can be attached to an RPC error.
14938 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14939 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14940 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14941 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14942 },
14943 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14944 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14945 &quot;a_key&quot;: &quot;A String&quot;,
14946 },
14947 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14948 # type or metric.
14949 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14950 # or metric.
14951 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14952 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14953 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14954 },
14955 },
14956 ],
14957 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14958 # This property is optional.
14959 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14960 },
14961 ],
14962 },
14963 &quot;getVersionOperationMetadata&quot;: {
14964 &quot;inlineSbomInfo&quot;: {
14965 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14966 # appropriate identifiers.
14967 &quot;a_key&quot;: &quot;A String&quot;,
14968 },
14969 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14970 # identifiers.
14971 &quot;a_key&quot;: &quot;A String&quot;,
14972 },
14973 },
14974 },
14975 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14976 # message that was returned, such as `NOT FOUND`.
14977 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14978 # status code that was returned. For example, a `404` means the
14979 # resource was not found.
14980 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14981 # defined by the server.
14982 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14983 # This value is inRFC3339
14984 # text format.
14985 &quot;instancesBulkInsertOperationMetadata&quot;: {
14986 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14987 # Example key: zones/us-central1-a
14988 &quot;a_key&quot;: {
14989 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14990 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14991 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14992 # error.
14993 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14994 # if the flow is rolling forward or rolling back.
14995 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14996 },
14997 },
14998 },
14999 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15000 # Operation resources.
15001 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15002 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15003 # group of operations results from a `bulkInsert` API request.
15004 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15005 # `update`, or `delete`, and so on.
15006 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15007 # There is no requirement that this be linear or support any granularity of
15008 # operations. This should not be used to guess when the operation will be
15009 # complete. This number should monotonically increase as the operation
15010 # progresses.
15011 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15012 # applicable when performing regional operations.
15013 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15014 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15015 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15016 # this field will contain information on all underlying zonal actions and
15017 # their state.
15018 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15019 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15020 # Example key: zones/us-central1-a
15021 &quot;a_key&quot;: {
15022 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
15023 # populated.
15024 # different programming environments, including REST APIs and RPC APIs. It is
15025 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15026 # three pieces of data: error code, error message, and error details.
15027 #
15028 # You can find out more about this error model and how to work with it in the
15029 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15030 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15031 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15032 # message types for APIs to use.
15033 {
15034 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15035 },
15036 ],
15037 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15038 # user-facing error message should be localized and sent in the
15039 # google.rpc.Status.details field, or localized by the client.
15040 },
15041 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15042 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15043 },
15044 },
15045 },
15046 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15047 # This value is inRFC3339
15048 # text format.
15049 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15050 # following:
15051 # `PENDING`, `RUNNING`, or `DONE`.
15052 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15053 # operation.
15054 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15055 # of the target resource.
15056 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15057 # operations related to creating a snapshot, this points to the disk
15058 # that the snapshot was created from.
15059 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15060 # `[email protected]` or
15061 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15062 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15063 # operation, this field will be populated.
15064 {
15065 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15066 # Engine returns NO_RESULTS_ON_PAGE if there
15067 # are no results in the response.
15068 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15069 # value format. For example:
15070 #
15071 # &quot;data&quot;: [
15072 # {
15073 # &quot;key&quot;: &quot;scope&quot;,
15074 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15075 # }
15076 {
15077 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15078 # returned. For example, for warnings where there are no results in a list
15079 # request for a particular zone, this key might be scope and
15080 # the key value might be the zone name. Other examples might be a key
15081 # indicating a deprecated resource and a suggested replacement, or a
15082 # warning about invalid network settings (for example, if an instance
15083 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15084 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15085 },
15086 ],
15087 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15088 },
15089 ],
15090 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15091 # applicable when performing per-zone operations.
15092 }</pre>
15093 </div>
15094
15095 <div class="method">
15096 <code class="details" id="resize">resize(project, zone, instanceGroupManager, size, requestId=None, x__xgafv=None)</code>
15097 <pre>Resizes the managed instance group. If you increase the size, the group
15098 creates new instances using the current instance template. If you decrease
15099 the size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group
15100 has not yet added or deleted any instances. You must separately
15101 verify the status of the creating or deleting
15102 actions with thelistmanagedinstances
15103 method.
15104
15105 When resizing down, the instance group arbitrarily chooses the order in
15106 which VMs are deleted. The group takes into account some VM attributes when
15107 making the selection including:
15108
15109 + The status of the VM instance.
15110 + The health of the VM instance.
15111 + The instance template version the VM is based on.
15112 + For regional managed instance groups, the location of the VM instance.
15113
15114 This list is subject to change.
15115
15116 If the group is part of a backend
15117 service that has enabled
15118 connection draining, it can take up to 60 seconds after the connection
15119 draining duration has elapsed before the VM instance is removed or deleted.
15120
15121 Args:
15122 project: string, Project ID for this request. (required)
15123 zone: string, The name of thezone where the managed
15124 instance group is located. (required)
15125 instanceGroupManager: string, The name of the managed instance group. (required)
15126 size: integer, The number of running instances that the managed instance group should
15127 maintain at any given time. The group automatically adds or removes
15128 instances to maintain the number of instances specified by this parameter. (required)
15129 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
15130 that if you must retry your request, the server will know to ignore the
15131 request if it has already been completed.
15132
15133 For example, consider a situation where you make an initial request and
15134 the request times out. If you make the request again with the same
15135 request ID, the server can check if original operation with the same
15136 request ID was received, and if so, will ignore the second request. This
15137 prevents clients from accidentally creating duplicate commitments.
15138
15139 The request ID must be
15140 a valid UUID with the exception that zero UUID is not supported
15141 (00000000-0000-0000-0000-000000000000).
15142 x__xgafv: string, V1 error format.
15143 Allowed values
15144 1 - v1 error format
15145 2 - v2 error format
15146
15147 Returns:
15148 An object of the form:
15149
15150 { # Represents an Operation resource.
15151 #
15152 # Google Compute Engine has three Operation resources:
15153 #
15154 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
15155 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
15156 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
15157 #
15158 # You can use an operation resource to manage asynchronous API requests.
15159 # For more information, readHandling
15160 # API responses.
15161 #
15162 # Operations can be global, regional or zonal.
15163 #
15164 # - For global operations, use the `globalOperations`
15165 # resource.
15166 # - For regional operations, use the
15167 # `regionOperations` resource.
15168 # - For zonal operations, use
15169 # the `zoneOperations` resource.
15170 #
15171 #
15172 #
15173 # For more information, read
15174 # Global, Regional, and Zonal Resources.
15175 #
15176 # Note that completed Operation resources have a limited
15177 # retention period.
15178 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
15179 # Not present otherwise.
15180 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
15181 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
15182 # set when the operation is created.
15183 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
15184 # text format.
15185 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
15186 # this field will be populated.
15187 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15188 # operation.
15189 {
15190 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15191 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15192 # details. There is a set of defined message types to use for providing
15193 # details.The syntax depends on the error code. For example,
15194 # QuotaExceededInfo will have details when the error code is
15195 # QUOTA_EXCEEDED.
15196 {
15197 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15198 #
15199 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15200 # is not enabled:
15201 #
15202 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15203 # &quot;domain&quot;: &quot;googleapis.com&quot;
15204 # &quot;metadata&quot;: {
15205 # &quot;resource&quot;: &quot;projects/123&quot;,
15206 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15207 # }
15208 # }
15209 #
15210 # This response indicates that the pubsub.googleapis.com API is not enabled.
15211 #
15212 # Example of an error that is returned when attempting to create a Spanner
15213 # instance in a region that is out of stock:
15214 #
15215 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15216 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15217 # &quot;metadata&quot;: {
15218 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15219 # }
15220 # }
15221 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15222 # is typically the registered service name of the tool or product that
15223 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15224 # generated by some common infrastructure, the error domain must be a
15225 # globally unique value that identifies the infrastructure. For Google API
15226 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15227 &quot;metadatas&quot;: { # Additional structured details about this error.
15228 #
15229 # Keys must match a regular expression of `a-z+` but should
15230 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15231 # length. When identifying the current value of an exceeded limit, the units
15232 # should be contained in the key, not the value. For example, rather than
15233 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15234 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15235 # instances that can be created in a single (batch) request.
15236 &quot;a_key&quot;: &quot;A String&quot;,
15237 },
15238 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15239 # proximate cause of the error. Error reasons are unique within a particular
15240 # domain of errors. This should be at most 63 characters and match a
15241 # regular expression of `A-Z+[A-Z0-9]`, which represents
15242 # UPPER_SNAKE_CASE.
15243 },
15244 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15245 #
15246 # For example, if a quota check failed with an error indicating the calling
15247 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15248 # directly to the right place in the developer console to flip the bit.
15249 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15250 { # Describes a URL link.
15251 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15252 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15253 },
15254 ],
15255 },
15256 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15257 # which can be attached to an RPC error.
15258 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15259 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15260 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15261 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15262 },
15263 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15264 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15265 &quot;a_key&quot;: &quot;A String&quot;,
15266 },
15267 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15268 # type or metric.
15269 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15270 # or metric.
15271 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15272 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15273 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15274 },
15275 },
15276 ],
15277 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15278 # This property is optional.
15279 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15280 },
15281 ],
15282 },
15283 &quot;getVersionOperationMetadata&quot;: {
15284 &quot;inlineSbomInfo&quot;: {
15285 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15286 # appropriate identifiers.
15287 &quot;a_key&quot;: &quot;A String&quot;,
15288 },
15289 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15290 # identifiers.
15291 &quot;a_key&quot;: &quot;A String&quot;,
15292 },
15293 },
15294 },
15295 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15296 # message that was returned, such as `NOT FOUND`.
15297 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15298 # status code that was returned. For example, a `404` means the
15299 # resource was not found.
15300 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15301 # defined by the server.
15302 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15303 # This value is inRFC3339
15304 # text format.
15305 &quot;instancesBulkInsertOperationMetadata&quot;: {
15306 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15307 # Example key: zones/us-central1-a
15308 &quot;a_key&quot;: {
15309 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15310 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15311 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15312 # error.
15313 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15314 # if the flow is rolling forward or rolling back.
15315 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15316 },
15317 },
15318 },
15319 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15320 # Operation resources.
15321 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15322 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15323 # group of operations results from a `bulkInsert` API request.
15324 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15325 # `update`, or `delete`, and so on.
15326 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15327 # There is no requirement that this be linear or support any granularity of
15328 # operations. This should not be used to guess when the operation will be
15329 # complete. This number should monotonically increase as the operation
15330 # progresses.
15331 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15332 # applicable when performing regional operations.
15333 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15334 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15335 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15336 # this field will contain information on all underlying zonal actions and
15337 # their state.
15338 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15339 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15340 # Example key: zones/us-central1-a
15341 &quot;a_key&quot;: {
15342 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
15343 # populated.
15344 # different programming environments, including REST APIs and RPC APIs. It is
15345 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15346 # three pieces of data: error code, error message, and error details.
15347 #
15348 # You can find out more about this error model and how to work with it in the
15349 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15350 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15351 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15352 # message types for APIs to use.
15353 {
15354 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15355 },
15356 ],
15357 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15358 # user-facing error message should be localized and sent in the
15359 # google.rpc.Status.details field, or localized by the client.
15360 },
15361 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15362 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15363 },
15364 },
15365 },
15366 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15367 # This value is inRFC3339
15368 # text format.
15369 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15370 # following:
15371 # `PENDING`, `RUNNING`, or `DONE`.
15372 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15373 # operation.
15374 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15375 # of the target resource.
15376 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15377 # operations related to creating a snapshot, this points to the disk
15378 # that the snapshot was created from.
15379 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15380 # `[email protected]` or
15381 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15382 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15383 # operation, this field will be populated.
15384 {
15385 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15386 # Engine returns NO_RESULTS_ON_PAGE if there
15387 # are no results in the response.
15388 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15389 # value format. For example:
15390 #
15391 # &quot;data&quot;: [
15392 # {
15393 # &quot;key&quot;: &quot;scope&quot;,
15394 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15395 # }
15396 {
15397 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15398 # returned. For example, for warnings where there are no results in a list
15399 # request for a particular zone, this key might be scope and
15400 # the key value might be the zone name. Other examples might be a key
15401 # indicating a deprecated resource and a suggested replacement, or a
15402 # warning about invalid network settings (for example, if an instance
15403 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15404 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15405 },
15406 ],
15407 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15408 },
15409 ],
15410 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15411 # applicable when performing per-zone operations.
15412 }</pre>
15413 </div>
15414
15415 <div class="method">
15416 <code class="details" id="resizeAdvanced">resizeAdvanced(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
15417 <pre>Resizes the managed instance group with advanced configuration options like
15418 disabling creation retries. This is an extended version of theresize method.
15419
15420 If you increase the size of the instance group, the group creates new
15421 instances using the current instance template. If you decrease the size,
15422 the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group
15423 has not yet added or deleted any instances. You must separately
15424 verify the status of the creating,creatingWithoutRetries, or deleting actions with
15425 the get
15426 orlistmanagedinstances
15427 method.
15428
15429 If the group is part of a backend
15430 service that has enabled
15431 connection draining, it can take up to 60 seconds after the connection
15432 draining duration has elapsed before the VM instance is removed or deleted.
15433
15434 Args:
15435 project: string, Project ID for this request. (required)
15436 zone: string, The name of thezone where the managed
15437 instance group is located. (required)
15438 instanceGroupManager: string, The name of the managed instance group. (required)
15439 body: object, The request body.
15440 The object takes the form of:
15441
15442 {
15443 &quot;noCreationRetries&quot;: True or False, # If this flag is true, the managed instance group attempts to create all
15444 # instances initiated by this resize request only once. If there is an error
15445 # during creation, the managed instance group does not retry create this
15446 # instance, and we will decrease the targetSize of the request
15447 # instead. If the flag is false, the group attempts to recreate each instance
15448 # continuously until it succeeds.
15449 #
15450 # This flag matters only in the first attempt of creation of an instance.
15451 # After an instance is successfully created while this flag is enabled, the
15452 # instance behaves the same way as all the other instances created with a
15453 # regular resize request. In particular, if a running instance dies
15454 # unexpectedly at a later time and needs to be recreated, this mode does not
15455 # affect the recreation behavior in that scenario.
15456 #
15457 # This flag is applicable only to the current resize request. It does not
15458 # influence other resize requests in any way.
15459 #
15460 # You can see which instances is being creating in which mode by calling
15461 # the get or listManagedInstances API.
15462 &quot;scaleInProtection&quot;: True or False, # If this flag is enabled within a request to decrease a MIG&#x27;s target size,
15463 # then the MIG declines that request.
15464 &quot;targetSize&quot;: 42, # The number of running instances that the managed instance group should
15465 # maintain at any given time. The group automatically adds or removes
15466 # instances to maintain the number of instances specified by this parameter.
15467 }
15468
15469 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
15470 that if you must retry your request, the server will know to ignore the
15471 request if it has already been completed.
15472
15473 For example, consider a situation where you make an initial request and
15474 the request times out. If you make the request again with the same
15475 request ID, the server can check if original operation with the same
15476 request ID was received, and if so, will ignore the second request. This
15477 prevents clients from accidentally creating duplicate commitments.
15478
15479 The request ID must be
15480 a valid UUID with the exception that zero UUID is not supported
15481 (00000000-0000-0000-0000-000000000000).
15482 x__xgafv: string, V1 error format.
15483 Allowed values
15484 1 - v1 error format
15485 2 - v2 error format
15486
15487 Returns:
15488 An object of the form:
15489
15490 { # Represents an Operation resource.
15491 #
15492 # Google Compute Engine has three Operation resources:
15493 #
15494 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
15495 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
15496 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
15497 #
15498 # You can use an operation resource to manage asynchronous API requests.
15499 # For more information, readHandling
15500 # API responses.
15501 #
15502 # Operations can be global, regional or zonal.
15503 #
15504 # - For global operations, use the `globalOperations`
15505 # resource.
15506 # - For regional operations, use the
15507 # `regionOperations` resource.
15508 # - For zonal operations, use
15509 # the `zoneOperations` resource.
15510 #
15511 #
15512 #
15513 # For more information, read
15514 # Global, Regional, and Zonal Resources.
15515 #
15516 # Note that completed Operation resources have a limited
15517 # retention period.
15518 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
15519 # Not present otherwise.
15520 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
15521 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
15522 # set when the operation is created.
15523 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
15524 # text format.
15525 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
15526 # this field will be populated.
15527 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15528 # operation.
15529 {
15530 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15531 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15532 # details. There is a set of defined message types to use for providing
15533 # details.The syntax depends on the error code. For example,
15534 # QuotaExceededInfo will have details when the error code is
15535 # QUOTA_EXCEEDED.
15536 {
15537 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15538 #
15539 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15540 # is not enabled:
15541 #
15542 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15543 # &quot;domain&quot;: &quot;googleapis.com&quot;
15544 # &quot;metadata&quot;: {
15545 # &quot;resource&quot;: &quot;projects/123&quot;,
15546 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15547 # }
15548 # }
15549 #
15550 # This response indicates that the pubsub.googleapis.com API is not enabled.
15551 #
15552 # Example of an error that is returned when attempting to create a Spanner
15553 # instance in a region that is out of stock:
15554 #
15555 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15556 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15557 # &quot;metadata&quot;: {
15558 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15559 # }
15560 # }
15561 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15562 # is typically the registered service name of the tool or product that
15563 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15564 # generated by some common infrastructure, the error domain must be a
15565 # globally unique value that identifies the infrastructure. For Google API
15566 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15567 &quot;metadatas&quot;: { # Additional structured details about this error.
15568 #
15569 # Keys must match a regular expression of `a-z+` but should
15570 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15571 # length. When identifying the current value of an exceeded limit, the units
15572 # should be contained in the key, not the value. For example, rather than
15573 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15574 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15575 # instances that can be created in a single (batch) request.
15576 &quot;a_key&quot;: &quot;A String&quot;,
15577 },
15578 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15579 # proximate cause of the error. Error reasons are unique within a particular
15580 # domain of errors. This should be at most 63 characters and match a
15581 # regular expression of `A-Z+[A-Z0-9]`, which represents
15582 # UPPER_SNAKE_CASE.
15583 },
15584 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15585 #
15586 # For example, if a quota check failed with an error indicating the calling
15587 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15588 # directly to the right place in the developer console to flip the bit.
15589 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15590 { # Describes a URL link.
15591 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15592 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15593 },
15594 ],
15595 },
15596 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15597 # which can be attached to an RPC error.
15598 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15599 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15600 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15601 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15602 },
15603 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15604 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15605 &quot;a_key&quot;: &quot;A String&quot;,
15606 },
15607 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15608 # type or metric.
15609 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15610 # or metric.
15611 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15612 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15613 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15614 },
15615 },
15616 ],
15617 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15618 # This property is optional.
15619 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15620 },
15621 ],
15622 },
15623 &quot;getVersionOperationMetadata&quot;: {
15624 &quot;inlineSbomInfo&quot;: {
15625 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15626 # appropriate identifiers.
15627 &quot;a_key&quot;: &quot;A String&quot;,
15628 },
15629 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15630 # identifiers.
15631 &quot;a_key&quot;: &quot;A String&quot;,
15632 },
15633 },
15634 },
15635 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15636 # message that was returned, such as `NOT FOUND`.
15637 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15638 # status code that was returned. For example, a `404` means the
15639 # resource was not found.
15640 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15641 # defined by the server.
15642 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15643 # This value is inRFC3339
15644 # text format.
15645 &quot;instancesBulkInsertOperationMetadata&quot;: {
15646 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15647 # Example key: zones/us-central1-a
15648 &quot;a_key&quot;: {
15649 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15650 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15651 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15652 # error.
15653 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15654 # if the flow is rolling forward or rolling back.
15655 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15656 },
15657 },
15658 },
15659 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15660 # Operation resources.
15661 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15662 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15663 # group of operations results from a `bulkInsert` API request.
15664 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15665 # `update`, or `delete`, and so on.
15666 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15667 # There is no requirement that this be linear or support any granularity of
15668 # operations. This should not be used to guess when the operation will be
15669 # complete. This number should monotonically increase as the operation
15670 # progresses.
15671 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15672 # applicable when performing regional operations.
15673 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15674 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15675 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15676 # this field will contain information on all underlying zonal actions and
15677 # their state.
15678 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15679 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15680 # Example key: zones/us-central1-a
15681 &quot;a_key&quot;: {
15682 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
15683 # populated.
15684 # different programming environments, including REST APIs and RPC APIs. It is
15685 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15686 # three pieces of data: error code, error message, and error details.
15687 #
15688 # You can find out more about this error model and how to work with it in the
15689 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15690 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15691 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15692 # message types for APIs to use.
15693 {
15694 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15695 },
15696 ],
15697 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15698 # user-facing error message should be localized and sent in the
15699 # google.rpc.Status.details field, or localized by the client.
15700 },
15701 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15702 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15703 },
15704 },
15705 },
15706 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15707 # This value is inRFC3339
15708 # text format.
15709 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15710 # following:
15711 # `PENDING`, `RUNNING`, or `DONE`.
15712 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15713 # operation.
15714 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15715 # of the target resource.
15716 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15717 # operations related to creating a snapshot, this points to the disk
15718 # that the snapshot was created from.
15719 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15720 # `[email protected]` or
15721 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15722 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15723 # operation, this field will be populated.
15724 {
15725 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15726 # Engine returns NO_RESULTS_ON_PAGE if there
15727 # are no results in the response.
15728 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15729 # value format. For example:
15730 #
15731 # &quot;data&quot;: [
15732 # {
15733 # &quot;key&quot;: &quot;scope&quot;,
15734 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15735 # }
15736 {
15737 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15738 # returned. For example, for warnings where there are no results in a list
15739 # request for a particular zone, this key might be scope and
15740 # the key value might be the zone name. Other examples might be a key
15741 # indicating a deprecated resource and a suggested replacement, or a
15742 # warning about invalid network settings (for example, if an instance
15743 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15744 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15745 },
15746 ],
15747 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15748 },
15749 ],
15750 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15751 # applicable when performing per-zone operations.
15752 }</pre>
15753 </div>
15754
15755 <div class="method">
15756 <code class="details" id="resumeInstances">resumeInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
15757 <pre>Flags the specified instances in the managed instance group to be
15758 resumed. This method increases thetargetSize and decreases the targetSuspendedSize
15759 of the managed instance group by the number of instances that you resume.
15760 The resumeInstances operation is marked DONE if
15761 the resumeInstances request is successful. The underlying
15762 actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
15763 method.
15764
15765 In this request, you can only specify instances that are suspended. For
15766 example, if an instance was previously suspended using the suspendInstances
15767 method, it can be resumed using the resumeInstances method.
15768
15769 If a health check is attached to the managed instance group, the specified
15770 instances will be verified as healthy after they are resumed.
15771
15772 You can specify a maximum of 1000 instances with this method per request.
15773
15774 Args:
15775 project: string, Project ID for this request. (required)
15776 zone: string, The name of thezone where the managed
15777 instance group is located. (required)
15778 instanceGroupManager: string, The name of the managed instance group. (required)
15779 body: object, The request body.
15780 The object takes the form of:
15781
15782 {
15783 &quot;instances&quot;: [ # The URLs of one or more instances to resume. This can be a full URL or
15784 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
15785 &quot;A String&quot;,
15786 ],
15787 }
15788
15789 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
15790 that if you must retry your request, the server will know to ignore the
15791 request if it has already been completed.
15792
15793 For example, consider a situation where you make an initial request and
15794 the request times out. If you make the request again with the same
15795 request ID, the server can check if original operation with the same
15796 request ID was received, and if so, will ignore the second request. This
15797 prevents clients from accidentally creating duplicate commitments.
15798
15799 The request ID must be
15800 a valid UUID with the exception that zero UUID is not supported
15801 (00000000-0000-0000-0000-000000000000).
15802 x__xgafv: string, V1 error format.
15803 Allowed values
15804 1 - v1 error format
15805 2 - v2 error format
15806
15807 Returns:
15808 An object of the form:
15809
15810 { # Represents an Operation resource.
15811 #
15812 # Google Compute Engine has three Operation resources:
15813 #
15814 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
15815 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
15816 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
15817 #
15818 # You can use an operation resource to manage asynchronous API requests.
15819 # For more information, readHandling
15820 # API responses.
15821 #
15822 # Operations can be global, regional or zonal.
15823 #
15824 # - For global operations, use the `globalOperations`
15825 # resource.
15826 # - For regional operations, use the
15827 # `regionOperations` resource.
15828 # - For zonal operations, use
15829 # the `zoneOperations` resource.
15830 #
15831 #
15832 #
15833 # For more information, read
15834 # Global, Regional, and Zonal Resources.
15835 #
15836 # Note that completed Operation resources have a limited
15837 # retention period.
15838 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
15839 # Not present otherwise.
15840 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
15841 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
15842 # set when the operation is created.
15843 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
15844 # text format.
15845 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
15846 # this field will be populated.
15847 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15848 # operation.
15849 {
15850 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15851 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15852 # details. There is a set of defined message types to use for providing
15853 # details.The syntax depends on the error code. For example,
15854 # QuotaExceededInfo will have details when the error code is
15855 # QUOTA_EXCEEDED.
15856 {
15857 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15858 #
15859 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15860 # is not enabled:
15861 #
15862 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15863 # &quot;domain&quot;: &quot;googleapis.com&quot;
15864 # &quot;metadata&quot;: {
15865 # &quot;resource&quot;: &quot;projects/123&quot;,
15866 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15867 # }
15868 # }
15869 #
15870 # This response indicates that the pubsub.googleapis.com API is not enabled.
15871 #
15872 # Example of an error that is returned when attempting to create a Spanner
15873 # instance in a region that is out of stock:
15874 #
15875 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15876 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15877 # &quot;metadata&quot;: {
15878 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15879 # }
15880 # }
15881 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15882 # is typically the registered service name of the tool or product that
15883 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15884 # generated by some common infrastructure, the error domain must be a
15885 # globally unique value that identifies the infrastructure. For Google API
15886 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15887 &quot;metadatas&quot;: { # Additional structured details about this error.
15888 #
15889 # Keys must match a regular expression of `a-z+` but should
15890 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15891 # length. When identifying the current value of an exceeded limit, the units
15892 # should be contained in the key, not the value. For example, rather than
15893 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15894 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15895 # instances that can be created in a single (batch) request.
15896 &quot;a_key&quot;: &quot;A String&quot;,
15897 },
15898 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15899 # proximate cause of the error. Error reasons are unique within a particular
15900 # domain of errors. This should be at most 63 characters and match a
15901 # regular expression of `A-Z+[A-Z0-9]`, which represents
15902 # UPPER_SNAKE_CASE.
15903 },
15904 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15905 #
15906 # For example, if a quota check failed with an error indicating the calling
15907 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15908 # directly to the right place in the developer console to flip the bit.
15909 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15910 { # Describes a URL link.
15911 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15912 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15913 },
15914 ],
15915 },
15916 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15917 # which can be attached to an RPC error.
15918 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15919 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15920 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15921 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15922 },
15923 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15924 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15925 &quot;a_key&quot;: &quot;A String&quot;,
15926 },
15927 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15928 # type or metric.
15929 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15930 # or metric.
15931 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15932 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15933 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15934 },
15935 },
15936 ],
15937 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15938 # This property is optional.
15939 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15940 },
15941 ],
15942 },
15943 &quot;getVersionOperationMetadata&quot;: {
15944 &quot;inlineSbomInfo&quot;: {
15945 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15946 # appropriate identifiers.
15947 &quot;a_key&quot;: &quot;A String&quot;,
15948 },
15949 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15950 # identifiers.
15951 &quot;a_key&quot;: &quot;A String&quot;,
15952 },
15953 },
15954 },
15955 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15956 # message that was returned, such as `NOT FOUND`.
15957 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15958 # status code that was returned. For example, a `404` means the
15959 # resource was not found.
15960 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15961 # defined by the server.
15962 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15963 # This value is inRFC3339
15964 # text format.
15965 &quot;instancesBulkInsertOperationMetadata&quot;: {
15966 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15967 # Example key: zones/us-central1-a
15968 &quot;a_key&quot;: {
15969 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15970 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15971 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15972 # error.
15973 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15974 # if the flow is rolling forward or rolling back.
15975 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15976 },
15977 },
15978 },
15979 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15980 # Operation resources.
15981 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15982 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15983 # group of operations results from a `bulkInsert` API request.
15984 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15985 # `update`, or `delete`, and so on.
15986 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15987 # There is no requirement that this be linear or support any granularity of
15988 # operations. This should not be used to guess when the operation will be
15989 # complete. This number should monotonically increase as the operation
15990 # progresses.
15991 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15992 # applicable when performing regional operations.
15993 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15994 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15995 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15996 # this field will contain information on all underlying zonal actions and
15997 # their state.
15998 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15999 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16000 # Example key: zones/us-central1-a
16001 &quot;a_key&quot;: {
16002 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
16003 # populated.
16004 # different programming environments, including REST APIs and RPC APIs. It is
16005 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16006 # three pieces of data: error code, error message, and error details.
16007 #
16008 # You can find out more about this error model and how to work with it in the
16009 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16010 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16011 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16012 # message types for APIs to use.
16013 {
16014 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16015 },
16016 ],
16017 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
16018 # user-facing error message should be localized and sent in the
16019 # google.rpc.Status.details field, or localized by the client.
16020 },
16021 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
16022 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
16023 },
16024 },
16025 },
16026 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
16027 # This value is inRFC3339
16028 # text format.
16029 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
16030 # following:
16031 # `PENDING`, `RUNNING`, or `DONE`.
16032 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
16033 # operation.
16034 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
16035 # of the target resource.
16036 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
16037 # operations related to creating a snapshot, this points to the disk
16038 # that the snapshot was created from.
16039 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
16040 # `[email protected]` or
16041 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
16042 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
16043 # operation, this field will be populated.
16044 {
16045 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16046 # Engine returns NO_RESULTS_ON_PAGE if there
16047 # are no results in the response.
16048 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16049 # value format. For example:
16050 #
16051 # &quot;data&quot;: [
16052 # {
16053 # &quot;key&quot;: &quot;scope&quot;,
16054 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16055 # }
16056 {
16057 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16058 # returned. For example, for warnings where there are no results in a list
16059 # request for a particular zone, this key might be scope and
16060 # the key value might be the zone name. Other examples might be a key
16061 # indicating a deprecated resource and a suggested replacement, or a
16062 # warning about invalid network settings (for example, if an instance
16063 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16064 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16065 },
16066 ],
16067 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16068 },
16069 ],
16070 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16071 # applicable when performing per-zone operations.
16072 }</pre>
16073 </div>
16074
16075 <div class="method">
16076 <code class="details" id="setAutoHealingPolicies">setAutoHealingPolicies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
16077 <pre>Motifies the autohealing policy for the instances in this managed
16078 instance group.
16079 [Deprecated] This method is deprecated. UseinstanceGroupManagers.patch instead.
16080
16081 Args:
16082 project: string, Project ID for this request. (required)
16083 zone: string, The name of thezone where the managed
16084 instance group is located. (required)
16085 instanceGroupManager: string, The name of the instance group manager. (required)
16086 body: object, The request body.
16087 The object takes the form of:
16088
16089 {
16090 &quot;autoHealingPolicies&quot;: [
16091 {
16092 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
16093 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
16094 # this field controls whether to trigger VM autohealing based on a failed
16095 # health check. Valid values are:
16096 #
16097 # - ON (default): The group recreates running VMs that
16098 # fail the application-based health check.
16099 # - OFF: When set to OFF, you can still observe instance
16100 # health state, but the group does not recreate VMs that fail the
16101 # application-based health check. This is useful for troubleshooting and
16102 # setting up your health check configuration.
16103 },
16104 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
16105 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
16106 # initialize and run its startup script. During a VM&#x27;s initial delay
16107 # period, the MIG ignores unsuccessful health checks because the VM might
16108 # be in the startup process. This prevents the MIG from prematurely
16109 # recreating a VM. If the health check receives a healthy response during
16110 # the initial delay, it indicates that the startup process is complete and
16111 # the VM is ready. The value of initial delay must be between 0 and 3600
16112 # seconds. The default value is 0.
16113 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
16114 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
16115 # The instance is considered available if all of the following conditions
16116 # are satisfied:
16117 # 1. Instance&#x27;s status is RUNNING.
16118 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
16119 # check result was observed to be HEALTHY at least once as it passed
16120 # VERIFYING).
16121 # 3. There is no outgoing action on an instance triggered by IGM.
16122 #
16123 # By default, number of concurrently autohealed instances is smaller than
16124 # the managed instance group target size. However, if a zonal managed
16125 # instance group has only one instance, or a regional managed instance
16126 # group has only one instance per zone, autohealing will recreate these
16127 # instances when they become unhealthy.
16128 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
16129 #
16130 #
16131 #
16132 # - If the value is fixed, then the calculated
16133 # value is equal to the fixed value.
16134 # - If the value is a percent, then the
16135 # calculated
16136 # value is percent/100 * targetSize. For example,
16137 # the calculated value of a 80% of a managed instance group
16138 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
16139 # is a remainder, the number is rounded.
16140 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
16141 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
16142 # example, specify 80 for 80%.
16143 },
16144 },
16145 ],
16146 }
16147
16148 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
16149 that if you must retry your request, the server will know to ignore the
16150 request if it has already been completed.
16151
16152 For example, consider a situation where you make an initial request and
16153 the request times out. If you make the request again with the same
16154 request ID, the server can check if original operation with the same
16155 request ID was received, and if so, will ignore the second request. This
16156 prevents clients from accidentally creating duplicate commitments.
16157
16158 The request ID must be
16159 a valid UUID with the exception that zero UUID is not supported
16160 (00000000-0000-0000-0000-000000000000).
16161 x__xgafv: string, V1 error format.
16162 Allowed values
16163 1 - v1 error format
16164 2 - v2 error format
16165
16166 Returns:
16167 An object of the form:
16168
16169 { # Represents an Operation resource.
16170 #
16171 # Google Compute Engine has three Operation resources:
16172 #
16173 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
16174 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
16175 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
16176 #
16177 # You can use an operation resource to manage asynchronous API requests.
16178 # For more information, readHandling
16179 # API responses.
16180 #
16181 # Operations can be global, regional or zonal.
16182 #
16183 # - For global operations, use the `globalOperations`
16184 # resource.
16185 # - For regional operations, use the
16186 # `regionOperations` resource.
16187 # - For zonal operations, use
16188 # the `zoneOperations` resource.
16189 #
16190 #
16191 #
16192 # For more information, read
16193 # Global, Regional, and Zonal Resources.
16194 #
16195 # Note that completed Operation resources have a limited
16196 # retention period.
16197 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
16198 # Not present otherwise.
16199 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
16200 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
16201 # set when the operation is created.
16202 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
16203 # text format.
16204 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
16205 # this field will be populated.
16206 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
16207 # operation.
16208 {
16209 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
16210 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
16211 # details. There is a set of defined message types to use for providing
16212 # details.The syntax depends on the error code. For example,
16213 # QuotaExceededInfo will have details when the error code is
16214 # QUOTA_EXCEEDED.
16215 {
16216 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
16217 #
16218 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
16219 # is not enabled:
16220 #
16221 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
16222 # &quot;domain&quot;: &quot;googleapis.com&quot;
16223 # &quot;metadata&quot;: {
16224 # &quot;resource&quot;: &quot;projects/123&quot;,
16225 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
16226 # }
16227 # }
16228 #
16229 # This response indicates that the pubsub.googleapis.com API is not enabled.
16230 #
16231 # Example of an error that is returned when attempting to create a Spanner
16232 # instance in a region that is out of stock:
16233 #
16234 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
16235 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
16236 # &quot;metadata&quot;: {
16237 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
16238 # }
16239 # }
16240 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
16241 # is typically the registered service name of the tool or product that
16242 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
16243 # generated by some common infrastructure, the error domain must be a
16244 # globally unique value that identifies the infrastructure. For Google API
16245 # infrastructure, the error domain is &quot;googleapis.com&quot;.
16246 &quot;metadatas&quot;: { # Additional structured details about this error.
16247 #
16248 # Keys must match a regular expression of `a-z+` but should
16249 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
16250 # length. When identifying the current value of an exceeded limit, the units
16251 # should be contained in the key, not the value. For example, rather than
16252 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
16253 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
16254 # instances that can be created in a single (batch) request.
16255 &quot;a_key&quot;: &quot;A String&quot;,
16256 },
16257 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
16258 # proximate cause of the error. Error reasons are unique within a particular
16259 # domain of errors. This should be at most 63 characters and match a
16260 # regular expression of `A-Z+[A-Z0-9]`, which represents
16261 # UPPER_SNAKE_CASE.
16262 },
16263 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
16264 #
16265 # For example, if a quota check failed with an error indicating the calling
16266 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
16267 # directly to the right place in the developer console to flip the bit.
16268 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
16269 { # Describes a URL link.
16270 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
16271 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
16272 },
16273 ],
16274 },
16275 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
16276 # which can be attached to an RPC error.
16277 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
16278 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
16279 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
16280 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
16281 },
16282 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
16283 &quot;dimensions&quot;: { # The map holding related quota dimensions.
16284 &quot;a_key&quot;: &quot;A String&quot;,
16285 },
16286 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
16287 # type or metric.
16288 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
16289 # or metric.
16290 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
16291 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
16292 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
16293 },
16294 },
16295 ],
16296 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
16297 # This property is optional.
16298 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
16299 },
16300 ],
16301 },
16302 &quot;getVersionOperationMetadata&quot;: {
16303 &quot;inlineSbomInfo&quot;: {
16304 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
16305 # appropriate identifiers.
16306 &quot;a_key&quot;: &quot;A String&quot;,
16307 },
16308 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
16309 # identifiers.
16310 &quot;a_key&quot;: &quot;A String&quot;,
16311 },
16312 },
16313 },
16314 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
16315 # message that was returned, such as `NOT FOUND`.
16316 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
16317 # status code that was returned. For example, a `404` means the
16318 # resource was not found.
16319 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
16320 # defined by the server.
16321 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
16322 # This value is inRFC3339
16323 # text format.
16324 &quot;instancesBulkInsertOperationMetadata&quot;: {
16325 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
16326 # Example key: zones/us-central1-a
16327 &quot;a_key&quot;: {
16328 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
16329 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
16330 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
16331 # error.
16332 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
16333 # if the flow is rolling forward or rolling back.
16334 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
16335 },
16336 },
16337 },
16338 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
16339 # Operation resources.
16340 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
16341 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
16342 # group of operations results from a `bulkInsert` API request.
16343 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
16344 # `update`, or `delete`, and so on.
16345 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
16346 # There is no requirement that this be linear or support any granularity of
16347 # operations. This should not be used to guess when the operation will be
16348 # complete. This number should monotonically increase as the operation
16349 # progresses.
16350 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
16351 # applicable when performing regional operations.
16352 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16353 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
16354 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
16355 # this field will contain information on all underlying zonal actions and
16356 # their state.
16357 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
16358 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16359 # Example key: zones/us-central1-a
16360 &quot;a_key&quot;: {
16361 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
16362 # populated.
16363 # different programming environments, including REST APIs and RPC APIs. It is
16364 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16365 # three pieces of data: error code, error message, and error details.
16366 #
16367 # You can find out more about this error model and how to work with it in the
16368 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16369 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16370 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16371 # message types for APIs to use.
16372 {
16373 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16374 },
16375 ],
16376 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
16377 # user-facing error message should be localized and sent in the
16378 # google.rpc.Status.details field, or localized by the client.
16379 },
16380 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
16381 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
16382 },
16383 },
16384 },
16385 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
16386 # This value is inRFC3339
16387 # text format.
16388 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
16389 # following:
16390 # `PENDING`, `RUNNING`, or `DONE`.
16391 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
16392 # operation.
16393 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
16394 # of the target resource.
16395 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
16396 # operations related to creating a snapshot, this points to the disk
16397 # that the snapshot was created from.
16398 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
16399 # `[email protected]` or
16400 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
16401 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
16402 # operation, this field will be populated.
16403 {
16404 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16405 # Engine returns NO_RESULTS_ON_PAGE if there
16406 # are no results in the response.
16407 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16408 # value format. For example:
16409 #
16410 # &quot;data&quot;: [
16411 # {
16412 # &quot;key&quot;: &quot;scope&quot;,
16413 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16414 # }
16415 {
16416 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16417 # returned. For example, for warnings where there are no results in a list
16418 # request for a particular zone, this key might be scope and
16419 # the key value might be the zone name. Other examples might be a key
16420 # indicating a deprecated resource and a suggested replacement, or a
16421 # warning about invalid network settings (for example, if an instance
16422 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16423 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16424 },
16425 ],
16426 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16427 },
16428 ],
16429 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16430 # applicable when performing per-zone operations.
16431 }</pre>
16432 </div>
16433
16434 <div class="method">
16435 <code class="details" id="setInstanceTemplate">setInstanceTemplate(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
16436 <pre>Specifies the instance template to use when creating new instances in this
16437 group. The templates for existing instances in the group do not change
16438 unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
16439
16440 Args:
16441 project: string, Project ID for this request. (required)
16442 zone: string, The name of thezone where the managed
16443 instance group is located. (required)
16444 instanceGroupManager: string, The name of the managed instance group. (required)
16445 body: object, The request body.
16446 The object takes the form of:
16447
16448 {
16449 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
16450 # instance group. The group uses this template to create all new instances
16451 # in the managed instance group. The templates for existing instances in the
16452 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
16453 }
16454
16455 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
16456 that if you must retry your request, the server will know to ignore the
16457 request if it has already been completed.
16458
16459 For example, consider a situation where you make an initial request and
16460 the request times out. If you make the request again with the same
16461 request ID, the server can check if original operation with the same
16462 request ID was received, and if so, will ignore the second request. This
16463 prevents clients from accidentally creating duplicate commitments.
16464
16465 The request ID must be
16466 a valid UUID with the exception that zero UUID is not supported
16467 (00000000-0000-0000-0000-000000000000).
16468 x__xgafv: string, V1 error format.
16469 Allowed values
16470 1 - v1 error format
16471 2 - v2 error format
16472
16473 Returns:
16474 An object of the form:
16475
16476 { # Represents an Operation resource.
16477 #
16478 # Google Compute Engine has three Operation resources:
16479 #
16480 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
16481 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
16482 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
16483 #
16484 # You can use an operation resource to manage asynchronous API requests.
16485 # For more information, readHandling
16486 # API responses.
16487 #
16488 # Operations can be global, regional or zonal.
16489 #
16490 # - For global operations, use the `globalOperations`
16491 # resource.
16492 # - For regional operations, use the
16493 # `regionOperations` resource.
16494 # - For zonal operations, use
16495 # the `zoneOperations` resource.
16496 #
16497 #
16498 #
16499 # For more information, read
16500 # Global, Regional, and Zonal Resources.
16501 #
16502 # Note that completed Operation resources have a limited
16503 # retention period.
16504 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
16505 # Not present otherwise.
16506 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
16507 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
16508 # set when the operation is created.
16509 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
16510 # text format.
16511 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
16512 # this field will be populated.
16513 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
16514 # operation.
16515 {
16516 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
16517 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
16518 # details. There is a set of defined message types to use for providing
16519 # details.The syntax depends on the error code. For example,
16520 # QuotaExceededInfo will have details when the error code is
16521 # QUOTA_EXCEEDED.
16522 {
16523 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
16524 #
16525 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
16526 # is not enabled:
16527 #
16528 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
16529 # &quot;domain&quot;: &quot;googleapis.com&quot;
16530 # &quot;metadata&quot;: {
16531 # &quot;resource&quot;: &quot;projects/123&quot;,
16532 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
16533 # }
16534 # }
16535 #
16536 # This response indicates that the pubsub.googleapis.com API is not enabled.
16537 #
16538 # Example of an error that is returned when attempting to create a Spanner
16539 # instance in a region that is out of stock:
16540 #
16541 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
16542 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
16543 # &quot;metadata&quot;: {
16544 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
16545 # }
16546 # }
16547 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
16548 # is typically the registered service name of the tool or product that
16549 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
16550 # generated by some common infrastructure, the error domain must be a
16551 # globally unique value that identifies the infrastructure. For Google API
16552 # infrastructure, the error domain is &quot;googleapis.com&quot;.
16553 &quot;metadatas&quot;: { # Additional structured details about this error.
16554 #
16555 # Keys must match a regular expression of `a-z+` but should
16556 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
16557 # length. When identifying the current value of an exceeded limit, the units
16558 # should be contained in the key, not the value. For example, rather than
16559 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
16560 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
16561 # instances that can be created in a single (batch) request.
16562 &quot;a_key&quot;: &quot;A String&quot;,
16563 },
16564 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
16565 # proximate cause of the error. Error reasons are unique within a particular
16566 # domain of errors. This should be at most 63 characters and match a
16567 # regular expression of `A-Z+[A-Z0-9]`, which represents
16568 # UPPER_SNAKE_CASE.
16569 },
16570 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
16571 #
16572 # For example, if a quota check failed with an error indicating the calling
16573 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
16574 # directly to the right place in the developer console to flip the bit.
16575 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
16576 { # Describes a URL link.
16577 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
16578 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
16579 },
16580 ],
16581 },
16582 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
16583 # which can be attached to an RPC error.
16584 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
16585 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
16586 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
16587 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
16588 },
16589 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
16590 &quot;dimensions&quot;: { # The map holding related quota dimensions.
16591 &quot;a_key&quot;: &quot;A String&quot;,
16592 },
16593 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
16594 # type or metric.
16595 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
16596 # or metric.
16597 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
16598 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
16599 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
16600 },
16601 },
16602 ],
16603 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
16604 # This property is optional.
16605 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
16606 },
16607 ],
16608 },
16609 &quot;getVersionOperationMetadata&quot;: {
16610 &quot;inlineSbomInfo&quot;: {
16611 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
16612 # appropriate identifiers.
16613 &quot;a_key&quot;: &quot;A String&quot;,
16614 },
16615 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
16616 # identifiers.
16617 &quot;a_key&quot;: &quot;A String&quot;,
16618 },
16619 },
16620 },
16621 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
16622 # message that was returned, such as `NOT FOUND`.
16623 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
16624 # status code that was returned. For example, a `404` means the
16625 # resource was not found.
16626 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
16627 # defined by the server.
16628 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
16629 # This value is inRFC3339
16630 # text format.
16631 &quot;instancesBulkInsertOperationMetadata&quot;: {
16632 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
16633 # Example key: zones/us-central1-a
16634 &quot;a_key&quot;: {
16635 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
16636 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
16637 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
16638 # error.
16639 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
16640 # if the flow is rolling forward or rolling back.
16641 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
16642 },
16643 },
16644 },
16645 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
16646 # Operation resources.
16647 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
16648 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
16649 # group of operations results from a `bulkInsert` API request.
16650 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
16651 # `update`, or `delete`, and so on.
16652 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
16653 # There is no requirement that this be linear or support any granularity of
16654 # operations. This should not be used to guess when the operation will be
16655 # complete. This number should monotonically increase as the operation
16656 # progresses.
16657 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
16658 # applicable when performing regional operations.
16659 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16660 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
16661 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
16662 # this field will contain information on all underlying zonal actions and
16663 # their state.
16664 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
16665 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16666 # Example key: zones/us-central1-a
16667 &quot;a_key&quot;: {
16668 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
16669 # populated.
16670 # different programming environments, including REST APIs and RPC APIs. It is
16671 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16672 # three pieces of data: error code, error message, and error details.
16673 #
16674 # You can find out more about this error model and how to work with it in the
16675 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16676 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16677 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16678 # message types for APIs to use.
16679 {
16680 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16681 },
16682 ],
16683 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
16684 # user-facing error message should be localized and sent in the
16685 # google.rpc.Status.details field, or localized by the client.
16686 },
16687 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
16688 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
16689 },
16690 },
16691 },
16692 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
16693 # This value is inRFC3339
16694 # text format.
16695 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
16696 # following:
16697 # `PENDING`, `RUNNING`, or `DONE`.
16698 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
16699 # operation.
16700 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
16701 # of the target resource.
16702 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
16703 # operations related to creating a snapshot, this points to the disk
16704 # that the snapshot was created from.
16705 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
16706 # `[email protected]` or
16707 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
16708 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
16709 # operation, this field will be populated.
16710 {
16711 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16712 # Engine returns NO_RESULTS_ON_PAGE if there
16713 # are no results in the response.
16714 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16715 # value format. For example:
16716 #
16717 # &quot;data&quot;: [
16718 # {
16719 # &quot;key&quot;: &quot;scope&quot;,
16720 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16721 # }
16722 {
16723 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16724 # returned. For example, for warnings where there are no results in a list
16725 # request for a particular zone, this key might be scope and
16726 # the key value might be the zone name. Other examples might be a key
16727 # indicating a deprecated resource and a suggested replacement, or a
16728 # warning about invalid network settings (for example, if an instance
16729 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16730 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16731 },
16732 ],
16733 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16734 },
16735 ],
16736 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16737 # applicable when performing per-zone operations.
16738 }</pre>
16739 </div>
16740
16741 <div class="method">
16742 <code class="details" id="setTargetPools">setTargetPools(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
16743 <pre>Modifies the target pools to which all instances in this managed instance
16744 group are assigned. The target pools automatically apply to all of the
16745 instances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not
16746 yet been added to their target pools. The change might take some time to
16747 apply to all of the instances in the group depending on the size of the
16748 group.
16749
16750 Args:
16751 project: string, Project ID for this request. (required)
16752 zone: string, The name of thezone where the managed
16753 instance group is located. (required)
16754 instanceGroupManager: string, The name of the managed instance group. (required)
16755 body: object, The request body.
16756 The object takes the form of:
16757
16758 {
16759 &quot;fingerprint&quot;: &quot;A String&quot;, # The fingerprint of the target pools information. Use this optional
16760 # property to prevent conflicts when multiple users change the target pools
16761 # settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get
16762 # method. Then, include the fingerprint in your request to ensure that you
16763 # do not overwrite changes that were applied from another
16764 # concurrent request.
16765 &quot;targetPools&quot;: [ # The list of target pool URLs that instances in this managed instance group
16766 # belong to. The managed instance group applies these target pools to all
16767 # of the instances in the group. Existing instances and new instances in the
16768 # group all receive these target pool settings.
16769 &quot;A String&quot;,
16770 ],
16771 }
16772
16773 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
16774 that if you must retry your request, the server will know to ignore the
16775 request if it has already been completed.
16776
16777 For example, consider a situation where you make an initial request and
16778 the request times out. If you make the request again with the same
16779 request ID, the server can check if original operation with the same
16780 request ID was received, and if so, will ignore the second request. This
16781 prevents clients from accidentally creating duplicate commitments.
16782
16783 The request ID must be
16784 a valid UUID with the exception that zero UUID is not supported
16785 (00000000-0000-0000-0000-000000000000).
16786 x__xgafv: string, V1 error format.
16787 Allowed values
16788 1 - v1 error format
16789 2 - v2 error format
16790
16791 Returns:
16792 An object of the form:
16793
16794 { # Represents an Operation resource.
16795 #
16796 # Google Compute Engine has three Operation resources:
16797 #
16798 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
16799 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
16800 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
16801 #
16802 # You can use an operation resource to manage asynchronous API requests.
16803 # For more information, readHandling
16804 # API responses.
16805 #
16806 # Operations can be global, regional or zonal.
16807 #
16808 # - For global operations, use the `globalOperations`
16809 # resource.
16810 # - For regional operations, use the
16811 # `regionOperations` resource.
16812 # - For zonal operations, use
16813 # the `zoneOperations` resource.
16814 #
16815 #
16816 #
16817 # For more information, read
16818 # Global, Regional, and Zonal Resources.
16819 #
16820 # Note that completed Operation resources have a limited
16821 # retention period.
16822 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
16823 # Not present otherwise.
16824 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
16825 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
16826 # set when the operation is created.
16827 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
16828 # text format.
16829 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
16830 # this field will be populated.
16831 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
16832 # operation.
16833 {
16834 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
16835 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
16836 # details. There is a set of defined message types to use for providing
16837 # details.The syntax depends on the error code. For example,
16838 # QuotaExceededInfo will have details when the error code is
16839 # QUOTA_EXCEEDED.
16840 {
16841 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
16842 #
16843 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
16844 # is not enabled:
16845 #
16846 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
16847 # &quot;domain&quot;: &quot;googleapis.com&quot;
16848 # &quot;metadata&quot;: {
16849 # &quot;resource&quot;: &quot;projects/123&quot;,
16850 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
16851 # }
16852 # }
16853 #
16854 # This response indicates that the pubsub.googleapis.com API is not enabled.
16855 #
16856 # Example of an error that is returned when attempting to create a Spanner
16857 # instance in a region that is out of stock:
16858 #
16859 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
16860 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
16861 # &quot;metadata&quot;: {
16862 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
16863 # }
16864 # }
16865 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
16866 # is typically the registered service name of the tool or product that
16867 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
16868 # generated by some common infrastructure, the error domain must be a
16869 # globally unique value that identifies the infrastructure. For Google API
16870 # infrastructure, the error domain is &quot;googleapis.com&quot;.
16871 &quot;metadatas&quot;: { # Additional structured details about this error.
16872 #
16873 # Keys must match a regular expression of `a-z+` but should
16874 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
16875 # length. When identifying the current value of an exceeded limit, the units
16876 # should be contained in the key, not the value. For example, rather than
16877 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
16878 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
16879 # instances that can be created in a single (batch) request.
16880 &quot;a_key&quot;: &quot;A String&quot;,
16881 },
16882 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
16883 # proximate cause of the error. Error reasons are unique within a particular
16884 # domain of errors. This should be at most 63 characters and match a
16885 # regular expression of `A-Z+[A-Z0-9]`, which represents
16886 # UPPER_SNAKE_CASE.
16887 },
16888 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
16889 #
16890 # For example, if a quota check failed with an error indicating the calling
16891 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
16892 # directly to the right place in the developer console to flip the bit.
16893 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
16894 { # Describes a URL link.
16895 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
16896 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
16897 },
16898 ],
16899 },
16900 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
16901 # which can be attached to an RPC error.
16902 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
16903 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
16904 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
16905 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
16906 },
16907 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
16908 &quot;dimensions&quot;: { # The map holding related quota dimensions.
16909 &quot;a_key&quot;: &quot;A String&quot;,
16910 },
16911 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
16912 # type or metric.
16913 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
16914 # or metric.
16915 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
16916 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
16917 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
16918 },
16919 },
16920 ],
16921 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
16922 # This property is optional.
16923 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
16924 },
16925 ],
16926 },
16927 &quot;getVersionOperationMetadata&quot;: {
16928 &quot;inlineSbomInfo&quot;: {
16929 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
16930 # appropriate identifiers.
16931 &quot;a_key&quot;: &quot;A String&quot;,
16932 },
16933 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
16934 # identifiers.
16935 &quot;a_key&quot;: &quot;A String&quot;,
16936 },
16937 },
16938 },
16939 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
16940 # message that was returned, such as `NOT FOUND`.
16941 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
16942 # status code that was returned. For example, a `404` means the
16943 # resource was not found.
16944 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
16945 # defined by the server.
16946 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
16947 # This value is inRFC3339
16948 # text format.
16949 &quot;instancesBulkInsertOperationMetadata&quot;: {
16950 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
16951 # Example key: zones/us-central1-a
16952 &quot;a_key&quot;: {
16953 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
16954 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
16955 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
16956 # error.
16957 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
16958 # if the flow is rolling forward or rolling back.
16959 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
16960 },
16961 },
16962 },
16963 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
16964 # Operation resources.
16965 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
16966 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
16967 # group of operations results from a `bulkInsert` API request.
16968 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
16969 # `update`, or `delete`, and so on.
16970 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
16971 # There is no requirement that this be linear or support any granularity of
16972 # operations. This should not be used to guess when the operation will be
16973 # complete. This number should monotonically increase as the operation
16974 # progresses.
16975 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
16976 # applicable when performing regional operations.
16977 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16978 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
16979 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
16980 # this field will contain information on all underlying zonal actions and
16981 # their state.
16982 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
16983 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16984 # Example key: zones/us-central1-a
16985 &quot;a_key&quot;: {
16986 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
16987 # populated.
16988 # different programming environments, including REST APIs and RPC APIs. It is
16989 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16990 # three pieces of data: error code, error message, and error details.
16991 #
16992 # You can find out more about this error model and how to work with it in the
16993 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16994 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16995 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16996 # message types for APIs to use.
16997 {
16998 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16999 },
17000 ],
17001 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
17002 # user-facing error message should be localized and sent in the
17003 # google.rpc.Status.details field, or localized by the client.
17004 },
17005 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
17006 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
17007 },
17008 },
17009 },
17010 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
17011 # This value is inRFC3339
17012 # text format.
17013 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
17014 # following:
17015 # `PENDING`, `RUNNING`, or `DONE`.
17016 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
17017 # operation.
17018 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
17019 # of the target resource.
17020 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
17021 # operations related to creating a snapshot, this points to the disk
17022 # that the snapshot was created from.
17023 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
17024 # `[email protected]` or
17025 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
17026 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
17027 # operation, this field will be populated.
17028 {
17029 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
17030 # Engine returns NO_RESULTS_ON_PAGE if there
17031 # are no results in the response.
17032 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
17033 # value format. For example:
17034 #
17035 # &quot;data&quot;: [
17036 # {
17037 # &quot;key&quot;: &quot;scope&quot;,
17038 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
17039 # }
17040 {
17041 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
17042 # returned. For example, for warnings where there are no results in a list
17043 # request for a particular zone, this key might be scope and
17044 # the key value might be the zone name. Other examples might be a key
17045 # indicating a deprecated resource and a suggested replacement, or a
17046 # warning about invalid network settings (for example, if an instance
17047 # attempts to perform IP forwarding but is not enabled for IP forwarding).
17048 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
17049 },
17050 ],
17051 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
17052 },
17053 ],
17054 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
17055 # applicable when performing per-zone operations.
17056 }</pre>
17057 </div>
17058
17059 <div class="method">
17060 <code class="details" id="startInstances">startInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
17061 <pre>Flags the specified instances in the managed instance group to be
17062 started. This method increases thetargetSize and decreases the targetStoppedSize
17063 of the managed instance group by the number of instances that you start.
17064 The startInstances operation is marked DONE if
17065 the startInstances request is successful. The underlying
17066 actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
17067 method.
17068
17069 In this request, you can only specify instances that are stopped. For
17070 example, if an instance was previously stopped using the stopInstances
17071 method, it can be started using the startInstances method.
17072
17073 If a health check is attached to the managed instance group, the specified
17074 instances will be verified as healthy after they are started.
17075
17076 You can specify a maximum of 1000 instances with this method per request.
17077
17078 Args:
17079 project: string, Project ID for this request. (required)
17080 zone: string, The name of thezone where the managed
17081 instance group is located. (required)
17082 instanceGroupManager: string, The name of the managed instance group. (required)
17083 body: object, The request body.
17084 The object takes the form of:
17085
17086 {
17087 &quot;instances&quot;: [ # The URLs of one or more instances to start. This can be a full URL or
17088 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
17089 &quot;A String&quot;,
17090 ],
17091 }
17092
17093 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
17094 that if you must retry your request, the server will know to ignore the
17095 request if it has already been completed.
17096
17097 For example, consider a situation where you make an initial request and
17098 the request times out. If you make the request again with the same
17099 request ID, the server can check if original operation with the same
17100 request ID was received, and if so, will ignore the second request. This
17101 prevents clients from accidentally creating duplicate commitments.
17102
17103 The request ID must be
17104 a valid UUID with the exception that zero UUID is not supported
17105 (00000000-0000-0000-0000-000000000000).
17106 x__xgafv: string, V1 error format.
17107 Allowed values
17108 1 - v1 error format
17109 2 - v2 error format
17110
17111 Returns:
17112 An object of the form:
17113
17114 { # Represents an Operation resource.
17115 #
17116 # Google Compute Engine has three Operation resources:
17117 #
17118 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
17119 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
17120 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
17121 #
17122 # You can use an operation resource to manage asynchronous API requests.
17123 # For more information, readHandling
17124 # API responses.
17125 #
17126 # Operations can be global, regional or zonal.
17127 #
17128 # - For global operations, use the `globalOperations`
17129 # resource.
17130 # - For regional operations, use the
17131 # `regionOperations` resource.
17132 # - For zonal operations, use
17133 # the `zoneOperations` resource.
17134 #
17135 #
17136 #
17137 # For more information, read
17138 # Global, Regional, and Zonal Resources.
17139 #
17140 # Note that completed Operation resources have a limited
17141 # retention period.
17142 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
17143 # Not present otherwise.
17144 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
17145 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
17146 # set when the operation is created.
17147 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
17148 # text format.
17149 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
17150 # this field will be populated.
17151 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
17152 # operation.
17153 {
17154 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
17155 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
17156 # details. There is a set of defined message types to use for providing
17157 # details.The syntax depends on the error code. For example,
17158 # QuotaExceededInfo will have details when the error code is
17159 # QUOTA_EXCEEDED.
17160 {
17161 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
17162 #
17163 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
17164 # is not enabled:
17165 #
17166 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
17167 # &quot;domain&quot;: &quot;googleapis.com&quot;
17168 # &quot;metadata&quot;: {
17169 # &quot;resource&quot;: &quot;projects/123&quot;,
17170 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
17171 # }
17172 # }
17173 #
17174 # This response indicates that the pubsub.googleapis.com API is not enabled.
17175 #
17176 # Example of an error that is returned when attempting to create a Spanner
17177 # instance in a region that is out of stock:
17178 #
17179 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
17180 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
17181 # &quot;metadata&quot;: {
17182 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
17183 # }
17184 # }
17185 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
17186 # is typically the registered service name of the tool or product that
17187 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
17188 # generated by some common infrastructure, the error domain must be a
17189 # globally unique value that identifies the infrastructure. For Google API
17190 # infrastructure, the error domain is &quot;googleapis.com&quot;.
17191 &quot;metadatas&quot;: { # Additional structured details about this error.
17192 #
17193 # Keys must match a regular expression of `a-z+` but should
17194 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
17195 # length. When identifying the current value of an exceeded limit, the units
17196 # should be contained in the key, not the value. For example, rather than
17197 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
17198 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
17199 # instances that can be created in a single (batch) request.
17200 &quot;a_key&quot;: &quot;A String&quot;,
17201 },
17202 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
17203 # proximate cause of the error. Error reasons are unique within a particular
17204 # domain of errors. This should be at most 63 characters and match a
17205 # regular expression of `A-Z+[A-Z0-9]`, which represents
17206 # UPPER_SNAKE_CASE.
17207 },
17208 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
17209 #
17210 # For example, if a quota check failed with an error indicating the calling
17211 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
17212 # directly to the right place in the developer console to flip the bit.
17213 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
17214 { # Describes a URL link.
17215 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
17216 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
17217 },
17218 ],
17219 },
17220 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
17221 # which can be attached to an RPC error.
17222 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
17223 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
17224 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
17225 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
17226 },
17227 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
17228 &quot;dimensions&quot;: { # The map holding related quota dimensions.
17229 &quot;a_key&quot;: &quot;A String&quot;,
17230 },
17231 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
17232 # type or metric.
17233 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
17234 # or metric.
17235 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
17236 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
17237 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
17238 },
17239 },
17240 ],
17241 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
17242 # This property is optional.
17243 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
17244 },
17245 ],
17246 },
17247 &quot;getVersionOperationMetadata&quot;: {
17248 &quot;inlineSbomInfo&quot;: {
17249 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
17250 # appropriate identifiers.
17251 &quot;a_key&quot;: &quot;A String&quot;,
17252 },
17253 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
17254 # identifiers.
17255 &quot;a_key&quot;: &quot;A String&quot;,
17256 },
17257 },
17258 },
17259 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
17260 # message that was returned, such as `NOT FOUND`.
17261 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
17262 # status code that was returned. For example, a `404` means the
17263 # resource was not found.
17264 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
17265 # defined by the server.
17266 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
17267 # This value is inRFC3339
17268 # text format.
17269 &quot;instancesBulkInsertOperationMetadata&quot;: {
17270 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
17271 # Example key: zones/us-central1-a
17272 &quot;a_key&quot;: {
17273 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
17274 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
17275 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
17276 # error.
17277 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
17278 # if the flow is rolling forward or rolling back.
17279 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
17280 },
17281 },
17282 },
17283 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
17284 # Operation resources.
17285 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
17286 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
17287 # group of operations results from a `bulkInsert` API request.
17288 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
17289 # `update`, or `delete`, and so on.
17290 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
17291 # There is no requirement that this be linear or support any granularity of
17292 # operations. This should not be used to guess when the operation will be
17293 # complete. This number should monotonically increase as the operation
17294 # progresses.
17295 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
17296 # applicable when performing regional operations.
17297 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
17298 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
17299 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
17300 # this field will contain information on all underlying zonal actions and
17301 # their state.
17302 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
17303 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
17304 # Example key: zones/us-central1-a
17305 &quot;a_key&quot;: {
17306 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
17307 # populated.
17308 # different programming environments, including REST APIs and RPC APIs. It is
17309 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
17310 # three pieces of data: error code, error message, and error details.
17311 #
17312 # You can find out more about this error model and how to work with it in the
17313 # [API Design Guide](https://cloud.google.com/apis/design/errors).
17314 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
17315 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
17316 # message types for APIs to use.
17317 {
17318 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
17319 },
17320 ],
17321 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
17322 # user-facing error message should be localized and sent in the
17323 # google.rpc.Status.details field, or localized by the client.
17324 },
17325 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
17326 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
17327 },
17328 },
17329 },
17330 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
17331 # This value is inRFC3339
17332 # text format.
17333 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
17334 # following:
17335 # `PENDING`, `RUNNING`, or `DONE`.
17336 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
17337 # operation.
17338 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
17339 # of the target resource.
17340 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
17341 # operations related to creating a snapshot, this points to the disk
17342 # that the snapshot was created from.
17343 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
17344 # `[email protected]` or
17345 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
17346 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
17347 # operation, this field will be populated.
17348 {
17349 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
17350 # Engine returns NO_RESULTS_ON_PAGE if there
17351 # are no results in the response.
17352 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
17353 # value format. For example:
17354 #
17355 # &quot;data&quot;: [
17356 # {
17357 # &quot;key&quot;: &quot;scope&quot;,
17358 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
17359 # }
17360 {
17361 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
17362 # returned. For example, for warnings where there are no results in a list
17363 # request for a particular zone, this key might be scope and
17364 # the key value might be the zone name. Other examples might be a key
17365 # indicating a deprecated resource and a suggested replacement, or a
17366 # warning about invalid network settings (for example, if an instance
17367 # attempts to perform IP forwarding but is not enabled for IP forwarding).
17368 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
17369 },
17370 ],
17371 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
17372 },
17373 ],
17374 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
17375 # applicable when performing per-zone operations.
17376 }</pre>
17377 </div>
17378
17379 <div class="method">
17380 <code class="details" id="stopInstances">stopInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
17381 <pre>Flags the specified instances in the managed instance group to be
17382 immediately stopped. You can only specify instances that are running in
17383 this request. This method reduces thetargetSize and increases the targetStoppedSize
17384 of the managed instance group by the number of instances that you stop.
17385 The stopInstances operation is marked DONE if
17386 the stopInstances request is successful. The underlying
17387 actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
17388 method.
17389
17390 If the standbyPolicy.initialDelaySec field is set, the group
17391 delays stopping the instances until initialDelaySec have
17392 passed from instance.creationTimestamp (that is, when the
17393 instance was created). This delay gives your application time to
17394 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
17395 will be zero delay.
17396
17397 If the group is part of a backend
17398 service that has enabled
17399 connection draining, it can take up to 60 seconds after the connection
17400 draining duration has elapsed before the VM instance is stopped.
17401
17402 Stopped instances can be started using the startInstances
17403 method.
17404
17405 You can specify a maximum of 1000 instances with this method per request.
17406
17407 Args:
17408 project: string, Project ID for this request. (required)
17409 zone: string, The name of thezone where the managed
17410 instance group is located. (required)
17411 instanceGroupManager: string, The name of the managed instance group. (required)
17412 body: object, The request body.
17413 The object takes the form of:
17414
17415 {
17416 &quot;forceStop&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
17417 # stop the instances, skipping initialization on them.
17418 &quot;instances&quot;: [ # The URLs of one or more instances to stop. This can be a full URL or
17419 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
17420 &quot;A String&quot;,
17421 ],
17422 }
17423
17424 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance stopping even if it&#x27;s
17425 configured for the instances.
17426 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
17427 that if you must retry your request, the server will know to ignore the
17428 request if it has already been completed.
17429
17430 For example, consider a situation where you make an initial request and
17431 the request times out. If you make the request again with the same
17432 request ID, the server can check if original operation with the same
17433 request ID was received, and if so, will ignore the second request. This
17434 prevents clients from accidentally creating duplicate commitments.
17435
17436 The request ID must be
17437 a valid UUID with the exception that zero UUID is not supported
17438 (00000000-0000-0000-0000-000000000000).
17439 x__xgafv: string, V1 error format.
17440 Allowed values
17441 1 - v1 error format
17442 2 - v2 error format
17443
17444 Returns:
17445 An object of the form:
17446
17447 { # Represents an Operation resource.
17448 #
17449 # Google Compute Engine has three Operation resources:
17450 #
17451 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
17452 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
17453 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
17454 #
17455 # You can use an operation resource to manage asynchronous API requests.
17456 # For more information, readHandling
17457 # API responses.
17458 #
17459 # Operations can be global, regional or zonal.
17460 #
17461 # - For global operations, use the `globalOperations`
17462 # resource.
17463 # - For regional operations, use the
17464 # `regionOperations` resource.
17465 # - For zonal operations, use
17466 # the `zoneOperations` resource.
17467 #
17468 #
17469 #
17470 # For more information, read
17471 # Global, Regional, and Zonal Resources.
17472 #
17473 # Note that completed Operation resources have a limited
17474 # retention period.
17475 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
17476 # Not present otherwise.
17477 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
17478 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
17479 # set when the operation is created.
17480 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
17481 # text format.
17482 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
17483 # this field will be populated.
17484 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
17485 # operation.
17486 {
17487 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
17488 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
17489 # details. There is a set of defined message types to use for providing
17490 # details.The syntax depends on the error code. For example,
17491 # QuotaExceededInfo will have details when the error code is
17492 # QUOTA_EXCEEDED.
17493 {
17494 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
17495 #
17496 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
17497 # is not enabled:
17498 #
17499 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
17500 # &quot;domain&quot;: &quot;googleapis.com&quot;
17501 # &quot;metadata&quot;: {
17502 # &quot;resource&quot;: &quot;projects/123&quot;,
17503 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
17504 # }
17505 # }
17506 #
17507 # This response indicates that the pubsub.googleapis.com API is not enabled.
17508 #
17509 # Example of an error that is returned when attempting to create a Spanner
17510 # instance in a region that is out of stock:
17511 #
17512 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
17513 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
17514 # &quot;metadata&quot;: {
17515 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
17516 # }
17517 # }
17518 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
17519 # is typically the registered service name of the tool or product that
17520 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
17521 # generated by some common infrastructure, the error domain must be a
17522 # globally unique value that identifies the infrastructure. For Google API
17523 # infrastructure, the error domain is &quot;googleapis.com&quot;.
17524 &quot;metadatas&quot;: { # Additional structured details about this error.
17525 #
17526 # Keys must match a regular expression of `a-z+` but should
17527 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
17528 # length. When identifying the current value of an exceeded limit, the units
17529 # should be contained in the key, not the value. For example, rather than
17530 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
17531 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
17532 # instances that can be created in a single (batch) request.
17533 &quot;a_key&quot;: &quot;A String&quot;,
17534 },
17535 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
17536 # proximate cause of the error. Error reasons are unique within a particular
17537 # domain of errors. This should be at most 63 characters and match a
17538 # regular expression of `A-Z+[A-Z0-9]`, which represents
17539 # UPPER_SNAKE_CASE.
17540 },
17541 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
17542 #
17543 # For example, if a quota check failed with an error indicating the calling
17544 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
17545 # directly to the right place in the developer console to flip the bit.
17546 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
17547 { # Describes a URL link.
17548 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
17549 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
17550 },
17551 ],
17552 },
17553 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
17554 # which can be attached to an RPC error.
17555 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
17556 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
17557 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
17558 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
17559 },
17560 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
17561 &quot;dimensions&quot;: { # The map holding related quota dimensions.
17562 &quot;a_key&quot;: &quot;A String&quot;,
17563 },
17564 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
17565 # type or metric.
17566 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
17567 # or metric.
17568 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
17569 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
17570 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
17571 },
17572 },
17573 ],
17574 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
17575 # This property is optional.
17576 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
17577 },
17578 ],
17579 },
17580 &quot;getVersionOperationMetadata&quot;: {
17581 &quot;inlineSbomInfo&quot;: {
17582 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
17583 # appropriate identifiers.
17584 &quot;a_key&quot;: &quot;A String&quot;,
17585 },
17586 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
17587 # identifiers.
17588 &quot;a_key&quot;: &quot;A String&quot;,
17589 },
17590 },
17591 },
17592 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
17593 # message that was returned, such as `NOT FOUND`.
17594 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
17595 # status code that was returned. For example, a `404` means the
17596 # resource was not found.
17597 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
17598 # defined by the server.
17599 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
17600 # This value is inRFC3339
17601 # text format.
17602 &quot;instancesBulkInsertOperationMetadata&quot;: {
17603 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
17604 # Example key: zones/us-central1-a
17605 &quot;a_key&quot;: {
17606 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
17607 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
17608 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
17609 # error.
17610 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
17611 # if the flow is rolling forward or rolling back.
17612 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
17613 },
17614 },
17615 },
17616 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
17617 # Operation resources.
17618 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
17619 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
17620 # group of operations results from a `bulkInsert` API request.
17621 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
17622 # `update`, or `delete`, and so on.
17623 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
17624 # There is no requirement that this be linear or support any granularity of
17625 # operations. This should not be used to guess when the operation will be
17626 # complete. This number should monotonically increase as the operation
17627 # progresses.
17628 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
17629 # applicable when performing regional operations.
17630 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
17631 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
17632 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
17633 # this field will contain information on all underlying zonal actions and
17634 # their state.
17635 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
17636 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
17637 # Example key: zones/us-central1-a
17638 &quot;a_key&quot;: {
17639 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
17640 # populated.
17641 # different programming environments, including REST APIs and RPC APIs. It is
17642 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
17643 # three pieces of data: error code, error message, and error details.
17644 #
17645 # You can find out more about this error model and how to work with it in the
17646 # [API Design Guide](https://cloud.google.com/apis/design/errors).
17647 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
17648 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
17649 # message types for APIs to use.
17650 {
17651 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
17652 },
17653 ],
17654 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
17655 # user-facing error message should be localized and sent in the
17656 # google.rpc.Status.details field, or localized by the client.
17657 },
17658 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
17659 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
17660 },
17661 },
17662 },
17663 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
17664 # This value is inRFC3339
17665 # text format.
17666 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
17667 # following:
17668 # `PENDING`, `RUNNING`, or `DONE`.
17669 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
17670 # operation.
17671 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
17672 # of the target resource.
17673 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
17674 # operations related to creating a snapshot, this points to the disk
17675 # that the snapshot was created from.
17676 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
17677 # `[email protected]` or
17678 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
17679 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
17680 # operation, this field will be populated.
17681 {
17682 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
17683 # Engine returns NO_RESULTS_ON_PAGE if there
17684 # are no results in the response.
17685 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
17686 # value format. For example:
17687 #
17688 # &quot;data&quot;: [
17689 # {
17690 # &quot;key&quot;: &quot;scope&quot;,
17691 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
17692 # }
17693 {
17694 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
17695 # returned. For example, for warnings where there are no results in a list
17696 # request for a particular zone, this key might be scope and
17697 # the key value might be the zone name. Other examples might be a key
17698 # indicating a deprecated resource and a suggested replacement, or a
17699 # warning about invalid network settings (for example, if an instance
17700 # attempts to perform IP forwarding but is not enabled for IP forwarding).
17701 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
17702 },
17703 ],
17704 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
17705 },
17706 ],
17707 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
17708 # applicable when performing per-zone operations.
17709 }</pre>
17710 </div>
17711
17712 <div class="method">
17713 <code class="details" id="suspendInstances">suspendInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
17714 <pre>Flags the specified instances in the managed instance group to be
17715 immediately suspended. You can only specify instances that are running in
17716 this request. This method reduces thetargetSize and increases the targetSuspendedSize
17717 of the managed instance group by the number of instances that you suspend.
17718 The suspendInstances operation is marked DONE if
17719 the suspendInstances request is successful. The underlying
17720 actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
17721 method.
17722
17723 If the standbyPolicy.initialDelaySec field is set, the group
17724 delays suspension of the instances until initialDelaySec have
17725 passed from instance.creationTimestamp (that is, when the
17726 instance was created). This delay gives your application time to
17727 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
17728 will be zero delay.
17729
17730 If the group is part of a backend
17731 service that has enabled
17732 connection draining, it can take up to 60 seconds after the connection
17733 draining duration has elapsed before the VM instance is suspended.
17734
17735 Suspended instances can be resumed using the resumeInstances
17736 method.
17737
17738 You can specify a maximum of 1000 instances with this method per request.
17739
17740 Args:
17741 project: string, Project ID for this request. (required)
17742 zone: string, The name of thezone where the managed
17743 instance group is located. (required)
17744 instanceGroupManager: string, The name of the managed instance group. (required)
17745 body: object, The request body.
17746 The object takes the form of:
17747
17748 {
17749 &quot;forceSuspend&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
17750 # suspend the instances, skipping initialization on them.
17751 &quot;instances&quot;: [ # The URLs of one or more instances to suspend. This can be a full URL or
17752 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
17753 &quot;A String&quot;,
17754 ],
17755 }
17756
17757 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
17758 that if you must retry your request, the server will know to ignore the
17759 request if it has already been completed.
17760
17761 For example, consider a situation where you make an initial request and
17762 the request times out. If you make the request again with the same
17763 request ID, the server can check if original operation with the same
17764 request ID was received, and if so, will ignore the second request. This
17765 prevents clients from accidentally creating duplicate commitments.
17766
17767 The request ID must be
17768 a valid UUID with the exception that zero UUID is not supported
17769 (00000000-0000-0000-0000-000000000000).
17770 x__xgafv: string, V1 error format.
17771 Allowed values
17772 1 - v1 error format
17773 2 - v2 error format
17774
17775 Returns:
17776 An object of the form:
17777
17778 { # Represents an Operation resource.
17779 #
17780 # Google Compute Engine has three Operation resources:
17781 #
17782 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
17783 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
17784 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
17785 #
17786 # You can use an operation resource to manage asynchronous API requests.
17787 # For more information, readHandling
17788 # API responses.
17789 #
17790 # Operations can be global, regional or zonal.
17791 #
17792 # - For global operations, use the `globalOperations`
17793 # resource.
17794 # - For regional operations, use the
17795 # `regionOperations` resource.
17796 # - For zonal operations, use
17797 # the `zoneOperations` resource.
17798 #
17799 #
17800 #
17801 # For more information, read
17802 # Global, Regional, and Zonal Resources.
17803 #
17804 # Note that completed Operation resources have a limited
17805 # retention period.
17806 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
17807 # Not present otherwise.
17808 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
17809 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
17810 # set when the operation is created.
17811 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
17812 # text format.
17813 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
17814 # this field will be populated.
17815 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
17816 # operation.
17817 {
17818 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
17819 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
17820 # details. There is a set of defined message types to use for providing
17821 # details.The syntax depends on the error code. For example,
17822 # QuotaExceededInfo will have details when the error code is
17823 # QUOTA_EXCEEDED.
17824 {
17825 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
17826 #
17827 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
17828 # is not enabled:
17829 #
17830 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
17831 # &quot;domain&quot;: &quot;googleapis.com&quot;
17832 # &quot;metadata&quot;: {
17833 # &quot;resource&quot;: &quot;projects/123&quot;,
17834 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
17835 # }
17836 # }
17837 #
17838 # This response indicates that the pubsub.googleapis.com API is not enabled.
17839 #
17840 # Example of an error that is returned when attempting to create a Spanner
17841 # instance in a region that is out of stock:
17842 #
17843 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
17844 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
17845 # &quot;metadata&quot;: {
17846 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
17847 # }
17848 # }
17849 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
17850 # is typically the registered service name of the tool or product that
17851 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
17852 # generated by some common infrastructure, the error domain must be a
17853 # globally unique value that identifies the infrastructure. For Google API
17854 # infrastructure, the error domain is &quot;googleapis.com&quot;.
17855 &quot;metadatas&quot;: { # Additional structured details about this error.
17856 #
17857 # Keys must match a regular expression of `a-z+` but should
17858 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
17859 # length. When identifying the current value of an exceeded limit, the units
17860 # should be contained in the key, not the value. For example, rather than
17861 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
17862 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
17863 # instances that can be created in a single (batch) request.
17864 &quot;a_key&quot;: &quot;A String&quot;,
17865 },
17866 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
17867 # proximate cause of the error. Error reasons are unique within a particular
17868 # domain of errors. This should be at most 63 characters and match a
17869 # regular expression of `A-Z+[A-Z0-9]`, which represents
17870 # UPPER_SNAKE_CASE.
17871 },
17872 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
17873 #
17874 # For example, if a quota check failed with an error indicating the calling
17875 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
17876 # directly to the right place in the developer console to flip the bit.
17877 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
17878 { # Describes a URL link.
17879 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
17880 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
17881 },
17882 ],
17883 },
17884 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
17885 # which can be attached to an RPC error.
17886 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
17887 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
17888 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
17889 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
17890 },
17891 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
17892 &quot;dimensions&quot;: { # The map holding related quota dimensions.
17893 &quot;a_key&quot;: &quot;A String&quot;,
17894 },
17895 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
17896 # type or metric.
17897 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
17898 # or metric.
17899 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
17900 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
17901 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
17902 },
17903 },
17904 ],
17905 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
17906 # This property is optional.
17907 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
17908 },
17909 ],
17910 },
17911 &quot;getVersionOperationMetadata&quot;: {
17912 &quot;inlineSbomInfo&quot;: {
17913 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
17914 # appropriate identifiers.
17915 &quot;a_key&quot;: &quot;A String&quot;,
17916 },
17917 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
17918 # identifiers.
17919 &quot;a_key&quot;: &quot;A String&quot;,
17920 },
17921 },
17922 },
17923 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
17924 # message that was returned, such as `NOT FOUND`.
17925 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
17926 # status code that was returned. For example, a `404` means the
17927 # resource was not found.
17928 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
17929 # defined by the server.
17930 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
17931 # This value is inRFC3339
17932 # text format.
17933 &quot;instancesBulkInsertOperationMetadata&quot;: {
17934 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
17935 # Example key: zones/us-central1-a
17936 &quot;a_key&quot;: {
17937 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
17938 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
17939 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
17940 # error.
17941 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
17942 # if the flow is rolling forward or rolling back.
17943 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
17944 },
17945 },
17946 },
17947 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
17948 # Operation resources.
17949 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
17950 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
17951 # group of operations results from a `bulkInsert` API request.
17952 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
17953 # `update`, or `delete`, and so on.
17954 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
17955 # There is no requirement that this be linear or support any granularity of
17956 # operations. This should not be used to guess when the operation will be
17957 # complete. This number should monotonically increase as the operation
17958 # progresses.
17959 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
17960 # applicable when performing regional operations.
17961 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
17962 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
17963 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
17964 # this field will contain information on all underlying zonal actions and
17965 # their state.
17966 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
17967 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
17968 # Example key: zones/us-central1-a
17969 &quot;a_key&quot;: {
17970 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
17971 # populated.
17972 # different programming environments, including REST APIs and RPC APIs. It is
17973 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
17974 # three pieces of data: error code, error message, and error details.
17975 #
17976 # You can find out more about this error model and how to work with it in the
17977 # [API Design Guide](https://cloud.google.com/apis/design/errors).
17978 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
17979 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
17980 # message types for APIs to use.
17981 {
17982 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
17983 },
17984 ],
17985 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
17986 # user-facing error message should be localized and sent in the
17987 # google.rpc.Status.details field, or localized by the client.
17988 },
17989 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
17990 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
17991 },
17992 },
17993 },
17994 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
17995 # This value is inRFC3339
17996 # text format.
17997 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
17998 # following:
17999 # `PENDING`, `RUNNING`, or `DONE`.
18000 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
18001 # operation.
18002 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
18003 # of the target resource.
18004 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
18005 # operations related to creating a snapshot, this points to the disk
18006 # that the snapshot was created from.
18007 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
18008 # `[email protected]` or
18009 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
18010 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
18011 # operation, this field will be populated.
18012 {
18013 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
18014 # Engine returns NO_RESULTS_ON_PAGE if there
18015 # are no results in the response.
18016 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
18017 # value format. For example:
18018 #
18019 # &quot;data&quot;: [
18020 # {
18021 # &quot;key&quot;: &quot;scope&quot;,
18022 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
18023 # }
18024 {
18025 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
18026 # returned. For example, for warnings where there are no results in a list
18027 # request for a particular zone, this key might be scope and
18028 # the key value might be the zone name. Other examples might be a key
18029 # indicating a deprecated resource and a suggested replacement, or a
18030 # warning about invalid network settings (for example, if an instance
18031 # attempts to perform IP forwarding but is not enabled for IP forwarding).
18032 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
18033 },
18034 ],
18035 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
18036 },
18037 ],
18038 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
18039 # applicable when performing per-zone operations.
18040 }</pre>
18041 </div>
18042
18043 <div class="method">
18044 <code class="details" id="testIamPermissions">testIamPermissions(project, zone, resource, body=None, x__xgafv=None)</code>
18045 <pre>Returns permissions that a caller has on the specified resource.
18046
18047 Args:
18048 project: string, Project ID for this request. (required)
18049 zone: string, The name of the zone for this request. (required)
18050 resource: string, Name or id of the resource for this request. (required)
18051 body: object, The request body.
18052 The object takes the form of:
18053
18054 {
18055 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
18056 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
18057 &quot;A String&quot;,
18058 ],
18059 }
18060
18061 x__xgafv: string, V1 error format.
18062 Allowed values
18063 1 - v1 error format
18064 2 - v2 error format
18065
18066 Returns:
18067 An object of the form:
18068
18069 {
18070 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
18071 # allowed.
18072 &quot;A String&quot;,
18073 ],
18074 }</pre>
18075 </div>
18076
18077 <div class="method">
18078 <code class="details" id="update">update(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
18079 <pre>Updates a managed instance group using the information that you specify
18080 in the request.
18081 This operation is marked as DONE when the group is updated
18082 even if the instances in the group have not yet been updated. You must
18083 separately verify the status of the individual instances with thelistManagedInstances
18084 method.
18085
18086 If you update your group to specify a new template or instance
18087 configuration, it&#x27;s possible that your intended specification for each VM
18088 in the group is different from the current state of that VM. To learn how
18089 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
18090 a MIG.
18091
18092 Args:
18093 project: string, Project ID for this request. (required)
18094 zone: string, The name of the zone
18095 where you want to create the managed instance group. (required)
18096 instanceGroupManager: string, The name of the instance group manager. (required)
18097 body: object, The request body.
18098 The object takes the form of:
18099
18100 { # Represents a Managed Instance Group resource.
18101 #
18102 # An instance group is a collection of VM instances that you can manage as a
18103 # single entity. For more information, readInstance groups.
18104 #
18105 # For zonal Managed Instance Group, use the instanceGroupManagers
18106 # resource.
18107 #
18108 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
18109 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
18110 # for the group.
18111 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
18112 #
18113 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
18114 # instances to apply the configuration. To apply the configuration, set the
18115 # group&#x27;s updatePolicy.type field to use proactive updates or
18116 # use the applyUpdatesToInstances method.
18117 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
18118 &quot;a_key&quot;: &quot;A String&quot;,
18119 },
18120 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
18121 # more information, see Project and
18122 # instance metadata.
18123 &quot;a_key&quot;: &quot;A String&quot;,
18124 },
18125 },
18126 },
18127 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
18128 # only one value.
18129 {
18130 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
18131 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
18132 # this field controls whether to trigger VM autohealing based on a failed
18133 # health check. Valid values are:
18134 #
18135 # - ON (default): The group recreates running VMs that
18136 # fail the application-based health check.
18137 # - OFF: When set to OFF, you can still observe instance
18138 # health state, but the group does not recreate VMs that fail the
18139 # application-based health check. This is useful for troubleshooting and
18140 # setting up your health check configuration.
18141 },
18142 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
18143 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
18144 # initialize and run its startup script. During a VM&#x27;s initial delay
18145 # period, the MIG ignores unsuccessful health checks because the VM might
18146 # be in the startup process. This prevents the MIG from prematurely
18147 # recreating a VM. If the health check receives a healthy response during
18148 # the initial delay, it indicates that the startup process is complete and
18149 # the VM is ready. The value of initial delay must be between 0 and 3600
18150 # seconds. The default value is 0.
18151 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
18152 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
18153 # The instance is considered available if all of the following conditions
18154 # are satisfied:
18155 # 1. Instance&#x27;s status is RUNNING.
18156 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
18157 # check result was observed to be HEALTHY at least once as it passed
18158 # VERIFYING).
18159 # 3. There is no outgoing action on an instance triggered by IGM.
18160 #
18161 # By default, number of concurrently autohealed instances is smaller than
18162 # the managed instance group target size. However, if a zonal managed
18163 # instance group has only one instance, or a regional managed instance
18164 # group has only one instance per zone, autohealing will recreate these
18165 # instances when they become unhealthy.
18166 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
18167 #
18168 #
18169 #
18170 # - If the value is fixed, then the calculated
18171 # value is equal to the fixed value.
18172 # - If the value is a percent, then the
18173 # calculated
18174 # value is percent/100 * targetSize. For example,
18175 # the calculated value of a 80% of a managed instance group
18176 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
18177 # is a remainder, the number is rounded.
18178 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
18179 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
18180 # example, specify 80 for 80%.
18181 },
18182 },
18183 ],
18184 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
18185 # all VMs in a MIG. The maximum character length is 58 and the name must
18186 # comply with RFC1035 format.
18187 #
18188 # When a VM is created in the group, the MIG appends a hyphen and a random
18189 # four-character string to the base instance name. If you want the MIG to
18190 # assign sequential numbers instead of a random string, then end the base
18191 # instance name with a hyphen followed by one or more hash symbols. The hash
18192 # symbols indicate the number of digits. For example, a base instance name of
18193 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
18194 # @pattern
18195 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
18196 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
18197 # text format.
18198 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
18199 # in this managed instance group that are scheduled for each of those
18200 # actions.
18201 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
18202 # that are scheduled to be abandoned. Abandoning an instance removes it
18203 # from the managed instance group without deleting it.
18204 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
18205 # are scheduled to be adopted or are currently being adopted.
18206 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
18207 # are scheduled to be created or are currently being created. If the group
18208 # fails to create any of these instances, it tries again until it creates
18209 # the instance successfully.
18210 #
18211 # If you have disabled creation retries, this field will not be populated;
18212 # instead, the creatingWithoutRetries field will be populated.
18213 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
18214 # will attempt to create atomically, in a batch mode. If the desired count
18215 # of instances can not be created, entire batch will be deleted and the
18216 # group will decrease its targetSize value accordingly.
18217 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
18218 # will attempt to create. The group attempts to create each instance
18219 # only once. If the group fails to create any of these instances, it
18220 # decreases the group&#x27;s targetSize value accordingly.
18221 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
18222 # are scheduled to be deleted or are currently being deleted.
18223 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
18224 # are running and have no scheduled actions.
18225 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
18226 # is currently queuing.
18227 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
18228 # are scheduled to be recreated or are currently being being recreated.
18229 # Recreating an instance deletes the existing root persistent disk
18230 # and creates a new disk from the image that is defined in the
18231 # instance template.
18232 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
18233 # are being reconfigured with properties that do not require a restart
18234 # or a recreate action. For example, setting or removing target
18235 # pools for the instance.
18236 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
18237 # are scheduled to be restarted or are currently being restarted.
18238 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
18239 # are scheduled to be restarted or are currently being restarted.
18240 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
18241 # are scheduled to be resumed or are currently being resumed.
18242 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
18243 # are scheduled to be started or are currently being started.
18244 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
18245 # are scheduled to be stopped or are currently being stopped.
18246 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
18247 # are scheduled to be suspended or are currently being suspended.
18248 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
18249 # are being verified. See the managedInstances[].currentAction
18250 # property in the listManagedInstances method documentation.
18251 },
18252 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
18253 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
18254 # zones in a regional managed instance group.
18255 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
18256 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
18257 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
18258 # its instances.
18259 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
18260 # instances, even if an AI zone is available in the specified region. To
18261 # create instances in an AI zone in the selected region, you must explicitly
18262 # specify it in the distribution policy together with the other preferred
18263 # zones.
18264 {
18265 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
18266 # The zone must exist in the region where the managed instance group is
18267 # located.
18268 },
18269 ],
18270 },
18271 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
18272 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
18273 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
18274 # fingerprint must be provided in order to update the InstanceGroupManager,
18275 # otherwise the request will fail with error412 conditionNotMet.
18276 #
18277 # To see the latest fingerprint, make a get() request to
18278 # retrieve an InstanceGroupManager.
18279 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
18280 # generates this identifier.
18281 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
18282 # types of machines.
18283 # Instance flexibility configuration on MIG overrides instance
18284 # template configuration.
18285 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
18286 # when creating new VMs.
18287 &quot;a_key&quot;: {
18288 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
18289 # selection.
18290 { # An instance-attached disk resource.
18291 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
18292 # or X86_64.
18293 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
18294 # deleted (but not when the disk is detached from the instance).
18295 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
18296 # partition of the disk for its root filesystem.
18297 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
18298 # running within the instance. This name can be used to reference the device
18299 # for mounting, resizing, and so on, from within the instance.
18300 #
18301 # If not specified, the server chooses a default device name to apply to this
18302 # disk, in the form persistent-disk-x, where x is a number
18303 # assigned by Google Compute Engine. This field is only applicable for
18304 # persistent disks.
18305 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
18306 # encryption key.
18307 #
18308 # If you are creating a new disk, this field encrypts the new disk using
18309 # an encryption key that you provide. If you are attaching an existing
18310 # disk that is already encrypted, this field decrypts the disk using
18311 # the customer-supplied encryption key.
18312 #
18313 # If you encrypt a disk using a customer-supplied key, you must provide the
18314 # same key again when you attempt to use this resource at a later time. For
18315 # example, you must provide the key when you create a snapshot or an image
18316 # from the disk or when you attach the disk to a virtual machine instance.
18317 #
18318 # If you do not provide an encryption key, then the disk will be encrypted
18319 # using an automatically generated key and you do not need to provide a key
18320 # to use the disk later.
18321 #
18322 # Note:
18323 #
18324 # Instance templates do not storecustomer-supplied
18325 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
18326 #
18327 # You cannot create VMs that have disks with customer-supplied keys using
18328 # the bulk
18329 # insert method.
18330 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
18331 # For example:
18332 #
18333 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18334 # key_region/cryptoKeys/key
18335 #
18336 # The fully-qualifed key name may be returned for resource GET requests. For
18337 # example:
18338 #
18339 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18340 # key_region/cryptoKeys/key
18341 # /cryptoKeyVersions/1
18342 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
18343 # key. If absent, the Compute Engine default service account is used.
18344 # For example:
18345 #
18346 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
18347 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
18348 # encryption key, encoded in RFC
18349 # 4648 base64 to either encrypt or decrypt this resource. You can
18350 # provide either the rawKey or thersaEncryptedKey.
18351 # For example:
18352 #
18353 # &quot;rawKey&quot;:
18354 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
18355 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
18356 # customer-supplied encryption key to either encrypt or decrypt this
18357 # resource. You can provide either the rawKey or thersaEncryptedKey.
18358 # For example:
18359 #
18360 # &quot;rsaEncryptedKey&quot;:
18361 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
18362 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
18363 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
18364 #
18365 # The key must meet the following requirements before you can provide it to
18366 # Compute Engine:
18367 #
18368 # 1. The key is wrapped using a RSA public key certificate provided by
18369 # Google.
18370 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
18371 # encoding.
18372 #
18373 # Gets the RSA public key certificate provided by Google at:
18374 #
18375 #
18376 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
18377 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
18378 # 4648 base64 encoded SHA-256 hash of the customer-supplied
18379 # encryption key that protects this resource.
18380 },
18381 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
18382 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
18383 # currently attached to another instance. If you try to force attach a zonal
18384 # disk to an instance, you will receive an error.
18385 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
18386 # only for bootable images. Read
18387 # Enabling guest operating system features to see a list of available
18388 # options.
18389 { # Guest OS features.
18390 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
18391 # separate values. Set to one or more of the following values:
18392 #
18393 # - VIRTIO_SCSI_MULTIQUEUE
18394 # - WINDOWS
18395 # - MULTI_IP_SUBNET
18396 # - UEFI_COMPATIBLE
18397 # - GVNIC
18398 # - SEV_CAPABLE
18399 # - SUSPEND_RESUME_COMPATIBLE
18400 # - SEV_LIVE_MIGRATABLE_V2
18401 # - SEV_SNP_CAPABLE
18402 # - TDX_CAPABLE
18403 # - IDPF
18404 # - SNP_SVSM_CAPABLE
18405 # - CCA_CAPABLE
18406 #
18407 #
18408 # For more information, see
18409 # Enabling guest operating system features.
18410 },
18411 ],
18412 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
18413 # boot disk. If you have many disks attached to an instance, each
18414 # disk would have a unique index number.
18415 &quot;initializeParams&quot;: { # [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
18416 # alongside the new instance. Use initialization parameters to create boot
18417 # disks or local SSDs attached to the new instance.
18418 #
18419 # This property is mutually exclusive with the source property;
18420 # you can only define one or the other, but not both.
18421 # alongside the new instance. Use initialization parameters to create boot
18422 # disks or local SSDs attached to the new instance.
18423 #
18424 # This field is persisted and returned for instanceTemplate and not returned
18425 # in the context of instance.
18426 #
18427 # This property is mutually exclusive with the source property;
18428 # you can only define one or the other, but not both.
18429 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
18430 # arm64 or x86_64.
18431 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
18432 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
18433 # of the instance. If a disk with the same name already exists in the given
18434 # region, the existing disk is attached to the new instance and the
18435 # new disk is not created.
18436 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
18437 # 10 GB. If you specify a sourceImage, which is required for
18438 # boot disks, the default size is the size of the sourceImage.
18439 # If you do not specify a sourceImage, the default disk size
18440 # is 500 GB.
18441 &quot;diskType&quot;: &quot;A String&quot;,
18442 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
18443 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
18444 # only for bootable images. Read
18445 # Enabling guest operating system features to see a list of available
18446 # options.
18447 #
18448 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
18449 { # Guest OS features.
18450 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
18451 # separate values. Set to one or more of the following values:
18452 #
18453 # - VIRTIO_SCSI_MULTIQUEUE
18454 # - WINDOWS
18455 # - MULTI_IP_SUBNET
18456 # - UEFI_COMPATIBLE
18457 # - GVNIC
18458 # - SEV_CAPABLE
18459 # - SUSPEND_RESUME_COMPATIBLE
18460 # - SEV_LIVE_MIGRATABLE_V2
18461 # - SEV_SNP_CAPABLE
18462 # - TDX_CAPABLE
18463 # - IDPF
18464 # - SNP_SVSM_CAPABLE
18465 # - CCA_CAPABLE
18466 #
18467 #
18468 # For more information, see
18469 # Enabling guest operating system features.
18470 },
18471 ],
18472 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
18473 # which is either SCSI or NVME. The default isSCSI.
18474 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
18475 # persistent disks.
18476 &quot;a_key&quot;: &quot;A String&quot;,
18477 },
18478 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
18479 # disk.
18480 &quot;A String&quot;,
18481 ],
18482 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
18483 &quot;A String&quot;,
18484 ],
18485 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
18486 # more than one instance.
18487 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
18488 # is to use the existing disk.
18489 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
18490 # of I/O operations per second that the disk can handle. Values must be
18491 # between 10,000 and 120,000. For more details, see theExtreme persistent
18492 # disk documentation.
18493 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
18494 # number of throughput mb per second that the disk can handle. Values must
18495 # greater than or equal to 1.
18496 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
18497 # the URLs of the zones where the disk should be replicated to.
18498 # You must provide exactly two replica zones, and one zone must be the same
18499 # as the instance zone.
18500 &quot;A String&quot;,
18501 ],
18502 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
18503 # have the same definition as resource
18504 # manager tags. Keys and values can be either in numeric format,
18505 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
18506 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
18507 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
18508 # empty.
18509 &quot;a_key&quot;: &quot;A String&quot;,
18510 },
18511 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
18512 # Specified using the full or partial URL. For instance template, specify
18513 # only the resource policy name.
18514 &quot;A String&quot;,
18515 ],
18516 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
18517 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
18518 # is required.
18519 #
18520 # To create a disk with one of the public operating system
18521 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
18522 #
18523 # projects/debian-cloud/global/images/family/debian-9
18524 #
18525 #
18526 # Alternatively, use a specific version of a public operating system image:
18527 #
18528 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
18529 #
18530 #
18531 # To create a disk with a custom image that you created, specify the
18532 # image name in the following format:
18533 #
18534 # global/images/my-custom-image
18535 #
18536 #
18537 # You can also specify a custom image by its image family, which returns
18538 # the latest version of the image in that family. Replace the image name
18539 # with family/family-name:
18540 #
18541 # global/images/family/my-image-family
18542 #
18543 #
18544 # If the source image is deleted later, this field will not be set.
18545 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
18546 # encryption key of the source image. Required if the source image is
18547 # protected by a customer-supplied encryption key.
18548 #
18549 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
18550 # encryption keys, so you cannot create disks for instances in a managed instance group if the
18551 # source images are encrypted with your own keys.
18552 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
18553 # For example:
18554 #
18555 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18556 # key_region/cryptoKeys/key
18557 #
18558 # The fully-qualifed key name may be returned for resource GET requests. For
18559 # example:
18560 #
18561 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18562 # key_region/cryptoKeys/key
18563 # /cryptoKeyVersions/1
18564 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
18565 # key. If absent, the Compute Engine default service account is used.
18566 # For example:
18567 #
18568 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
18569 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
18570 # encryption key, encoded in RFC
18571 # 4648 base64 to either encrypt or decrypt this resource. You can
18572 # provide either the rawKey or thersaEncryptedKey.
18573 # For example:
18574 #
18575 # &quot;rawKey&quot;:
18576 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
18577 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
18578 # customer-supplied encryption key to either encrypt or decrypt this
18579 # resource. You can provide either the rawKey or thersaEncryptedKey.
18580 # For example:
18581 #
18582 # &quot;rsaEncryptedKey&quot;:
18583 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
18584 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
18585 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
18586 #
18587 # The key must meet the following requirements before you can provide it to
18588 # Compute Engine:
18589 #
18590 # 1. The key is wrapped using a RSA public key certificate provided by
18591 # Google.
18592 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
18593 # encoding.
18594 #
18595 # Gets the RSA public key certificate provided by Google at:
18596 #
18597 #
18598 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
18599 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
18600 # 4648 base64 encoded SHA-256 hash of the customer-supplied
18601 # encryption key that protects this resource.
18602 },
18603 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
18604 # instance boot disk, one of initializeParams.sourceSnapshot
18605 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
18606 # is required.
18607 #
18608 # To create a disk with a snapshot that you created, specify the
18609 # snapshot name in the following format:
18610 #
18611 # us-central1-a/instantSnapshots/my-backup
18612 #
18613 #
18614 # If the source instant-snapshot is deleted later, this field will not be
18615 # set.
18616 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
18617 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
18618 # is required.
18619 #
18620 # To create a disk with a snapshot that you created, specify the
18621 # snapshot name in the following format:
18622 #
18623 # global/snapshots/my-backup
18624 #
18625 #
18626 # If the source snapshot is deleted later, this field will not be set.
18627 #
18628 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
18629 # an image instead when you create VMs using
18630 # the bulk
18631 # insert method.
18632 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
18633 # encryption key of the source snapshot.
18634 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
18635 # For example:
18636 #
18637 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18638 # key_region/cryptoKeys/key
18639 #
18640 # The fully-qualifed key name may be returned for resource GET requests. For
18641 # example:
18642 #
18643 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18644 # key_region/cryptoKeys/key
18645 # /cryptoKeyVersions/1
18646 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
18647 # key. If absent, the Compute Engine default service account is used.
18648 # For example:
18649 #
18650 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
18651 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
18652 # encryption key, encoded in RFC
18653 # 4648 base64 to either encrypt or decrypt this resource. You can
18654 # provide either the rawKey or thersaEncryptedKey.
18655 # For example:
18656 #
18657 # &quot;rawKey&quot;:
18658 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
18659 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
18660 # customer-supplied encryption key to either encrypt or decrypt this
18661 # resource. You can provide either the rawKey or thersaEncryptedKey.
18662 # For example:
18663 #
18664 # &quot;rsaEncryptedKey&quot;:
18665 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
18666 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
18667 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
18668 #
18669 # The key must meet the following requirements before you can provide it to
18670 # Compute Engine:
18671 #
18672 # 1. The key is wrapped using a RSA public key certificate provided by
18673 # Google.
18674 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
18675 # encoding.
18676 #
18677 # Gets the RSA public key certificate provided by Google at:
18678 #
18679 #
18680 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
18681 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
18682 # 4648 base64 encoded SHA-256 hash of the customer-supplied
18683 # encryption key that protects this resource.
18684 },
18685 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
18686 # this as a partial or full URL to the resource. For example, the following
18687 # are valid values:
18688 #
18689 #
18690 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
18691 # - projects/project/zones/zone/storagePools/storagePool
18692 # - zones/zone/storagePools/storagePool
18693 },
18694 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
18695 # either SCSI or NVME. For most machine types, the
18696 # default is SCSI. Local SSDs can use either NVME or SCSI.
18697 # In certain configurations, persistent disks can use NVMe. For more
18698 # information, seeAbout
18699 # persistent disks.
18700 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
18701 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
18702 &quot;A String&quot;,
18703 ],
18704 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
18705 # disk is not allowed to be detached from the instance, or to be used as the
18706 # source of the snapshot creation, and the image creation. The instance with
18707 # at least one locked attached disk is not allow to be used as source of
18708 # machine image creation, instant snapshot creation, and not allowed to be
18709 # deleted with --keep-disk parameter set to true for locked disks.
18710 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
18711 # in READ_WRITE mode.
18712 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
18713 # field is set to PRESERVED if the LocalSSD data has been saved
18714 # to a persistent location by customer request. (see the
18715 # discard_local_ssd option on Stop/Suspend).
18716 # Read-only in the api.
18717 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
18718 # these are public keys which are safe to store in public
18719 &quot;dbs&quot;: [ # The Key Database (db).
18720 {
18721 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
18722 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
18723 },
18724 ],
18725 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
18726 {
18727 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
18728 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
18729 },
18730 ],
18731 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
18732 {
18733 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
18734 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
18735 },
18736 ],
18737 &quot;pk&quot;: { # The Platform Key (PK).
18738 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
18739 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
18740 },
18741 },
18742 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
18743 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
18744 # is required.
18745 #
18746 # If desired, you can also attach existing non-root persistent disks using
18747 # this property. This field is only applicable for persistent disks.
18748 #
18749 # Note that for InstanceTemplate, specify the disk name for zonal disk,
18750 # and the URL for regional disk.
18751 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
18752 },
18753 ],
18754 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
18755 &quot;A String&quot;,
18756 ],
18757 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
18758 # e.g. &#x27;Intel Ice Lake&#x27;.
18759 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
18760 # preference. MIG will first try to create a VM based on the machine-type
18761 # with lowest rank and fallback to next rank based on availability.
18762 # Machine types and instance selections with the same rank have the same
18763 # preference.
18764 },
18765 },
18766 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
18767 # when creating new VMs.
18768 &quot;a_key&quot;: {
18769 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
18770 # selection.
18771 { # An instance-attached disk resource.
18772 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
18773 # or X86_64.
18774 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
18775 # deleted (but not when the disk is detached from the instance).
18776 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
18777 # partition of the disk for its root filesystem.
18778 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
18779 # running within the instance. This name can be used to reference the device
18780 # for mounting, resizing, and so on, from within the instance.
18781 #
18782 # If not specified, the server chooses a default device name to apply to this
18783 # disk, in the form persistent-disk-x, where x is a number
18784 # assigned by Google Compute Engine. This field is only applicable for
18785 # persistent disks.
18786 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
18787 # encryption key.
18788 #
18789 # If you are creating a new disk, this field encrypts the new disk using
18790 # an encryption key that you provide. If you are attaching an existing
18791 # disk that is already encrypted, this field decrypts the disk using
18792 # the customer-supplied encryption key.
18793 #
18794 # If you encrypt a disk using a customer-supplied key, you must provide the
18795 # same key again when you attempt to use this resource at a later time. For
18796 # example, you must provide the key when you create a snapshot or an image
18797 # from the disk or when you attach the disk to a virtual machine instance.
18798 #
18799 # If you do not provide an encryption key, then the disk will be encrypted
18800 # using an automatically generated key and you do not need to provide a key
18801 # to use the disk later.
18802 #
18803 # Note:
18804 #
18805 # Instance templates do not storecustomer-supplied
18806 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
18807 #
18808 # You cannot create VMs that have disks with customer-supplied keys using
18809 # the bulk
18810 # insert method.
18811 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
18812 # For example:
18813 #
18814 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18815 # key_region/cryptoKeys/key
18816 #
18817 # The fully-qualifed key name may be returned for resource GET requests. For
18818 # example:
18819 #
18820 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
18821 # key_region/cryptoKeys/key
18822 # /cryptoKeyVersions/1
18823 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
18824 # key. If absent, the Compute Engine default service account is used.
18825 # For example:
18826 #
18827 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
18828 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
18829 # encryption key, encoded in RFC
18830 # 4648 base64 to either encrypt or decrypt this resource. You can
18831 # provide either the rawKey or thersaEncryptedKey.
18832 # For example:
18833 #
18834 # &quot;rawKey&quot;:
18835 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
18836 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
18837 # customer-supplied encryption key to either encrypt or decrypt this
18838 # resource. You can provide either the rawKey or thersaEncryptedKey.
18839 # For example:
18840 #
18841 # &quot;rsaEncryptedKey&quot;:
18842 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
18843 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
18844 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
18845 #
18846 # The key must meet the following requirements before you can provide it to
18847 # Compute Engine:
18848 #
18849 # 1. The key is wrapped using a RSA public key certificate provided by
18850 # Google.
18851 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
18852 # encoding.
18853 #
18854 # Gets the RSA public key certificate provided by Google at:
18855 #
18856 #
18857 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
18858 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
18859 # 4648 base64 encoded SHA-256 hash of the customer-supplied
18860 # encryption key that protects this resource.
18861 },
18862 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
18863 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
18864 # currently attached to another instance. If you try to force attach a zonal
18865 # disk to an instance, you will receive an error.
18866 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
18867 # only for bootable images. Read
18868 # Enabling guest operating system features to see a list of available
18869 # options.
18870 { # Guest OS features.
18871 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
18872 # separate values. Set to one or more of the following values:
18873 #
18874 # - VIRTIO_SCSI_MULTIQUEUE
18875 # - WINDOWS
18876 # - MULTI_IP_SUBNET
18877 # - UEFI_COMPATIBLE
18878 # - GVNIC
18879 # - SEV_CAPABLE
18880 # - SUSPEND_RESUME_COMPATIBLE
18881 # - SEV_LIVE_MIGRATABLE_V2
18882 # - SEV_SNP_CAPABLE
18883 # - TDX_CAPABLE
18884 # - IDPF
18885 # - SNP_SVSM_CAPABLE
18886 # - CCA_CAPABLE
18887 #
18888 #
18889 # For more information, see
18890 # Enabling guest operating system features.
18891 },
18892 ],
18893 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
18894 # boot disk. If you have many disks attached to an instance, each
18895 # disk would have a unique index number.
18896 &quot;initializeParams&quot;: { # [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
18897 # alongside the new instance. Use initialization parameters to create boot
18898 # disks or local SSDs attached to the new instance.
18899 #
18900 # This property is mutually exclusive with the source property;
18901 # you can only define one or the other, but not both.
18902 # alongside the new instance. Use initialization parameters to create boot
18903 # disks or local SSDs attached to the new instance.
18904 #
18905 # This field is persisted and returned for instanceTemplate and not returned
18906 # in the context of instance.
18907 #
18908 # This property is mutually exclusive with the source property;
18909 # you can only define one or the other, but not both.
18910 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
18911 # arm64 or x86_64.
18912 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
18913 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
18914 # of the instance. If a disk with the same name already exists in the given
18915 # region, the existing disk is attached to the new instance and the
18916 # new disk is not created.
18917 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
18918 # 10 GB. If you specify a sourceImage, which is required for
18919 # boot disks, the default size is the size of the sourceImage.
18920 # If you do not specify a sourceImage, the default disk size
18921 # is 500 GB.
18922 &quot;diskType&quot;: &quot;A String&quot;,
18923 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
18924 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
18925 # only for bootable images. Read
18926 # Enabling guest operating system features to see a list of available
18927 # options.
18928 #
18929 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
18930 { # Guest OS features.
18931 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
18932 # separate values. Set to one or more of the following values:
18933 #
18934 # - VIRTIO_SCSI_MULTIQUEUE
18935 # - WINDOWS
18936 # - MULTI_IP_SUBNET
18937 # - UEFI_COMPATIBLE
18938 # - GVNIC
18939 # - SEV_CAPABLE
18940 # - SUSPEND_RESUME_COMPATIBLE
18941 # - SEV_LIVE_MIGRATABLE_V2
18942 # - SEV_SNP_CAPABLE
18943 # - TDX_CAPABLE
18944 # - IDPF
18945 # - SNP_SVSM_CAPABLE
18946 # - CCA_CAPABLE
18947 #
18948 #
18949 # For more information, see
18950 # Enabling guest operating system features.
18951 },
18952 ],
18953 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
18954 # which is either SCSI or NVME. The default isSCSI.
18955 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
18956 # persistent disks.
18957 &quot;a_key&quot;: &quot;A String&quot;,
18958 },
18959 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
18960 # disk.
18961 &quot;A String&quot;,
18962 ],
18963 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
18964 &quot;A String&quot;,
18965 ],
18966 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
18967 # more than one instance.
18968 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
18969 # is to use the existing disk.
18970 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
18971 # of I/O operations per second that the disk can handle. Values must be
18972 # between 10,000 and 120,000. For more details, see theExtreme persistent
18973 # disk documentation.
18974 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
18975 # number of throughput mb per second that the disk can handle. Values must
18976 # greater than or equal to 1.
18977 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
18978 # the URLs of the zones where the disk should be replicated to.
18979 # You must provide exactly two replica zones, and one zone must be the same
18980 # as the instance zone.
18981 &quot;A String&quot;,
18982 ],
18983 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
18984 # have the same definition as resource
18985 # manager tags. Keys and values can be either in numeric format,
18986 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
18987 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
18988 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
18989 # empty.
18990 &quot;a_key&quot;: &quot;A String&quot;,
18991 },
18992 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
18993 # Specified using the full or partial URL. For instance template, specify
18994 # only the resource policy name.
18995 &quot;A String&quot;,
18996 ],
18997 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
18998 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
18999 # is required.
19000 #
19001 # To create a disk with one of the public operating system
19002 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
19003 #
19004 # projects/debian-cloud/global/images/family/debian-9
19005 #
19006 #
19007 # Alternatively, use a specific version of a public operating system image:
19008 #
19009 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
19010 #
19011 #
19012 # To create a disk with a custom image that you created, specify the
19013 # image name in the following format:
19014 #
19015 # global/images/my-custom-image
19016 #
19017 #
19018 # You can also specify a custom image by its image family, which returns
19019 # the latest version of the image in that family. Replace the image name
19020 # with family/family-name:
19021 #
19022 # global/images/family/my-image-family
19023 #
19024 #
19025 # If the source image is deleted later, this field will not be set.
19026 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
19027 # encryption key of the source image. Required if the source image is
19028 # protected by a customer-supplied encryption key.
19029 #
19030 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
19031 # encryption keys, so you cannot create disks for instances in a managed instance group if the
19032 # source images are encrypted with your own keys.
19033 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
19034 # For example:
19035 #
19036 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
19037 # key_region/cryptoKeys/key
19038 #
19039 # The fully-qualifed key name may be returned for resource GET requests. For
19040 # example:
19041 #
19042 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
19043 # key_region/cryptoKeys/key
19044 # /cryptoKeyVersions/1
19045 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
19046 # key. If absent, the Compute Engine default service account is used.
19047 # For example:
19048 #
19049 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
19050 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
19051 # encryption key, encoded in RFC
19052 # 4648 base64 to either encrypt or decrypt this resource. You can
19053 # provide either the rawKey or thersaEncryptedKey.
19054 # For example:
19055 #
19056 # &quot;rawKey&quot;:
19057 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
19058 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
19059 # customer-supplied encryption key to either encrypt or decrypt this
19060 # resource. You can provide either the rawKey or thersaEncryptedKey.
19061 # For example:
19062 #
19063 # &quot;rsaEncryptedKey&quot;:
19064 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
19065 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
19066 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
19067 #
19068 # The key must meet the following requirements before you can provide it to
19069 # Compute Engine:
19070 #
19071 # 1. The key is wrapped using a RSA public key certificate provided by
19072 # Google.
19073 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
19074 # encoding.
19075 #
19076 # Gets the RSA public key certificate provided by Google at:
19077 #
19078 #
19079 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
19080 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
19081 # 4648 base64 encoded SHA-256 hash of the customer-supplied
19082 # encryption key that protects this resource.
19083 },
19084 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
19085 # instance boot disk, one of initializeParams.sourceSnapshot
19086 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
19087 # is required.
19088 #
19089 # To create a disk with a snapshot that you created, specify the
19090 # snapshot name in the following format:
19091 #
19092 # us-central1-a/instantSnapshots/my-backup
19093 #
19094 #
19095 # If the source instant-snapshot is deleted later, this field will not be
19096 # set.
19097 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
19098 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
19099 # is required.
19100 #
19101 # To create a disk with a snapshot that you created, specify the
19102 # snapshot name in the following format:
19103 #
19104 # global/snapshots/my-backup
19105 #
19106 #
19107 # If the source snapshot is deleted later, this field will not be set.
19108 #
19109 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
19110 # an image instead when you create VMs using
19111 # the bulk
19112 # insert method.
19113 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
19114 # encryption key of the source snapshot.
19115 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
19116 # For example:
19117 #
19118 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
19119 # key_region/cryptoKeys/key
19120 #
19121 # The fully-qualifed key name may be returned for resource GET requests. For
19122 # example:
19123 #
19124 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
19125 # key_region/cryptoKeys/key
19126 # /cryptoKeyVersions/1
19127 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
19128 # key. If absent, the Compute Engine default service account is used.
19129 # For example:
19130 #
19131 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
19132 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
19133 # encryption key, encoded in RFC
19134 # 4648 base64 to either encrypt or decrypt this resource. You can
19135 # provide either the rawKey or thersaEncryptedKey.
19136 # For example:
19137 #
19138 # &quot;rawKey&quot;:
19139 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
19140 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
19141 # customer-supplied encryption key to either encrypt or decrypt this
19142 # resource. You can provide either the rawKey or thersaEncryptedKey.
19143 # For example:
19144 #
19145 # &quot;rsaEncryptedKey&quot;:
19146 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
19147 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
19148 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
19149 #
19150 # The key must meet the following requirements before you can provide it to
19151 # Compute Engine:
19152 #
19153 # 1. The key is wrapped using a RSA public key certificate provided by
19154 # Google.
19155 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
19156 # encoding.
19157 #
19158 # Gets the RSA public key certificate provided by Google at:
19159 #
19160 #
19161 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
19162 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
19163 # 4648 base64 encoded SHA-256 hash of the customer-supplied
19164 # encryption key that protects this resource.
19165 },
19166 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
19167 # this as a partial or full URL to the resource. For example, the following
19168 # are valid values:
19169 #
19170 #
19171 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
19172 # - projects/project/zones/zone/storagePools/storagePool
19173 # - zones/zone/storagePools/storagePool
19174 },
19175 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
19176 # either SCSI or NVME. For most machine types, the
19177 # default is SCSI. Local SSDs can use either NVME or SCSI.
19178 # In certain configurations, persistent disks can use NVMe. For more
19179 # information, seeAbout
19180 # persistent disks.
19181 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
19182 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
19183 &quot;A String&quot;,
19184 ],
19185 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
19186 # disk is not allowed to be detached from the instance, or to be used as the
19187 # source of the snapshot creation, and the image creation. The instance with
19188 # at least one locked attached disk is not allow to be used as source of
19189 # machine image creation, instant snapshot creation, and not allowed to be
19190 # deleted with --keep-disk parameter set to true for locked disks.
19191 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
19192 # in READ_WRITE mode.
19193 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
19194 # field is set to PRESERVED if the LocalSSD data has been saved
19195 # to a persistent location by customer request. (see the
19196 # discard_local_ssd option on Stop/Suspend).
19197 # Read-only in the api.
19198 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
19199 # these are public keys which are safe to store in public
19200 &quot;dbs&quot;: [ # The Key Database (db).
19201 {
19202 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
19203 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
19204 },
19205 ],
19206 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
19207 {
19208 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
19209 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
19210 },
19211 ],
19212 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
19213 {
19214 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
19215 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
19216 },
19217 ],
19218 &quot;pk&quot;: { # The Platform Key (PK).
19219 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
19220 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
19221 },
19222 },
19223 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
19224 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
19225 # is required.
19226 #
19227 # If desired, you can also attach existing non-root persistent disks using
19228 # this property. This field is only applicable for persistent disks.
19229 #
19230 # Note that for InstanceTemplate, specify the disk name for zonal disk,
19231 # and the URL for regional disk.
19232 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
19233 },
19234 ],
19235 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
19236 &quot;A String&quot;,
19237 ],
19238 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
19239 # e.g. &#x27;Intel Ice Lake&#x27;.
19240 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
19241 # preference. MIG will first try to create a VM based on the machine-type
19242 # with lowest rank and fallback to next rank based on availability.
19243 # Machine types and instance selections with the same rank have the same
19244 # preference.
19245 },
19246 },
19247 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
19248 # create instances.
19249 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
19250 # more preemption than the minimum capacity user needs. MIG will create
19251 # only Standard VMs until it reaches standard_capacity_base and only
19252 # then will start using standard_capacity_percent_above_base to mix Spot
19253 # with Standard VMs.
19254 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
19255 # remaining percentage will use Spot VMs. The percentage applies only to
19256 # the capacity above standard_capacity_base.
19257 },
19258 },
19259 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
19260 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
19261 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
19262 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
19263 # applies to the VMs on which your application fails a health check.
19264 # Valid values are
19265 #
19266 # - REPAIR (default): MIG automatically repairs a failed VM
19267 # by recreating it. For more information, see About
19268 # repairing VMs in a MIG.
19269 # - DO_NOTHING: MIG does not repair a failed VM.
19270 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
19271 # configuration when repairing a VM. Valid options are:
19272 #
19273 #
19274 #
19275 # - NO (default): If configuration updates are available, they are not
19276 # forcefully applied during repair. Instead, configuration updates are
19277 # applied according to the group&#x27;s update policy.
19278 #
19279 # - YES: If configuration updates are available, they are applied
19280 # during repair.
19281 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
19282 # instance during initialization when stopping / suspending an instance.
19283 # The Instance Group Manager will wait for a signal that indicates
19284 # successful initialization before stopping / suspending an instance.
19285 #
19286 # If a successful readiness signal is not sent before timeout, the
19287 # corresponding instance will not be stopped / suspended. Instead,
19288 # an error will be visible in the lastAttempt.errors field of
19289 # the managed instance in the listmanagedinstances
19290 # method.
19291 #
19292 # If metadataBasedReadinessSignal.timeoutSec is unset,
19293 # the Instance Group Manager will directly proceed to suspend / stop
19294 # instances, skipping initialization on them.
19295 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
19296 # initialization before timing out.
19297 },
19298 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
19299 # unhealthy when the application running on that VM fails a health check.
19300 # Valid values are:
19301 #
19302 # - DEFAULT_ACTION (default): MIG uses the same action
19303 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
19304 # - REPAIR: MIG automatically repairs an unhealthy VM by
19305 # recreating it.
19306 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
19307 # For more information, see
19308 # About repairing VMs in a MIG.
19309 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
19310 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
19311 # Valid values are:
19312 #
19313 # - NO (default): MIG cannot change a VM&#x27;s zone during a
19314 # repair.
19315 # - YES: MIG can select a different zone for the VM during
19316 # a repair.
19317 },
19318 },
19319 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
19320 # instance group. The group uses this template to create all new instances
19321 # in the managed instance group. The templates for existing instances in the
19322 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
19323 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
19324 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
19325 # this managed instance group.
19326 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
19327 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
19328 # long, and comply withRFC1035.
19329 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
19330 # to this Instance Group Manager.
19331 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
19332 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
19333 # The name must be 1-63 characters long, and comply withRFC1035.
19334 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
19335 },
19336 ],
19337 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
19338 # as part of resource payload.
19339 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
19340 # key-value pairs. Keys and values can be either in numeric format,
19341 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
19342 # format such as `{org_id|project_id}/{tag_key_short_name}` and
19343 # `{tag_value_short_name}`. For more information, seeManage tags
19344 # for resources.
19345 &quot;a_key&quot;: &quot;A String&quot;,
19346 },
19347 },
19348 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
19349 # where the managed instance group resides (for regional resources).
19350 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
19351 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
19352 # instance group.
19353 # It can be a full or partial URL. For example, the following are
19354 # all valid URLs to a workload policy:
19355 #
19356 #
19357 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
19358 # - projects/project/regions/region/resourcePolicies/resourcePolicy
19359 # - regions/region/resourcePolicies/resourcePolicy
19360 },
19361 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
19362 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
19363 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
19364 # this URL.
19365 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
19366 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
19367 # by the managed instance group on instances. The service accounts needs all
19368 # permissions required to create and delete instances.
19369 # By default, the service account
19370 # {projectNumber}@cloudservices.gserviceaccount.com is used.
19371 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
19372 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
19373 # stop a VM after that VM was created. The initial delay gives the
19374 # initialization script the time to prepare your VM for a quick scale out.
19375 # The value of initial delay must be between 0 and 3600 seconds. The
19376 # default value is 0.
19377 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
19378 # group scales out. The default mode is `MANUAL`.
19379 },
19380 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
19381 &quot;preservedState&quot;: { # Configuration of preserved resources.
19382 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
19383 # delete, update, etc. This map is keyed with the device names of
19384 # the disks.
19385 &quot;a_key&quot;: {
19386 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
19387 # update or VM instance recreate operations.
19388 # This flag is used to configure if the disk should be deleted after it
19389 # is no longer used by the group, e.g. when the given instance or
19390 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
19391 },
19392 },
19393 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
19394 # instance delete, update, etc. This map is keyed with the network
19395 # interface name.
19396 &quot;a_key&quot;: {
19397 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
19398 # update or VM instance recreate operations.
19399 # This flag is used to configure if the IP reservation should be deleted
19400 # after it is no longer used by the group, e.g. when the given instance
19401 # or the whole group is deleted.
19402 },
19403 },
19404 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
19405 # instance delete, update, etc. This map is keyed with the network
19406 # interface name.
19407 &quot;a_key&quot;: {
19408 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
19409 # update or VM instance recreate operations.
19410 # This flag is used to configure if the IP reservation should be deleted
19411 # after it is no longer used by the group, e.g. when the given instance
19412 # or the whole group is deleted.
19413 },
19414 },
19415 },
19416 },
19417 &quot;status&quot;: { # Output only. The status of this managed instance group.
19418 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
19419 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
19420 # This value is in RFC3339 text format.
19421 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
19422 # been applied to all managed instances in the group.
19423 },
19424 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
19425 # Currently only one accelerator topology is supported.
19426 {
19427 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
19428 # The value is the same as configured in the WorkloadPolicy.
19429 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
19430 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
19431 # check.
19432 &quot;error&quot;: { # Output only. Encountered errors.
19433 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
19434 # operation.
19435 {
19436 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
19437 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
19438 # details. There is a set of defined message types to use for providing
19439 # details.The syntax depends on the error code. For example,
19440 # QuotaExceededInfo will have details when the error code is
19441 # QUOTA_EXCEEDED.
19442 {
19443 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
19444 #
19445 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
19446 # is not enabled:
19447 #
19448 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
19449 # &quot;domain&quot;: &quot;googleapis.com&quot;
19450 # &quot;metadata&quot;: {
19451 # &quot;resource&quot;: &quot;projects/123&quot;,
19452 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
19453 # }
19454 # }
19455 #
19456 # This response indicates that the pubsub.googleapis.com API is not enabled.
19457 #
19458 # Example of an error that is returned when attempting to create a Spanner
19459 # instance in a region that is out of stock:
19460 #
19461 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
19462 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
19463 # &quot;metadata&quot;: {
19464 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
19465 # }
19466 # }
19467 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
19468 # is typically the registered service name of the tool or product that
19469 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
19470 # generated by some common infrastructure, the error domain must be a
19471 # globally unique value that identifies the infrastructure. For Google API
19472 # infrastructure, the error domain is &quot;googleapis.com&quot;.
19473 &quot;metadatas&quot;: { # Additional structured details about this error.
19474 #
19475 # Keys must match a regular expression of `a-z+` but should
19476 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
19477 # length. When identifying the current value of an exceeded limit, the units
19478 # should be contained in the key, not the value. For example, rather than
19479 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
19480 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
19481 # instances that can be created in a single (batch) request.
19482 &quot;a_key&quot;: &quot;A String&quot;,
19483 },
19484 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
19485 # proximate cause of the error. Error reasons are unique within a particular
19486 # domain of errors. This should be at most 63 characters and match a
19487 # regular expression of `A-Z+[A-Z0-9]`, which represents
19488 # UPPER_SNAKE_CASE.
19489 },
19490 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
19491 #
19492 # For example, if a quota check failed with an error indicating the calling
19493 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
19494 # directly to the right place in the developer console to flip the bit.
19495 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
19496 { # Describes a URL link.
19497 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
19498 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
19499 },
19500 ],
19501 },
19502 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
19503 # which can be attached to an RPC error.
19504 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
19505 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
19506 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
19507 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
19508 },
19509 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
19510 &quot;dimensions&quot;: { # The map holding related quota dimensions.
19511 &quot;a_key&quot;: &quot;A String&quot;,
19512 },
19513 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
19514 # type or metric.
19515 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
19516 # or metric.
19517 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
19518 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
19519 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
19520 },
19521 },
19522 ],
19523 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
19524 # This property is optional.
19525 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
19526 },
19527 ],
19528 },
19529 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
19530 # has // RFC3339 //
19531 # text format.
19532 },
19533 },
19534 ],
19535 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
19536 # that targets this instance group manager.
19537 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
19538 # targetSizePolicy.mode is set to BULK.
19539 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
19540 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
19541 # operation.
19542 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
19543 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
19544 # operation.
19545 {
19546 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
19547 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
19548 # details. There is a set of defined message types to use for providing
19549 # details.The syntax depends on the error code. For example,
19550 # QuotaExceededInfo will have details when the error code is
19551 # QUOTA_EXCEEDED.
19552 {
19553 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
19554 #
19555 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
19556 # is not enabled:
19557 #
19558 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
19559 # &quot;domain&quot;: &quot;googleapis.com&quot;
19560 # &quot;metadata&quot;: {
19561 # &quot;resource&quot;: &quot;projects/123&quot;,
19562 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
19563 # }
19564 # }
19565 #
19566 # This response indicates that the pubsub.googleapis.com API is not enabled.
19567 #
19568 # Example of an error that is returned when attempting to create a Spanner
19569 # instance in a region that is out of stock:
19570 #
19571 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
19572 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
19573 # &quot;metadata&quot;: {
19574 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
19575 # }
19576 # }
19577 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
19578 # is typically the registered service name of the tool or product that
19579 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
19580 # generated by some common infrastructure, the error domain must be a
19581 # globally unique value that identifies the infrastructure. For Google API
19582 # infrastructure, the error domain is &quot;googleapis.com&quot;.
19583 &quot;metadatas&quot;: { # Additional structured details about this error.
19584 #
19585 # Keys must match a regular expression of `a-z+` but should
19586 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
19587 # length. When identifying the current value of an exceeded limit, the units
19588 # should be contained in the key, not the value. For example, rather than
19589 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
19590 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
19591 # instances that can be created in a single (batch) request.
19592 &quot;a_key&quot;: &quot;A String&quot;,
19593 },
19594 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
19595 # proximate cause of the error. Error reasons are unique within a particular
19596 # domain of errors. This should be at most 63 characters and match a
19597 # regular expression of `A-Z+[A-Z0-9]`, which represents
19598 # UPPER_SNAKE_CASE.
19599 },
19600 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
19601 #
19602 # For example, if a quota check failed with an error indicating the calling
19603 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
19604 # directly to the right place in the developer console to flip the bit.
19605 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
19606 { # Describes a URL link.
19607 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
19608 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
19609 },
19610 ],
19611 },
19612 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
19613 # which can be attached to an RPC error.
19614 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
19615 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
19616 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
19617 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
19618 },
19619 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
19620 &quot;dimensions&quot;: { # The map holding related quota dimensions.
19621 &quot;a_key&quot;: &quot;A String&quot;,
19622 },
19623 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
19624 # type or metric.
19625 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
19626 # or metric.
19627 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
19628 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
19629 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
19630 },
19631 },
19632 ],
19633 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
19634 # This property is optional.
19635 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
19636 },
19637 ],
19638 },
19639 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
19640 # operation. Timestamp is in RFC3339 text format.
19641 },
19642 },
19643 &quot;currentInstanceStatuses&quot;: { # 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
19644 # in this managed instance group that have the status. Currently only shown
19645 # for TPU MIGs
19646 # instance group that have the status. For more information about how to
19647 # interpret each status check the instance lifecycle documentation.
19648 # Currently only shown for TPU MIGs.
19649 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
19650 # that have DEPROVISIONING status.
19651 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
19652 # have been deleted. Includes only instances that would be shown in the
19653 # listManagedInstances method and not all instances that have been
19654 # deleted in the lifetime of the MIG.
19655 # Does not include FlexStart instances that are waiting for the resources
19656 # availability, they are considered as &#x27;pending&#x27;.
19657 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
19658 # that have PENDING status, that is FlexStart instances that are waiting
19659 # for resources. Instances that do not exist because of the other reasons
19660 # are counted as &#x27;non_existent&#x27;.
19661 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
19662 # that have PENDING_STOP status.
19663 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
19664 # that have PROVISIONING status.
19665 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
19666 # that have REPAIRING status.
19667 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
19668 # that have RUNNING status.
19669 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
19670 # that have STAGING status.
19671 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
19672 # that have STOPPED status.
19673 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
19674 # that have STOPPING status.
19675 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
19676 # that have SUSPENDED status.
19677 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
19678 # that have SUSPENDING status.
19679 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
19680 # that have TERMINATED status.
19681 },
19682 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
19683 # stable state. A stable state means that: none of the instances in the
19684 # managed instance group is currently undergoing any type of change (for
19685 # example, creation, restart, or deletion); no future changes are scheduled
19686 # for instances in the managed instance group; and the managed instance
19687 # group itself is not being modified.
19688 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
19689 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
19690 # has stateful configuration, that is, if you have configured any items
19691 # in a stateful policy or in per-instance configs.
19692 # The group might report that it has no stateful configuration even when
19693 # there is still some preserved state on a managed instance, for example,
19694 # if you have deleted all PICs but not yet applied those deletions.
19695 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
19696 # has stateful configuration, that is, if you have configured any items
19697 # in a stateful policy or in per-instance configs.
19698 # The group might report that it has no stateful configuration even when
19699 # there is still some preserved state on a managed instance, for example,
19700 # if you have deleted all PICs but not yet applied those deletions. This
19701 # field is deprecated in favor of has_stateful_config.
19702 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
19703 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
19704 # (listed in the output of a listPerInstanceConfigs API call) have
19705 # status EFFECTIVE or there are no per-instance-configs.
19706 },
19707 },
19708 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
19709 # target version specified by version field on Instance Group
19710 # Manager.
19711 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
19712 # in this managed instance group, i.e. all instances are in their target
19713 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
19714 },
19715 },
19716 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
19717 # apply to all of the instances in the managed instance group.
19718 &quot;A String&quot;,
19719 ],
19720 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
19721 # You can reduce this number by using the instanceGroupManager
19722 # deleteInstances or abandonInstances methods. Resizing the group also
19723 # changes this number.
19724 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
19725 # size.
19726 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
19727 # individually or all at once.
19728 },
19729 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
19730 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
19731 # This number changes when you:
19732 #
19733 # - Stop instance using the stopInstances
19734 # method or start instances using the startInstances
19735 # method.
19736 # - Manually change the targetStoppedSize using the update
19737 # method.
19738 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
19739 # This number changes when you:
19740 #
19741 # - Suspend instance using the suspendInstances
19742 # method or resume instances using the resumeInstances
19743 # method.
19744 # - Manually change the targetSuspendedSize using the update
19745 # method.
19746 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
19747 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
19748 &quot;A String&quot;,
19749 ],
19750 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
19751 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
19752 # instance redistribution policy for regional managed instance groups.
19753 # Valid values are:
19754 #
19755 # - PROACTIVE (default): The group attempts to maintain an
19756 # even distribution of VM instances across zones in the region.
19757 # - NONE: For non-autoscaled groups, proactive
19758 # redistribution is disabled.
19759 &quot;maxSurge&quot;: { # 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
19760 # either a fixed number or, if the group has 10 or more instances, a
19761 # percentage. If you set a percentage, the number of instances is rounded
19762 # if necessary. The default value for maxSurge is a fixed
19763 # value equal to the number of zones in which the managed instance group
19764 # operates.
19765 #
19766 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
19767 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
19768 #
19769 #
19770 #
19771 # - If the value is fixed, then the calculated
19772 # value is equal to the fixed value.
19773 # - If the value is a percent, then the
19774 # calculated
19775 # value is percent/100 * targetSize. For example,
19776 # the calculated value of a 80% of a managed instance group
19777 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
19778 # is a remainder, the number is rounded.
19779 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
19780 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
19781 # example, specify 80 for 80%.
19782 },
19783 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
19784 # process. An instance is considered available if all of the following
19785 # conditions are satisfied:
19786 #
19787 #
19788 #
19789 # - The instance&#x27;s status is
19790 # RUNNING.
19791 # - If there is a health
19792 # check on the instance group, the instance&#x27;s health check status
19793 # must be HEALTHY at least once. If there is no health check
19794 # on the group, then the instance only needs to have a status of
19795 # RUNNING to be considered available.
19796 #
19797 #
19798 # This value can be either a fixed number or, if the group has 10 or more
19799 # instances, a percentage. If you set a percentage, the number of instances
19800 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
19801 # in which the managed instance group operates.
19802 #
19803 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
19804 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
19805 #
19806 #
19807 #
19808 # - If the value is fixed, then the calculated
19809 # value is equal to the fixed value.
19810 # - If the value is a percent, then the
19811 # calculated
19812 # value is percent/100 * targetSize. For example,
19813 # the calculated value of a 80% of a managed instance group
19814 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
19815 # is a remainder, the number is rounded.
19816 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
19817 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
19818 # example, specify 80 for 80%.
19819 },
19820 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
19821 # becomes available. This value must be from range [0, 3600].
19822 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
19823 # disruption as much as possible or to apply a more disruptive action than
19824 # is necessary.
19825 #
19826 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
19827 # Compute Engine performs the necessary action to execute the update.
19828 # - To apply a more disruptive action than is strictly necessary, set the
19829 # minimal action to RESTART or REPLACE. For
19830 # example, Compute Engine does not need to restart a VM to change its
19831 # metadata. But if your application reads instance metadata only when a VM
19832 # is restarted, you can set the minimal action to RESTART in
19833 # order to pick up metadata changes.
19834 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
19835 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
19836 # as much as possible. RESTART to allow actions that can be
19837 # applied without instance replacing or REPLACE to allow all
19838 # possible actions. If the Updater determines that the minimal update
19839 # action needed is more disruptive than most disruptive allowed action you
19840 # specify it will not perform the update at all.
19841 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
19842 # See minimal_action.REPLACE
19843 &quot;type&quot;: &quot;A String&quot;, # The type
19844 # of update process. You can specify either PROACTIVE so
19845 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
19846 # to update.
19847 },
19848 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
19849 # create instances.
19850 #
19851 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
19852 # group. This field overrides the top-level instanceTemplate
19853 # field. Read more about therelationships
19854 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
19855 # remaining instances. For more information, read aboutcanary
19856 # updates.
19857 {
19858 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
19859 # instance group. The group uses this template to create new instances in
19860 # the managed instance group until the `targetSize` for this version is
19861 # reached. The templates for existing instances in the group do not change
19862 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
19863 # existing instances are updated until the `targetSize` for this version is
19864 # reached.
19865 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
19866 # managed instance group.
19867 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
19868 # even if instance_template remains unchanged.
19869 # Deprecated in favor of &#x27;name&#x27;.
19870 &quot;targetSize&quot;: { # 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
19871 # from the template will be equal to:
19872 #
19873 #
19874 # - If expressed as a fixed number, the minimum of either
19875 # targetSize.fixed or
19876 # instanceGroupManager.targetSize is used.
19877 # - if expressed as a percent, the targetSize
19878 # would be (targetSize.percent/100 *
19879 # InstanceGroupManager.targetSize) If there is a remainder, the
19880 # number is rounded.
19881 #
19882 # If unset, this version will update any remaining instances not
19883 # updated by another version. ReadStarting
19884 # a canary update for more information.
19885 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
19886 #
19887 #
19888 #
19889 # - If the value is fixed, then the calculated
19890 # value is equal to the fixed value.
19891 # - If the value is a percent, then the
19892 # calculated
19893 # value is percent/100 * targetSize. For example,
19894 # the calculated value of a 80% of a managed instance group
19895 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
19896 # is a remainder, the number is rounded.
19897 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
19898 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
19899 # example, specify 80 for 80%.
19900 },
19901 },
19902 ],
19903 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
19904 # where the managed instance group is located (for zonal resources).
19905 }
19906
19907 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
19908 that if you must retry your request, the server will know to ignore the
19909 request if it has already been completed.
19910
19911 For example, consider a situation where you make an initial request and
19912 the request times out. If you make the request again with the same
19913 request ID, the server can check if original operation with the same
19914 request ID was received, and if so, will ignore the second request. This
19915 prevents clients from accidentally creating duplicate commitments.
19916
19917 The request ID must be
19918 a valid UUID with the exception that zero UUID is not supported
19919 (00000000-0000-0000-0000-000000000000).
19920 x__xgafv: string, V1 error format.
19921 Allowed values
19922 1 - v1 error format
19923 2 - v2 error format
19924
19925 Returns:
19926 An object of the form:
19927
19928 { # Represents an Operation resource.
19929 #
19930 # Google Compute Engine has three Operation resources:
19931 #
19932 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
19933 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
19934 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
19935 #
19936 # You can use an operation resource to manage asynchronous API requests.
19937 # For more information, readHandling
19938 # API responses.
19939 #
19940 # Operations can be global, regional or zonal.
19941 #
19942 # - For global operations, use the `globalOperations`
19943 # resource.
19944 # - For regional operations, use the
19945 # `regionOperations` resource.
19946 # - For zonal operations, use
19947 # the `zoneOperations` resource.
19948 #
19949 #
19950 #
19951 # For more information, read
19952 # Global, Regional, and Zonal Resources.
19953 #
19954 # Note that completed Operation resources have a limited
19955 # retention period.
19956 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
19957 # Not present otherwise.
19958 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
19959 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
19960 # set when the operation is created.
19961 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
19962 # text format.
19963 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
19964 # this field will be populated.
19965 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
19966 # operation.
19967 {
19968 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
19969 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
19970 # details. There is a set of defined message types to use for providing
19971 # details.The syntax depends on the error code. For example,
19972 # QuotaExceededInfo will have details when the error code is
19973 # QUOTA_EXCEEDED.
19974 {
19975 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
19976 #
19977 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
19978 # is not enabled:
19979 #
19980 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
19981 # &quot;domain&quot;: &quot;googleapis.com&quot;
19982 # &quot;metadata&quot;: {
19983 # &quot;resource&quot;: &quot;projects/123&quot;,
19984 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
19985 # }
19986 # }
19987 #
19988 # This response indicates that the pubsub.googleapis.com API is not enabled.
19989 #
19990 # Example of an error that is returned when attempting to create a Spanner
19991 # instance in a region that is out of stock:
19992 #
19993 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
19994 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
19995 # &quot;metadata&quot;: {
19996 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
19997 # }
19998 # }
19999 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
20000 # is typically the registered service name of the tool or product that
20001 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
20002 # generated by some common infrastructure, the error domain must be a
20003 # globally unique value that identifies the infrastructure. For Google API
20004 # infrastructure, the error domain is &quot;googleapis.com&quot;.
20005 &quot;metadatas&quot;: { # Additional structured details about this error.
20006 #
20007 # Keys must match a regular expression of `a-z+` but should
20008 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
20009 # length. When identifying the current value of an exceeded limit, the units
20010 # should be contained in the key, not the value. For example, rather than
20011 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
20012 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
20013 # instances that can be created in a single (batch) request.
20014 &quot;a_key&quot;: &quot;A String&quot;,
20015 },
20016 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
20017 # proximate cause of the error. Error reasons are unique within a particular
20018 # domain of errors. This should be at most 63 characters and match a
20019 # regular expression of `A-Z+[A-Z0-9]`, which represents
20020 # UPPER_SNAKE_CASE.
20021 },
20022 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
20023 #
20024 # For example, if a quota check failed with an error indicating the calling
20025 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
20026 # directly to the right place in the developer console to flip the bit.
20027 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
20028 { # Describes a URL link.
20029 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
20030 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
20031 },
20032 ],
20033 },
20034 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
20035 # which can be attached to an RPC error.
20036 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
20037 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
20038 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
20039 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
20040 },
20041 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
20042 &quot;dimensions&quot;: { # The map holding related quota dimensions.
20043 &quot;a_key&quot;: &quot;A String&quot;,
20044 },
20045 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
20046 # type or metric.
20047 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
20048 # or metric.
20049 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
20050 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
20051 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
20052 },
20053 },
20054 ],
20055 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
20056 # This property is optional.
20057 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
20058 },
20059 ],
20060 },
20061 &quot;getVersionOperationMetadata&quot;: {
20062 &quot;inlineSbomInfo&quot;: {
20063 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
20064 # appropriate identifiers.
20065 &quot;a_key&quot;: &quot;A String&quot;,
20066 },
20067 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
20068 # identifiers.
20069 &quot;a_key&quot;: &quot;A String&quot;,
20070 },
20071 },
20072 },
20073 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
20074 # message that was returned, such as `NOT FOUND`.
20075 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
20076 # status code that was returned. For example, a `404` means the
20077 # resource was not found.
20078 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
20079 # defined by the server.
20080 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
20081 # This value is inRFC3339
20082 # text format.
20083 &quot;instancesBulkInsertOperationMetadata&quot;: {
20084 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
20085 # Example key: zones/us-central1-a
20086 &quot;a_key&quot;: {
20087 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
20088 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
20089 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
20090 # error.
20091 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
20092 # if the flow is rolling forward or rolling back.
20093 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
20094 },
20095 },
20096 },
20097 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
20098 # Operation resources.
20099 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
20100 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
20101 # group of operations results from a `bulkInsert` API request.
20102 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
20103 # `update`, or `delete`, and so on.
20104 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
20105 # There is no requirement that this be linear or support any granularity of
20106 # operations. This should not be used to guess when the operation will be
20107 # complete. This number should monotonically increase as the operation
20108 # progresses.
20109 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
20110 # applicable when performing regional operations.
20111 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
20112 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
20113 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
20114 # this field will contain information on all underlying zonal actions and
20115 # their state.
20116 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
20117 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
20118 # Example key: zones/us-central1-a
20119 &quot;a_key&quot;: {
20120 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
20121 # populated.
20122 # different programming environments, including REST APIs and RPC APIs. It is
20123 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
20124 # three pieces of data: error code, error message, and error details.
20125 #
20126 # You can find out more about this error model and how to work with it in the
20127 # [API Design Guide](https://cloud.google.com/apis/design/errors).
20128 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
20129 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
20130 # message types for APIs to use.
20131 {
20132 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
20133 },
20134 ],
20135 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
20136 # user-facing error message should be localized and sent in the
20137 # google.rpc.Status.details field, or localized by the client.
20138 },
20139 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
20140 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
20141 },
20142 },
20143 },
20144 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
20145 # This value is inRFC3339
20146 # text format.
20147 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
20148 # following:
20149 # `PENDING`, `RUNNING`, or `DONE`.
20150 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
20151 # operation.
20152 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
20153 # of the target resource.
20154 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
20155 # operations related to creating a snapshot, this points to the disk
20156 # that the snapshot was created from.
20157 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
20158 # `[email protected]` or
20159 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
20160 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
20161 # operation, this field will be populated.
20162 {
20163 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
20164 # Engine returns NO_RESULTS_ON_PAGE if there
20165 # are no results in the response.
20166 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
20167 # value format. For example:
20168 #
20169 # &quot;data&quot;: [
20170 # {
20171 # &quot;key&quot;: &quot;scope&quot;,
20172 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
20173 # }
20174 {
20175 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
20176 # returned. For example, for warnings where there are no results in a list
20177 # request for a particular zone, this key might be scope and
20178 # the key value might be the zone name. Other examples might be a key
20179 # indicating a deprecated resource and a suggested replacement, or a
20180 # warning about invalid network settings (for example, if an instance
20181 # attempts to perform IP forwarding but is not enabled for IP forwarding).
20182 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
20183 },
20184 ],
20185 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
20186 },
20187 ],
20188 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
20189 # applicable when performing per-zone operations.
20190 }</pre>
20191 </div>
20192
20193 <div class="method">
20194 <code class="details" id="updatePerInstanceConfigs">updatePerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
20195 <pre>Inserts or updates per-instance configurations for the managed instance
20196 group. perInstanceConfig.name serves as a key used to
20197 distinguish whether to perform insert or patch.
20198
20199 Args:
20200 project: string, Project ID for this request. (required)
20201 zone: string, The name of thezone
20202 where the managed instance group is located.
20203 It should conform to RFC1035. (required)
20204 instanceGroupManager: string, The name of the managed instance group.
20205 It should conform to RFC1035. (required)
20206 body: object, The request body.
20207 The object takes the form of:
20208
20209 { # InstanceGroupManagers.updatePerInstanceConfigs
20210 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
20211 # instance group.
20212 {
20213 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
20214 # optimistic locking. It is ignored when inserting a per-instance
20215 # config. An up-to-date fingerprint must be provided in order to update an
20216 # existing per-instance configuration or the field needs to be unset.
20217 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
20218 # Serves as a merge key during UpdatePerInstanceConfigs
20219 # operations, that is, if a per-instance configuration with the same name
20220 # exists then it will be updated, otherwise a new one will be created for the
20221 # VM instance with the same name. An attempt to create a per-instance
20222 # configuration for a VM instance that either doesn&#x27;t exist or is not part
20223 # of the group will result in an error.
20224 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
20225 # preserved state generated from a stateful policy.
20226 &quot;disks&quot;: { # Preserved disks defined for this instance.
20227 # This map is keyed with the device names of the disks.
20228 &quot;a_key&quot;: {
20229 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
20230 # update, instance recreate operations. This flag is used to configure
20231 # if the disk should be deleted after it is no longer used by the group,
20232 # e.g. when the given instance or the whole MIG is deleted.
20233 # Note: disks attached in READ_ONLY mode cannot be
20234 # auto-deleted.
20235 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the
20236 # disk in READ_WRITE mode.
20237 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
20238 # to the VM instance.
20239 },
20240 },
20241 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
20242 # This map is keyed with the name of the network interface.
20243 &quot;a_key&quot;: {
20244 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
20245 # update or VM instance recreate operations.
20246 # This flag is used to configure if the IP reservation should be deleted
20247 # after it is no longer used by the group, e.g. when the given instance
20248 # or the whole group is deleted.
20249 &quot;ipAddress&quot;: { # Ip address representation
20250 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
20251 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
20252 # network interface.
20253 },
20254 },
20255 },
20256 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
20257 # This map is keyed with the name of the network interface.
20258 &quot;a_key&quot;: {
20259 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
20260 # update or VM instance recreate operations.
20261 # This flag is used to configure if the IP reservation should be deleted
20262 # after it is no longer used by the group, e.g. when the given instance
20263 # or the whole group is deleted.
20264 &quot;ipAddress&quot;: { # Ip address representation
20265 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
20266 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
20267 # network interface.
20268 },
20269 },
20270 },
20271 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
20272 &quot;a_key&quot;: &quot;A String&quot;,
20273 },
20274 },
20275 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
20276 # managed instance.
20277 },
20278 ],
20279 }
20280
20281 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
20282 that if you must retry your request, the server will know to ignore the
20283 request if it has already been completed.
20284
20285 For example, consider a situation where you make an initial request and
20286 the request times out. If you make the request again with the same
20287 request ID, the server can check if original operation with the same
20288 request ID was received, and if so, will ignore the second request. This
20289 prevents clients from accidentally creating duplicate commitments.
20290
20291 The request ID must be
20292 a valid UUID with the exception that zero UUID is not supported
20293 (00000000-0000-0000-0000-000000000000).
20294 x__xgafv: string, V1 error format.
20295 Allowed values
20296 1 - v1 error format
20297 2 - v2 error format
20298
20299 Returns:
20300 An object of the form:
20301
20302 { # Represents an Operation resource.
20303 #
20304 # Google Compute Engine has three Operation resources:
20305 #
20306 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
20307 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
20308 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
20309 #
20310 # You can use an operation resource to manage asynchronous API requests.
20311 # For more information, readHandling
20312 # API responses.
20313 #
20314 # Operations can be global, regional or zonal.
20315 #
20316 # - For global operations, use the `globalOperations`
20317 # resource.
20318 # - For regional operations, use the
20319 # `regionOperations` resource.
20320 # - For zonal operations, use
20321 # the `zoneOperations` resource.
20322 #
20323 #
20324 #
20325 # For more information, read
20326 # Global, Regional, and Zonal Resources.
20327 #
20328 # Note that completed Operation resources have a limited
20329 # retention period.
20330 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
20331 # Not present otherwise.
20332 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
20333 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
20334 # set when the operation is created.
20335 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
20336 # text format.
20337 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
20338 # this field will be populated.
20339 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
20340 # operation.
20341 {
20342 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
20343 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
20344 # details. There is a set of defined message types to use for providing
20345 # details.The syntax depends on the error code. For example,
20346 # QuotaExceededInfo will have details when the error code is
20347 # QUOTA_EXCEEDED.
20348 {
20349 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
20350 #
20351 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
20352 # is not enabled:
20353 #
20354 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
20355 # &quot;domain&quot;: &quot;googleapis.com&quot;
20356 # &quot;metadata&quot;: {
20357 # &quot;resource&quot;: &quot;projects/123&quot;,
20358 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
20359 # }
20360 # }
20361 #
20362 # This response indicates that the pubsub.googleapis.com API is not enabled.
20363 #
20364 # Example of an error that is returned when attempting to create a Spanner
20365 # instance in a region that is out of stock:
20366 #
20367 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
20368 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
20369 # &quot;metadata&quot;: {
20370 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
20371 # }
20372 # }
20373 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
20374 # is typically the registered service name of the tool or product that
20375 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
20376 # generated by some common infrastructure, the error domain must be a
20377 # globally unique value that identifies the infrastructure. For Google API
20378 # infrastructure, the error domain is &quot;googleapis.com&quot;.
20379 &quot;metadatas&quot;: { # Additional structured details about this error.
20380 #
20381 # Keys must match a regular expression of `a-z+` but should
20382 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
20383 # length. When identifying the current value of an exceeded limit, the units
20384 # should be contained in the key, not the value. For example, rather than
20385 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
20386 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
20387 # instances that can be created in a single (batch) request.
20388 &quot;a_key&quot;: &quot;A String&quot;,
20389 },
20390 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
20391 # proximate cause of the error. Error reasons are unique within a particular
20392 # domain of errors. This should be at most 63 characters and match a
20393 # regular expression of `A-Z+[A-Z0-9]`, which represents
20394 # UPPER_SNAKE_CASE.
20395 },
20396 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
20397 #
20398 # For example, if a quota check failed with an error indicating the calling
20399 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
20400 # directly to the right place in the developer console to flip the bit.
20401 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
20402 { # Describes a URL link.
20403 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
20404 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
20405 },
20406 ],
20407 },
20408 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
20409 # which can be attached to an RPC error.
20410 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
20411 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
20412 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
20413 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
20414 },
20415 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
20416 &quot;dimensions&quot;: { # The map holding related quota dimensions.
20417 &quot;a_key&quot;: &quot;A String&quot;,
20418 },
20419 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
20420 # type or metric.
20421 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
20422 # or metric.
20423 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
20424 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
20425 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
20426 },
20427 },
20428 ],
20429 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
20430 # This property is optional.
20431 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
20432 },
20433 ],
20434 },
20435 &quot;getVersionOperationMetadata&quot;: {
20436 &quot;inlineSbomInfo&quot;: {
20437 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
20438 # appropriate identifiers.
20439 &quot;a_key&quot;: &quot;A String&quot;,
20440 },
20441 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
20442 # identifiers.
20443 &quot;a_key&quot;: &quot;A String&quot;,
20444 },
20445 },
20446 },
20447 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
20448 # message that was returned, such as `NOT FOUND`.
20449 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
20450 # status code that was returned. For example, a `404` means the
20451 # resource was not found.
20452 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
20453 # defined by the server.
20454 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
20455 # This value is inRFC3339
20456 # text format.
20457 &quot;instancesBulkInsertOperationMetadata&quot;: {
20458 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
20459 # Example key: zones/us-central1-a
20460 &quot;a_key&quot;: {
20461 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
20462 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
20463 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
20464 # error.
20465 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
20466 # if the flow is rolling forward or rolling back.
20467 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
20468 },
20469 },
20470 },
20471 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
20472 # Operation resources.
20473 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
20474 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
20475 # group of operations results from a `bulkInsert` API request.
20476 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
20477 # `update`, or `delete`, and so on.
20478 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
20479 # There is no requirement that this be linear or support any granularity of
20480 # operations. This should not be used to guess when the operation will be
20481 # complete. This number should monotonically increase as the operation
20482 # progresses.
20483 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
20484 # applicable when performing regional operations.
20485 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
20486 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
20487 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
20488 # this field will contain information on all underlying zonal actions and
20489 # their state.
20490 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
20491 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
20492 # Example key: zones/us-central1-a
20493 &quot;a_key&quot;: {
20494 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
20495 # populated.
20496 # different programming environments, including REST APIs and RPC APIs. It is
20497 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
20498 # three pieces of data: error code, error message, and error details.
20499 #
20500 # You can find out more about this error model and how to work with it in the
20501 # [API Design Guide](https://cloud.google.com/apis/design/errors).
20502 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
20503 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
20504 # message types for APIs to use.
20505 {
20506 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
20507 },
20508 ],
20509 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
20510 # user-facing error message should be localized and sent in the
20511 # google.rpc.Status.details field, or localized by the client.
20512 },
20513 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
20514 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
20515 },
20516 },
20517 },
20518 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
20519 # This value is inRFC3339
20520 # text format.
20521 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
20522 # following:
20523 # `PENDING`, `RUNNING`, or `DONE`.
20524 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
20525 # operation.
20526 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
20527 # of the target resource.
20528 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
20529 # operations related to creating a snapshot, this points to the disk
20530 # that the snapshot was created from.
20531 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
20532 # `[email protected]` or
20533 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
20534 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
20535 # operation, this field will be populated.
20536 {
20537 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
20538 # Engine returns NO_RESULTS_ON_PAGE if there
20539 # are no results in the response.
20540 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
20541 # value format. For example:
20542 #
20543 # &quot;data&quot;: [
20544 # {
20545 # &quot;key&quot;: &quot;scope&quot;,
20546 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
20547 # }
20548 {
20549 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
20550 # returned. For example, for warnings where there are no results in a list
20551 # request for a particular zone, this key might be scope and
20552 # the key value might be the zone name. Other examples might be a key
20553 # indicating a deprecated resource and a suggested replacement, or a
20554 # warning about invalid network settings (for example, if an instance
20555 # attempts to perform IP forwarding but is not enabled for IP forwarding).
20556 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
20557 },
20558 ],
20559 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
20560 },
20561 ],
20562 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
20563 # applicable when performing per-zone operations.
20564 }</pre>
20565 </div>
20566
20567 </body></html>