instant_snapshots

Creates, updates, deletes, gets or lists a instant_snapshots resource.

Overview

Name	`instant_snapshots`
Type	Resource
Id	`google.compute.instant_snapshots`

Fields

Name	Datatype	Description
`id`	`string`	[Output Only] The unique identifier for the resource. This identifier is defined by the server.
`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.
`architecture`	`string`	[Output Only] The architecture of the instant snapshot. Valid values are ARM64 or X86_64.
`creationTimestamp`	`string`	[Output Only] Creation timestamp in RFC3339 text format.
`diskSizeGb`	`string`	[Output Only] Size of the source disk, specified in GB.
`kind`	`string`	[Output Only] Type of the resource. Always compute#instantSnapshot for InstantSnapshot resources.
`labelFingerprint`	`string`	A fingerprint for the labels being applied to this InstantSnapshot, which is essentially a hash of the labels set used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash in order to update or change labels, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a InstantSnapshot.
`labels`	`object`	Labels to apply to this InstantSnapshot. These can be later modified by the setLabels method. Label values may be empty.
`region`	`string`	[Output Only] URL of the region where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.
`resourceStatus`	`object`
`satisfiesPzi`	`boolean`	Output only. Reserved for future use.
`satisfiesPzs`	`boolean`	[Output Only] Reserved for future use.
`selfLink`	`string`	[Output Only] Server-defined URL for the resource.
`selfLinkWithId`	`string`	[Output Only] Server-defined URL for this resource's resource id.
`sourceDisk`	`string`	URL of the source disk used to create this instant snapshot. Note that the source disk must be in the same zone/region as the instant snapshot to be created. This can be a full or valid partial URL. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone /disks/disk - https://www.googleapis.com/compute/v1/projects/project/regions/region /disks/disk - projects/project/zones/zone/disks/disk - projects/project/regions/region/disks/disk - zones/zone/disks/disk - regions/region/disks/disk
`sourceDiskId`	`string`	[Output Only] The ID value of the disk used to create this InstantSnapshot. This value may be used to determine whether the InstantSnapshot was taken from the current or a previous instance of a given disk name.
`status`	`string`	[Output Only] The status of the instantSnapshot. This can be CREATING, DELETING, FAILED, or READY.
`zone`	`string`	[Output Only] URL of the zone where the instant snapshot resides. You must specify this field as part of the HTTP request URL. It is not settable as a field in the request body.

Methods

Name	Accessible by	Required Params	Description
`aggregated_list`	`SELECT`	`project`	Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the `returnPartialSuccess` parameter to `true`.
`get`	`SELECT`	`instantSnapshot, project, zone`	Returns the specified InstantSnapshot resource in the specified zone.
`list`	`SELECT`	`project, zone`	Retrieves the list of InstantSnapshot resources contained within the specified zone.
`insert`	`INSERT`	`project, zone`	Creates an instant snapshot in the specified zone.
`delete`	`DELETE`	`instantSnapshot, project, zone`	Deletes the specified InstantSnapshot resource. Keep in mind that deleting a single instantSnapshot might not necessarily delete all the data on that instantSnapshot. If any data on the instantSnapshot that is marked for deletion is needed for subsequent instantSnapshots, the data will be moved to the next corresponding instantSnapshot. For more information, see Deleting instantSnapshots.
`set_labels`	`EXEC`	`project, resource, zone`	Sets the labels on a instantSnapshot in the given zone. To learn more about labels, read the Labeling Resources documentation.

`SELECT` examples

Retrieves an aggregated list of instantSnapshots. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

SELECT
id,
name,
description,
architecture,
creationTimestamp,
diskSizeGb,
kind,
labelFingerprint,
labels,
region,
resourceStatus,
satisfiesPzi,
satisfiesPzs,
selfLink,
selfLinkWithId,
sourceDisk,
sourceDiskId,
status,
zone
FROM google.compute.instant_snapshots
WHERE project = '{{ project }}';

`INSERT` example

Use the following StackQL query and manifest file to create a new instant_snapshots resource.

All Properties
Manifest

/*+ create */
INSERT INTO google.compute.instant_snapshots (
project,
zone,
name,
description,
status,
sourceDisk,
sourceDiskId,
diskSizeGb,
labels,
labelFingerprint,
zone,
region,
satisfiesPzs,
architecture,
resourceStatus
)
SELECT 
'{{ project }}',
'{{ zone }}',
'{{ name }}',
'{{ description }}',
'{{ status }}',
'{{ sourceDisk }}',
'{{ sourceDiskId }}',
'{{ diskSizeGb }}',
'{{ labels }}',
'{{ labelFingerprint }}',
'{{ zone }}',
'{{ region }}',
{{ satisfiesPzs }},
'{{ architecture }}',
'{{ resourceStatus }}'
;

- 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: status
      value: string
    - name: sourceDisk
      value: string
    - name: sourceDiskId
      value: string
    - name: diskSizeGb
      value: string
    - name: selfLink
      value: string
    - name: selfLinkWithId
      value: string
    - name: labels
      value: object
    - name: labelFingerprint
      value: string
    - name: zone
      value: string
    - name: region
      value: string
    - name: satisfiesPzs
      value: boolean
    - name: architecture
      value: string
    - name: resourceStatus
      value:
        - name: storageSizeBytes
          value: string
    - name: satisfiesPzi
      value: boolean

`DELETE` example

Deletes the specified instant_snapshots resource.

/*+ delete */
DELETE FROM google.compute.instant_snapshots
WHERE instantSnapshot = '{{ instantSnapshot }}'
AND project = '{{ project }}'
AND zone = '{{ zone }}';

Overview​

Fields​

Methods​

SELECT examples​

INSERT example​

DELETE example​