Reference documentation and code samples for the Google Cloud Compute V1 API class Google::Cloud::Compute::V1::AttachedDisk.
An instance-attached disk resource.
Inherits
- Object
Extended By
- Google::Protobuf::MessageExts::ClassMethods
Includes
- Google::Protobuf::MessageExts
Methods
#architecture
def architecture() -> ::String- (::String) — Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. Check the Architecture enum for the list of possible values.
#architecture=
def architecture=(value) -> ::String- value (::String) — Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. Check the Architecture enum for the list of possible values.
- (::String) — Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64 or X86_64. Check the Architecture enum for the list of possible values.
#auto_delete
def auto_delete() -> ::Boolean- (::Boolean) — Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
#auto_delete=
def auto_delete=(value) -> ::Boolean- value (::Boolean) — Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
- (::Boolean) — Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
#boot
def boot() -> ::Boolean- (::Boolean) — Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
#boot=
def boot=(value) -> ::Boolean- value (::Boolean) — Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
- (::Boolean) — Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
#device_name
def device_name() -> ::String-
(::String) — Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
running within the instance. This name can be used to reference the device
for mounting, resizing, and so on, from within the instance.
If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.
#device_name=
def device_name=(value) -> ::String-
value (::String) — Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
running within the instance. This name can be used to reference the device
for mounting, resizing, and so on, from within the instance.
If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.
-
(::String) — Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
running within the instance. This name can be used to reference the device
for mounting, resizing, and so on, from within the instance.
If not specified, the server chooses a default device name to apply to this disk, in the form persistent-disk-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.
#disk_encryption_key
def disk_encryption_key() -> ::Google::Cloud::Compute::V1::CustomerEncryptionKey-
(::Google::Cloud::Compute::V1::CustomerEncryptionKey) — Encrypts or decrypts a disk using acustomer-supplied
encryption key.
If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key.
If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance.
If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later.
Note:
Instance templates do not storecustomer-supplied encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
You cannot create VMs that have disks with customer-supplied keys using the bulk insert method.
#disk_encryption_key=
def disk_encryption_key=(value) -> ::Google::Cloud::Compute::V1::CustomerEncryptionKey-
value (::Google::Cloud::Compute::V1::CustomerEncryptionKey) — Encrypts or decrypts a disk using acustomer-supplied
encryption key.
If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key.
If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance.
If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later.
Note:
Instance templates do not storecustomer-supplied encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
You cannot create VMs that have disks with customer-supplied keys using the bulk insert method.
-
(::Google::Cloud::Compute::V1::CustomerEncryptionKey) — Encrypts or decrypts a disk using acustomer-supplied
encryption key.
If you are creating a new disk, this field encrypts the new disk using an encryption key that you provide. If you are attaching an existing disk that is already encrypted, this field decrypts the disk using the customer-supplied encryption key.
If you encrypt a disk using a customer-supplied key, you must provide the same key again when you attempt to use this resource at a later time. For example, you must provide the key when you create a snapshot or an image from the disk or when you attach the disk to a virtual machine instance.
If you do not provide an encryption key, then the disk will be encrypted using an automatically generated key and you do not need to provide a key to use the disk later.
Note:
Instance templates do not storecustomer-supplied encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
You cannot create VMs that have disks with customer-supplied keys using the bulk insert method.
#disk_size_gb
def disk_size_gb() -> ::Integer- (::Integer) — The size of the disk in GB.
#disk_size_gb=
def disk_size_gb=(value) -> ::Integer- value (::Integer) — The size of the disk in GB.
- (::Integer) — The size of the disk in GB.
#force_attach
def force_attach() -> ::Boolean- (::Boolean) — [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.
#force_attach=
def force_attach=(value) -> ::Boolean- value (::Boolean) — [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.
- (::Boolean) — [Input Only] Whether to force attach the regional disk even if it's currently attached to another instance. If you try to force attach a zonal disk to an instance, you will receive an error.
#guest_os_features
def guest_os_features() -> ::Array<::Google::Cloud::Compute::V1::GuestOsFeature>- (::Array<::Google::Cloud::Compute::V1::GuestOsFeature>) — A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.
#guest_os_features=
def guest_os_features=(value) -> ::Array<::Google::Cloud::Compute::V1::GuestOsFeature>- value (::Array<::Google::Cloud::Compute::V1::GuestOsFeature>) — A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.
- (::Array<::Google::Cloud::Compute::V1::GuestOsFeature>) — A list of features to enable on the guest operating system. Applicable only for bootable images. Read Enabling guest operating system features to see a list of available options.
#index
def index() -> ::Integer- (::Integer) — Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number.
#index=
def index=(value) -> ::Integer- value (::Integer) — Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number.
- (::Integer) — Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the boot disk. If you have many disks attached to an instance, each disk would have a unique index number.
#initialize_params
def initialize_params() -> ::Google::Cloud::Compute::V1::AttachedDiskInitializeParams-
(::Google::Cloud::Compute::V1::AttachedDiskInitializeParams) — [Input Only] Specifies the parameters for a new disk that will be created
alongside the new instance. Use initialization parameters to create boot
disks or local SSDs attached to the new instance.
This property is mutually exclusive with the source property; you can only define one or the other, but not both.
#initialize_params=
def initialize_params=(value) -> ::Google::Cloud::Compute::V1::AttachedDiskInitializeParams-
value (::Google::Cloud::Compute::V1::AttachedDiskInitializeParams) — [Input Only] Specifies the parameters for a new disk that will be created
alongside the new instance. Use initialization parameters to create boot
disks or local SSDs attached to the new instance.
This property is mutually exclusive with the source property; you can only define one or the other, but not both.
-
(::Google::Cloud::Compute::V1::AttachedDiskInitializeParams) — [Input Only] Specifies the parameters for a new disk that will be created
alongside the new instance. Use initialization parameters to create boot
disks or local SSDs attached to the new instance.
This property is mutually exclusive with the source property; you can only define one or the other, but not both.
#interface
def interface() -> ::String- (::String) — Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, seeAbout persistent disks. Check the Interface enum for the list of possible values.
#interface=
def interface=(value) -> ::String- value (::String) — Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, seeAbout persistent disks. Check the Interface enum for the list of possible values.
- (::String) — Specifies the disk interface to use for attaching this disk, which is either SCSI or NVME. For most machine types, the default is SCSI. Local SSDs can use either NVME or SCSI. In certain configurations, persistent disks can use NVMe. For more information, seeAbout persistent disks. Check the Interface enum for the list of possible values.
#kind
def kind() -> ::String- (::String) — Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
#kind=
def kind=(value) -> ::String- value (::String) — Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
- (::String) — Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
#licenses
def licenses() -> ::Array<::String>- (::Array<::String>) — Output only. [Output Only] Any valid publicly visible licenses.
#licenses=
def licenses=(value) -> ::Array<::String>- value (::Array<::String>) — Output only. [Output Only] Any valid publicly visible licenses.
- (::Array<::String>) — Output only. [Output Only] Any valid publicly visible licenses.
#mode
def mode() -> ::String- (::String) — The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. Check the Mode enum for the list of possible values.
#mode=
def mode=(value) -> ::String- value (::String) — The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. Check the Mode enum for the list of possible values.
- (::String) — The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. Check the Mode enum for the list of possible values.
#saved_state
def saved_state() -> ::String- (::String) — Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. Check the SavedState enum for the list of possible values.
#saved_state=
def saved_state=(value) -> ::String- value (::String) — Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. Check the SavedState enum for the list of possible values.
- (::String) — Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this field is set to PRESERVED if the LocalSSD data has been saved to a persistent location by customer request. (see the discard_local_ssd option on Stop/Suspend). Read-only in the api. Check the SavedState enum for the list of possible values.
#shielded_instance_initial_state
def shielded_instance_initial_state() -> ::Google::Cloud::Compute::V1::InitialStateConfig- (::Google::Cloud::Compute::V1::InitialStateConfig) — Output only. [Output Only] shielded vm initial state stored on disk
#shielded_instance_initial_state=
def shielded_instance_initial_state=(value) -> ::Google::Cloud::Compute::V1::InitialStateConfig- value (::Google::Cloud::Compute::V1::InitialStateConfig) — Output only. [Output Only] shielded vm initial state stored on disk
- (::Google::Cloud::Compute::V1::InitialStateConfig) — Output only. [Output Only] shielded vm initial state stored on disk
#source
def source() -> ::String-
(::String) — Specifies a valid partial or full URL to an existing Persistent Disk
resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
is required.
If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk.
#source=
def source=(value) -> ::String-
value (::String) — Specifies a valid partial or full URL to an existing Persistent Disk
resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
is required.
If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk.
-
(::String) — Specifies a valid partial or full URL to an existing Persistent Disk
resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
is required.
If desired, you can also attach existing non-root persistent disks using this property. This field is only applicable for persistent disks.
Note that for InstanceTemplate, specify the disk name for zonal disk, and the URL for regional disk.
#type
def type() -> ::String- (::String) — Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. Check the Type enum for the list of possible values.
#type=
def type=(value) -> ::String- value (::String) — Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. Check the Type enum for the list of possible values.
- (::String) — Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT. Check the Type enum for the list of possible values.