Debian Codegraph @

docs/dyn/compute_beta.imageFamilyViews.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_beta.html">Compute Engine API</a> . <a href="compute_beta.imageFamilyViews.html">imageFamilyViews</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79 <p class="firstline">Close httplib2 connections.</p>
80 <p class="toc_element">
81 <code><a href="#get">get(project, zone, family, x__xgafv=None)</a></code></p>
82 <p class="firstline">Returns the latest image that is part of an image family, is not</p>
83 <h3>Method Details</h3>
84 <div class="method">
85 <code class="details" id="close">close()</code>
86 <pre>Close httplib2 connections.</pre>
87 </div>
88
89 <div class="method">
90 <code class="details" id="get">get(project, zone, family, x__xgafv=None)</code>
91 <pre>Returns the latest image that is part of an image family, is not
92 deprecated and is rolled out in the specified zone.
93
94 Args:
95 project: string, Project ID for this request. (required)
96 zone: string, The name of the zone for this request. (required)
97 family: string, Name of the image family to search for. (required)
98 x__xgafv: string, V1 error format.
99 Allowed values
100 1 - v1 error format
101 2 - v2 error format
102
103 Returns:
104 An object of the form:
105
106 {
107 &quot;image&quot;: { # Represents an Image resource. # The latest image that is part of the specified image family in the
108 # requested location, and that is not deprecated.
109 #
110 # You can use images to create boot disks for your VM instances.
111 # For more information, read Images.
112 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the image. Valid values are
113 # ARM64 or X86_64.
114 &quot;archiveSizeBytes&quot;: &quot;A String&quot;, # Size of the image tar.gz archive stored in Google Cloud
115 # Storage (in bytes).
116 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
117 # text format.
118 &quot;deprecated&quot;: { # Deprecation status for a public resource. # Output only. The deprecation status associated with this image.
119 &quot;deleted&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
120 # resource is intended to change to DELETED. This is only
121 # informational and the status will not change unless the client explicitly
122 # changes it.
123 &quot;deprecated&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
124 # resource is intended to change to DEPRECATED. This is only
125 # informational and the status will not change unless the client explicitly
126 # changes it.
127 &quot;obsolete&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
128 # resource is intended to change to OBSOLETE. This is only
129 # informational and the status will not change unless the client explicitly
130 # changes it.
131 &quot;replacement&quot;: &quot;A String&quot;, # The URL of the suggested replacement for a deprecated resource.
132 # The suggested replacement resource must be the same kind of resource as the
133 # deprecated resource.
134 &quot;state&quot;: &quot;A String&quot;, # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
135 # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
136 # warning indicating the deprecated resource and recommending its
137 # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
138 &quot;stateOverride&quot;: { # A rollout policy configuration. # The rollout policy for this deprecation. This policy is only enforced by
139 # image family views. The rollout policy restricts the zones where the
140 # associated resource is considered in a deprecated state. When the rollout
141 # policy does not include the user specified zone, or if the zone is rolled
142 # out, the associated resource is considered in a deprecated state.
143 #
144 # The rollout policy for this deprecation is read-only, except for
145 # allowlisted users. This field might not be configured. To view the latest
146 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
147 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
148 # considered rolled out to any zone that is not explicitly stated.
149 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
150 #
151 # Currently only zone names are supported and must be represented
152 # as valid URLs, like: zones/us-central1-a.
153 #
154 # The value expects an RFC3339 timestamp on or after which the update is
155 # considered rolled out to the specified location.
156 &quot;a_key&quot;: &quot;A String&quot;,
157 },
158 },
159 },
160 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
161 # create the resource.
162 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Size of the image when restored onto a persistent disk (in GB).
163 &quot;enableConfidentialCompute&quot;: True or False, # Output only. Whether this image is created from a confidential compute mode disk.
164 # [Output Only]: This field is not set by user, but from source disk.
165 &quot;family&quot;: &quot;A String&quot;, # The name of the image family to which this image belongs. The image
166 # family name can be from a publicly managed image family provided by
167 # Compute Engine, or from a custom image family you create. For example,centos-stream-9 is a publicly available image family.
168 # For more information, see Image
169 # family best practices.
170 #
171 # When creating disks, you can specify an image family instead of a specific
172 # image name. The image family always returns its latest image that is not
173 # deprecated. The name of the image family must comply with RFC1035.
174 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
175 # only for bootable images. To see a list of available options, see theguestOSfeatures[].type parameter.
176 { # Guest OS features.
177 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
178 # separate values. Set to one or more of the following values:
179 #
180 # - VIRTIO_SCSI_MULTIQUEUE
181 # - WINDOWS
182 # - MULTI_IP_SUBNET
183 # - UEFI_COMPATIBLE
184 # - GVNIC
185 # - SEV_CAPABLE
186 # - SUSPEND_RESUME_COMPATIBLE
187 # - SEV_LIVE_MIGRATABLE_V2
188 # - SEV_SNP_CAPABLE
189 # - TDX_CAPABLE
190 # - IDPF
191 # - SNP_SVSM_CAPABLE
192 # - CCA_CAPABLE
193 #
194 #
195 # For more information, see
196 # Enabling guest operating system features.
197 },
198 ],
199 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
200 # defined by the server.
201 &quot;imageEncryptionKey&quot;: { # Encrypts the image using acustomer-supplied
202 # encryption key.
203 #
204 # After you encrypt an image with a customer-supplied key, you must provide
205 # the same key if you use the image later (e.g. to create a disk from
206 # the image).
207 #
208 # Customer-supplied encryption keys do not protect access to metadata
209 # of the disk.
210 #
211 # If you do not provide an encryption key when creating the image, then the
212 # disk will be encrypted using an automatically generated key and you do not
213 # need to provide a key to use the image later.
214 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
215 # For example:
216 #
217 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
218 # key_region/cryptoKeys/key
219 #
220 # The fully-qualifed key name may be returned for resource GET requests. For
221 # example:
222 #
223 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
224 # key_region/cryptoKeys/key
225 # /cryptoKeyVersions/1
226 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
227 # key. If absent, the Compute Engine default service account is used.
228 # For example:
229 #
230 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
231 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
232 # encryption key, encoded in RFC
233 # 4648 base64 to either encrypt or decrypt this resource. You can
234 # provide either the rawKey or thersaEncryptedKey.
235 # For example:
236 #
237 # &quot;rawKey&quot;:
238 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
239 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
240 # customer-supplied encryption key to either encrypt or decrypt this
241 # resource. You can provide either the rawKey or thersaEncryptedKey.
242 # For example:
243 #
244 # &quot;rsaEncryptedKey&quot;:
245 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
246 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
247 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
248 #
249 # The key must meet the following requirements before you can provide it to
250 # Compute Engine:
251 #
252 # 1. The key is wrapped using a RSA public key certificate provided by
253 # Google.
254 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
255 # encoding.
256 #
257 # Gets the RSA public key certificate provided by Google at:
258 #
259 #
260 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
261 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
262 # 4648 base64 encoded SHA-256 hash of the customer-supplied
263 # encryption key that protects this resource.
264 },
265 &quot;kind&quot;: &quot;compute#image&quot;, # Output only. [Output Only] Type of the resource. Always compute#image for
266 # images.
267 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this image, which is
268 # essentially a hash of the labels used for optimistic locking. The
269 # fingerprint is initially generated by Compute Engine and changes after
270 # every request to modify or update labels. You must always provide an
271 # up-to-date fingerprint hash in order to update or change labels,
272 # otherwise the request will fail with error412 conditionNotMet.
273 #
274 # To see the latest fingerprint, make a get() request to
275 # retrieve an image.
276 &quot;labels&quot;: { # Labels to apply to this image. These can be later modified by
277 # the setLabels method.
278 &quot;a_key&quot;: &quot;A String&quot;,
279 },
280 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this image.
281 &quot;A String&quot;,
282 ],
283 &quot;licenses&quot;: [ # Any applicable license URI.
284 &quot;A String&quot;,
285 ],
286 &quot;locked&quot;: True or False, # A flag for marketplace VM disk created from the image, which is designed
287 # for marketplace VM disk to prevent the proprietary data on the disk from
288 # being accessed unwantedly. The flag will be inherited by the disk created
289 # from the image.
290 #
291 # The disk with locked flag set to true will be prohibited from performing
292 # the operations below:
293 #
294 # - R/W or R/O disk attach
295 # - Disk detach, if disk is created via create-on-create
296 # - Create images
297 # - Create snapshots
298 # - Create disk clone (create disk from the current disk)
299 #
300 #
301 #
302 # The image with the locked field set to true will be prohibited from
303 # performing the operations below:
304 #
305 # - Create images from the current image
306 # - Update the locked field for the current image
307 #
308 #
309 #
310 # The instance with at least one disk with locked flag set to true will be
311 # prohibited from performing the operations below:
312 #
313 # - Secondary disk attach
314 # - Create instant snapshot
315 # - Create machine images
316 # - Create instance template
317 # - Delete the instance with --keep-disk parameter set to true
318 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
319 # The name must be 1-63 characters long, and comply withRFC1035.
320 # Specifically, the name must be 1-63 characters long and match the regular
321 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
322 # character must be a lowercase letter, and all following characters must be
323 # a dash, lowercase letter, or digit, except the last character, which cannot
324 # be a dash.
325 &quot;params&quot;: { # Additional image params. # Input only. [Input Only] Additional params passed with the request, but not persisted
326 # as part of resource payload.
327 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the image. Tag keys and values have
328 # the same definition as resource
329 # manager tags. Keys and values can be either in numeric format,
330 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
331 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
332 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
333 # PATCH) when empty.
334 &quot;a_key&quot;: &quot;A String&quot;,
335 },
336 },
337 &quot;rawDisk&quot;: { # The parameters of the raw disk image.
338 &quot;containerType&quot;: &quot;A String&quot;, # The format used to encode and transmit the block device, which should beTAR. This is just a container and transmission format and not
339 # a runtime format. Provided by the client when the disk image is created.
340 &quot;sha1Checksum&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
341 # An optional SHA1 checksum of the disk image before unpackaging provided
342 # by the client when the disk image is created.
343 &quot;source&quot;: &quot;A String&quot;, # The full Google Cloud Storage URL or Artifact Registry path where the raw
344 # disk image archive is stored.
345 # The following are valid formats:
346 #
347 # - https://storage.googleapis.com/bucket_name/image_archive_name
348 # - https://storage.googleapis.com/bucket_name/folder_name/image_archive_name
349 # - projects/project/locations/location/repositories/repo/packages/package/versions/version_id
350 # - projects/project/locations/location/repositories/repo/packages/package/versions/version_id@dirsum_sha256:hex_value
351 #
352 #
353 #
354 # In order to create an image, you must provide the full or partial URL of
355 # one of the following:
356 #
357 # - The rawDisk.source URL
358 # - The sourceDisk URL
359 # - The sourceImage URL
360 # - The sourceSnapshot URL
361 },
362 &quot;rolloutOverride&quot;: { # A rollout policy configuration. # A rollout policy to apply to this image. When specified, the rollout policy
363 # overrides per-zone references to the image via the associated image family.
364 # The rollout policy restricts the zones where this image is accessible when
365 # using a zonal image family reference. When the rollout policy does not
366 # include the user specified zone, or if the zone is rolled out, this image
367 # is accessible.
368 #
369 # The rollout policy for this image is read-only, except for allowlisted
370 # users. This field might not be configured. To view the latest
371 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
372 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
373 # considered rolled out to any zone that is not explicitly stated.
374 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
375 #
376 # Currently only zone names are supported and must be represented
377 # as valid URLs, like: zones/us-central1-a.
378 #
379 # The value expects an RFC3339 timestamp on or after which the update is
380 # considered rolled out to the specified location.
381 &quot;a_key&quot;: &quot;A String&quot;,
382 },
383 },
384 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
385 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
386 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for the resource.
387 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Set the secure boot keys of shielded instance.
388 # these are public keys which are safe to store in public
389 &quot;dbs&quot;: [ # The Key Database (db).
390 {
391 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
392 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
393 },
394 ],
395 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
396 {
397 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
398 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
399 },
400 ],
401 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
402 {
403 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
404 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
405 },
406 ],
407 &quot;pk&quot;: { # The Platform Key (PK).
408 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
409 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
410 },
411 },
412 &quot;sourceDisk&quot;: &quot;A String&quot;, # URL of the source disk used to create this image.
413 # For example, the following are valid values:
414 #
415 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
416 # - projects/project/zones/zone/disks/disk
417 # - zones/zone/disks/disk
418 #
419 #
420 #
421 # In order to create an image, you must provide the full or partial URL of
422 # one of the following:
423 #
424 # - The rawDisk.source URL
425 # - The sourceDisk URL
426 # - The sourceImage URL
427 # - The sourceSnapshot URL
428 &quot;sourceDiskEncryptionKey&quot;: { # Thecustomer-supplied
429 # encryption key of the source disk. Required if the source disk is
430 # protected by a customer-supplied encryption key.
431 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
432 # For example:
433 #
434 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
435 # key_region/cryptoKeys/key
436 #
437 # The fully-qualifed key name may be returned for resource GET requests. For
438 # example:
439 #
440 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
441 # key_region/cryptoKeys/key
442 # /cryptoKeyVersions/1
443 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
444 # key. If absent, the Compute Engine default service account is used.
445 # For example:
446 #
447 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
448 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
449 # encryption key, encoded in RFC
450 # 4648 base64 to either encrypt or decrypt this resource. You can
451 # provide either the rawKey or thersaEncryptedKey.
452 # For example:
453 #
454 # &quot;rawKey&quot;:
455 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
456 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
457 # customer-supplied encryption key to either encrypt or decrypt this
458 # resource. You can provide either the rawKey or thersaEncryptedKey.
459 # For example:
460 #
461 # &quot;rsaEncryptedKey&quot;:
462 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
463 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
464 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
465 #
466 # The key must meet the following requirements before you can provide it to
467 # Compute Engine:
468 #
469 # 1. The key is wrapped using a RSA public key certificate provided by
470 # Google.
471 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
472 # encoding.
473 #
474 # Gets the RSA public key certificate provided by Google at:
475 #
476 #
477 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
478 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
479 # 4648 base64 encoded SHA-256 hash of the customer-supplied
480 # encryption key that protects this resource.
481 },
482 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only]
483 # The ID value of the disk used to create this image. This value may be used
484 # to determine whether the image was taken from the current or a previous
485 # instance of a given disk name.
486 &quot;sourceImage&quot;: &quot;A String&quot;, # URL of the source image used to create this image.
487 # The following are valid formats for the URL:
488 #
489 # - https://www.googleapis.com/compute/v1/projects/project_id/global/
490 # images/image_name
491 # - projects/project_id/global/images/image_name
492 #
493 #
494 #
495 # In order to create an image, you must provide the full or partial URL of
496 # one of the following:
497 #
498 # - The rawDisk.source URL
499 # - The sourceDisk URL
500 # - The sourceImage URL
501 # - The sourceSnapshot URL
502 &quot;sourceImageEncryptionKey&quot;: { # The customer-supplied encryption key of the source image. Required if the
503 # source image is protected by a customer-supplied encryption key.
504 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
505 # For example:
506 #
507 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
508 # key_region/cryptoKeys/key
509 #
510 # The fully-qualifed key name may be returned for resource GET requests. For
511 # example:
512 #
513 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
514 # key_region/cryptoKeys/key
515 # /cryptoKeyVersions/1
516 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
517 # key. If absent, the Compute Engine default service account is used.
518 # For example:
519 #
520 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
521 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
522 # encryption key, encoded in RFC
523 # 4648 base64 to either encrypt or decrypt this resource. You can
524 # provide either the rawKey or thersaEncryptedKey.
525 # For example:
526 #
527 # &quot;rawKey&quot;:
528 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
529 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
530 # customer-supplied encryption key to either encrypt or decrypt this
531 # resource. You can provide either the rawKey or thersaEncryptedKey.
532 # For example:
533 #
534 # &quot;rsaEncryptedKey&quot;:
535 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
536 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
537 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
538 #
539 # The key must meet the following requirements before you can provide it to
540 # Compute Engine:
541 #
542 # 1. The key is wrapped using a RSA public key certificate provided by
543 # Google.
544 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
545 # encoding.
546 #
547 # Gets the RSA public key certificate provided by Google at:
548 #
549 #
550 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
551 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
552 # 4648 base64 encoded SHA-256 hash of the customer-supplied
553 # encryption key that protects this resource.
554 },
555 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only]
556 # The ID value of the image used to create this image. This value may be used
557 # to determine whether the image was taken from the current or a previous
558 # instance of a given image name.
559 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # URL of the source snapshot used to create this image.
560 # The following are valid formats for the URL:
561 #
562 # - https://www.googleapis.com/compute/v1/projects/project_id/global/
563 # snapshots/snapshot_name
564 # - projects/project_id/global/snapshots/snapshot_name
565 #
566 #
567 #
568 # In order to create an image, you must provide the full or partial URL of
569 # one of the following:
570 #
571 # - The rawDisk.source URL
572 # - The sourceDisk URL
573 # - The sourceImage URL
574 # - The sourceSnapshot URL
575 &quot;sourceSnapshotEncryptionKey&quot;: { # The customer-supplied encryption key of the source snapshot. Required if
576 # the source snapshot is protected by a customer-supplied encryption key.
577 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
578 # For example:
579 #
580 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
581 # key_region/cryptoKeys/key
582 #
583 # The fully-qualifed key name may be returned for resource GET requests. For
584 # example:
585 #
586 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
587 # key_region/cryptoKeys/key
588 # /cryptoKeyVersions/1
589 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
590 # key. If absent, the Compute Engine default service account is used.
591 # For example:
592 #
593 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
594 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
595 # encryption key, encoded in RFC
596 # 4648 base64 to either encrypt or decrypt this resource. You can
597 # provide either the rawKey or thersaEncryptedKey.
598 # For example:
599 #
600 # &quot;rawKey&quot;:
601 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
602 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
603 # customer-supplied encryption key to either encrypt or decrypt this
604 # resource. You can provide either the rawKey or thersaEncryptedKey.
605 # For example:
606 #
607 # &quot;rsaEncryptedKey&quot;:
608 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
609 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
610 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
611 #
612 # The key must meet the following requirements before you can provide it to
613 # Compute Engine:
614 #
615 # 1. The key is wrapped using a RSA public key certificate provided by
616 # Google.
617 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
618 # encoding.
619 #
620 # Gets the RSA public key certificate provided by Google at:
621 #
622 #
623 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
624 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
625 # 4648 base64 encoded SHA-256 hash of the customer-supplied
626 # encryption key that protects this resource.
627 },
628 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only]
629 # The ID value of the snapshot used to create this image. This value may be
630 # used to determine whether the snapshot was taken from the current or a
631 # previous instance of a given snapshot name.
632 &quot;sourceType&quot;: &quot;RAW&quot;, # The type of the image used to create this disk. The
633 # default and only valid value is RAW.
634 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the image. An image can be used to create other
635 # resources, such as instances, only after the image has been successfully
636 # created and the status is set to READY. Possible
637 # values are FAILED, PENDING, orREADY.
638 &quot;storageLocations&quot;: [ # Cloud Storage bucket storage location of the image (regional or
639 # multi-regional).
640 &quot;A String&quot;,
641 ],
642 },
643 }</pre>
644 </div>
645
646 </body></html>