machine_images
Creates, updates, deletes, gets or lists a machine_images resource.
Overview
| Name | machine_images |
| Type | Resource |
| Id | google.compute.machine_images |
Fields
| Name | Datatype | Description |
|---|---|---|
id | string | [Output Only] A unique identifier for this machine image. The server defines this identifier. |
name | string | Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. |
description | string | An optional description of this resource. Provide this property when you create the resource. |
creationTimestamp | string | [Output Only] The creation timestamp for this machine image in RFC3339 text format. |
guestFlush | boolean | [Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process. |
instanceProperties | object | |
kind | string | [Output Only] The resource type, which is always compute#machineImage for machine image. |
machineImageEncryptionKey | object | |
satisfiesPzi | boolean | Output only. Reserved for future use. |
satisfiesPzs | boolean | [Output Only] Reserved for future use. |
savedDisks | array | An array of Machine Image specific properties for disks attached to the source instance |
selfLink | string | [Output Only] The URL for this machine image. The server defines this URL. |
sourceDiskEncryptionKeys | array | [Input Only] The customer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key. |
sourceInstance | string | The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /instances/instance - projects/project/zones/zone/instances/instance |
sourceInstanceProperties | object | DEPRECATED: Please use compute#instanceProperties instead. New properties will not be added to this field. |
status | string | [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. |
storageLocations | array | The regional or multi-regional Cloud Storage bucket location where the machine image is stored. |
totalStorageBytes | string | [Output Only] Total size of the storage used by the machine image. |
Methods
| Name | Accessible by | Required Params | Description |
|---|---|---|---|
get | SELECT | machineImage, project | Returns the specified machine image. |
list | SELECT | project | Retrieves a list of machine images that are contained within the specified project. |
insert | INSERT | project | Creates a machine image in the specified project using the data that is included in the request. If you are creating a new machine image to update an existing instance, your new machine image should use the same network or, if applicable, the same subnetwork as the original instance. |
delete | DELETE | machineImage, project | Deletes the specified machine image. Deleting a machine image is permanent and cannot be undone. |
SELECT examples
Retrieves a list of machine images that are contained within the specified project.
SELECT
id,
name,
description,
creationTimestamp,
guestFlush,
instanceProperties,
kind,
machineImageEncryptionKey,
satisfiesPzi,
satisfiesPzs,
savedDisks,
selfLink,
sourceDiskEncryptionKeys,
sourceInstance,
sourceInstanceProperties,
status,
storageLocations,
totalStorageBytes
FROM google.compute.machine_images
WHERE project = '{{ project }}';
INSERT example
Use the following StackQL query and manifest file to create a new machine_images resource.
- All Properties
- Manifest
/*+ create */
INSERT INTO google.compute.machine_images (
project,
name,
description,
sourceInstance,
status,
sourceInstanceProperties,
instanceProperties,
savedDisks,
storageLocations,
machineImageEncryptionKey,
guestFlush,
sourceDiskEncryptionKeys,
totalStorageBytes,
satisfiesPzs
)
SELECT
'{{ project }}',
'{{ name }}',
'{{ description }}',
'{{ sourceInstance }}',
'{{ status }}',
'{{ sourceInstanceProperties }}',
'{{ instanceProperties }}',
'{{ savedDisks }}',
'{{ storageLocations }}',
'{{ machineImageEncryptionKey }}',
{{ guestFlush }},
'{{ sourceDiskEncryptionKeys }}',
'{{ totalStorageBytes }}',
{{ satisfiesPzs }}
;
- name: your_resource_model_name
props:
- name: kind
value: string
- name: id
value: string
- name: creationTimestamp
value: string
- name: name
value: string
- name: description
value: string
- name: selfLink
value: string
- name: sourceInstance
value: string
- name: status
value: string
- name: sourceInstanceProperties
value:
- name: description
value: string
- name: tags
value:
- name: items
value:
- string
- name: fingerprint
value: string
- name: machineType
value: string
- name: canIpForward
value: boolean
- name: networkInterfaces
value:
- - name: kind
value: string
- name: network
value: string
- name: subnetwork
value: string
- name: networkIP
value: string
- name: ipv6Address
value: string
- name: internalIpv6PrefixLength
value: integer
- name: name
value: string
- name: accessConfigs
value:
- - name: kind
value: string
- name: type
value: string
- name: name
value: string
- name: natIP
value: string
- name: externalIpv6
value: string
- name: externalIpv6PrefixLength
value: integer
- name: setPublicPtr
value: boolean
- name: publicPtrDomainName
value: string
- name: networkTier
value: string
- name: securityPolicy
value: string
- name: ipv6AccessConfigs
value:
- - name: kind
value: string
- name: type
value: string
- name: name
value: string
- name: natIP
value: string
- name: externalIpv6
value: string
- name: externalIpv6PrefixLength
value: integer
- name: setPublicPtr
value: boolean
- name: publicPtrDomainName
value: string
- name: networkTier
value: string
- name: securityPolicy
value: string
- name: aliasIpRanges
value:
- - name: ipCidrRange
value: string
- name: subnetworkRangeName
value: string
- name: fingerprint
value: string
- name: stackType
value: string
- name: ipv6AccessType
value: string
- name: queueCount
value: integer
- name: nicType
value: string
- name: networkAttachment
value: string
- name: disks
value:
- - name: kind
value: string
- name: type
value: string
- name: mode
value: string
- name: source
value: string
- name: deviceName
value: string
- name: index
value: integer
- name: boot
value: boolean
- name: autoDelete
value: boolean
- name: licenses
value:
- string
- name: interface
value: string
- name: guestOsFeatures
value:
- - name: type
value: string
- name: diskEncryptionKey
value:
- name: rawKey
value: string
- name: rsaEncryptedKey
value: string
- name: kmsKeyName
value: string
- name: sha256
value: string
- name: kmsKeyServiceAccount
value: string
- name: diskSizeGb
value: string
- name: storageBytes
value: string
- name: storageBytesStatus
value: string
- name: diskType
value: string
- name: metadata
value:
- name: kind
value: string
- name: fingerprint
value: string
- name: items
value:
- - name: key
value: string
- name: value
value: string
- name: serviceAccounts
value:
- - name: email
value: string
- name: scopes
value:
- string
- name: scheduling
value:
- name: onHostMaintenance
value: string
- name: automaticRestart
value: boolean
- name: preemptible
value: boolean
- name: nodeAffinities
value:
- - name: key
value: string
- name: operator
value: string
- name: values
value:
- string
- name: minNodeCpus
value: integer
- name: locationHint
value: string
- name: availabilityDomain
value: integer
- name: provisioningModel
value: string
- name: instanceTerminationAction
value: string
- name: maxRunDuration
value:
- name: seconds
value: string
- name: nanos
value: integer
- name: terminationTime
value: string
- name: onInstanceStopAction
value:
- name: discardLocalSsd
value: boolean
- name: labels
value: object
- name: guestAccelerators
value:
- - name: acceleratorType
value: string
- name: acceleratorCount
value: integer
- name: minCpuPlatform
value: string
- name: deletionProtection
value: boolean
- name: keyRevocationActionType
value: string
- name: instanceProperties
value:
- name: description
value: string
- name: resourceManagerTags
value: object
- name: machineType
value: string
- name: canIpForward
value: boolean
- name: networkInterfaces
value:
- - name: kind
value: string
- name: network
value: string
- name: subnetwork
value: string
- name: networkIP
value: string
- name: ipv6Address
value: string
- name: internalIpv6PrefixLength
value: integer
- name: name
value: string
- name: accessConfigs
value:
- - name: kind
value: string
- name: type
value: string
- name: name
value: string
- name: natIP
value: string
- name: externalIpv6
value: string
- name: externalIpv6PrefixLength
value: integer
- name: setPublicPtr
value: boolean
- name: publicPtrDomainName
value: string
- name: networkTier
value: string
- name: securityPolicy
value: string
- name: ipv6AccessConfigs
value:
- - name: kind
value: string
- name: type
value: string
- name: name
value: string
- name: natIP
value: string
- name: externalIpv6
value: string
- name: externalIpv6PrefixLength
value: integer
- name: setPublicPtr
value: boolean
- name: publicPtrDomainName
value: string
- name: networkTier
value: string
- name: securityPolicy
value: string
- name: aliasIpRanges
value:
- - name: ipCidrRange
value: string
- name: subnetworkRangeName
value: string
- name: fingerprint
value: string
- name: stackType
value: string
- name: ipv6AccessType
value: string
- name: queueCount
value: integer
- name: nicType
value: string
- name: networkAttachment
value: string
- name: disks
value:
- - name: kind
value: string
- name: type
value: string
- name: mode
value: string
- name: savedState
value: string
- name: source
value: string
- name: deviceName
value: string
- name: index
value: integer
- name: boot
value: boolean
- name: initializeParams
value:
- name: diskName
value: string
- name: sourceImage
value: string
- name: diskSizeGb
value: string
- name: diskType
value: string
- name: labels
value: object
- name: sourceSnapshot
value: string
- name: description
value: string
- name: replicaZones
value:
- string
- name: resourcePolicies
value:
- string
- name: onUpdateAction
value: string
- name: provisionedIops
value: string
- name: licenses
value:
- string
- name: architecture
value: string
- name: resourceManagerTags
value: object
- name: provisionedThroughput
value: string
- name: enableConfidentialCompute
value: boolean
- name: storagePool
value: string
- name: autoDelete
value: boolean
- name: licenses
value:
- string
- name: interface
value: string
- name: guestOsFeatures
value:
- - name: type
value: string
- name: diskSizeGb
value: string
- name: shieldedInstanceInitialState
value:
- name: pk
value:
- name: content
value: string
- name: fileType
value: string
- name: keks
value:
- - name: content
value: string
- name: fileType
value: string
- name: dbs
value:
- - name: content
value: string
- name: fileType
value: string
- name: dbxs
value:
- - name: content
value: string
- name: fileType
value: string
- name: forceAttach
value: boolean
- name: architecture
value: string
- name: serviceAccounts
value:
- - name: email
value: string
- name: scopes
value:
- string
- name: labels
value: object
- name: guestAccelerators
value:
- - name: acceleratorType
value: string
- name: acceleratorCount
value: integer
- name: minCpuPlatform
value: string
- name: reservationAffinity
value:
- name: consumeReservationType
value: string
- name: key
value: string
- name: values
value:
- string
- name: shieldedInstanceConfig
value:
- name: enableSecureBoot
value: boolean
- name: enableVtpm
value: boolean
- name: enableIntegrityMonitoring
value: boolean
- name: resourcePolicies
value:
- string
- name: confidentialInstanceConfig
value:
- name: enableConfidentialCompute
value: boolean
- name: confidentialInstanceType
value: string
- name: privateIpv6GoogleAccess
value: string
- name: advancedMachineFeatures
value:
- name: enableNestedVirtualization
value: boolean
- name: threadsPerCore
value: integer
- name: visibleCoreCount
value: integer
- name: enableUefiNetworking
value: boolean
- name: performanceMonitoringUnit
value: string
- name: turboMode
value: string
- name: networkPerformanceConfig
value:
- name: totalEgressBandwidthTier
value: string
- name: keyRevocationActionType
value: string
- name: savedDisks
value:
- - name: kind
value: string
- name: sourceDisk
value: string
- name: storageBytes
value: string
- name: storageBytesStatus
value: string
- name: architecture
value: string
- name: storageLocations
value:
- string
- name: guestFlush
value: boolean
- name: sourceDiskEncryptionKeys
value:
- - name: sourceDisk
value: string
- name: totalStorageBytes
value: string
- name: satisfiesPzs
value: boolean
- name: satisfiesPzi
value: boolean
DELETE example
Deletes the specified machine_images resource.
/*+ delete */
DELETE FROM google.compute.machine_images
WHERE machineImage = '{{ machineImage }}'
AND project = '{{ project }}';