google::compute-disk

Creates a zonal disk.

Example

google::compute-disk disk-example
    name: "disk-example"
    description: "disk-example-desc"
    zone: "us-central1-a"
    size-gb: 32
    type: "pd-standard"
    labels: {
        label-key: 'label-value'
    }
    physical-block-size-bytes: 4096
    resource-policy: $(google::compute-resource-policy example-policy-disk-alpha)
end
google::compute-disk disk-image-example
    name: "disk-image-example"
    description: "disk-image-example-desc"
    zone: "us-west1-a"
    source-image: $(google::compute-image image-example)

    source-image-encryption-key
        raw-key: "SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0="
    end
end

Attributes

Attribute Description
name The name of the disk. Must be a string 1-63 characters long and match the regular expression [a-z](?:[-a-z0-9]{0,61}[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. Valid values satisfy the regex: [[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?]. (Required)
description The description of the disk.
size-gb The size of the persistent disk, specified in GB. Values must be in the range 1 to 65536, inclusive. The size can only be increased once it has been set. If you specify this field along with sourceSnapshot, the value must not be less than the size of the snapshot. Valid values are between 1 to 65536.
source-snapshot The source snapshot used to create the disk. Cannot be set if source-image is set.
disk-encryption-key subresource

The encryption key used to encrypt the disk. Only use this if you have not specified a source snapshot. If you do not provide an encryption key when creating the disk, the disk will be encrypted using an automatically generated key.

raw-key
The 256-bit encryption key, encoded in RFC 4648 base64, that protects this resource. See Encrypt disks with customer-supplied encryption keys. (Required)
source-snapshot-encryption-key subresource

The encryption key of the source snapshot. This is required if the source snapshot is protected by a customer-supplied encryption key.

raw-key
The 256-bit encryption key, encoded in RFC 4648 base64, that protects this resource. See Encrypt disks with customer-supplied encryption keys. (Required)
labels map Optional labels (key-value pairs) that can be applied to the disk. The only characters allowed are lowercase characters, international characters, numbers, -, and _. Key and value must be under 64 characters.
physical-block-size-bytes The physical block size of the disk, in bytes. Defaults to 4096. Valid values are 4096.0 or ``16384.0`.
resource-policy list Adds an existing resource policy to a disk which will be applied to this disk for scheduling snapshot creation.
zone The zone where the disk resides. (Required)
type The disk type used to create the disk.
source-image The source image used to create this disk. Cannot be set if source-snapshot is set.
source-image-encryption-key subresource

The encryption key of the source image. This is required if the source image is protected by a customer-supplied encryption key.

raw-key
The 256-bit encryption key, encoded in RFC 4648 base64, that protects this resource. See Encrypt disks with customer-supplied encryption keys. (Required)

Outputs

Attribute Description
status The status of disk creation. Valid values are CREATING, RESTORING, FAILED, READY or DELETING.
source-snapshot-id The unique ID of the snapshot used to create the disk.
self-link The fully-qualified URL linking back to the disk.
users list Links to the attached instances of the disk.
label-fingerprint The fingerprint for the labels being applied to the disk, which is updated any time the labels change.