Reference documentation and code samples for the Compute V1 Client class AttachedDisk.
An instance-attached disk resource.
Generated from protobuf message google.cloud.compute.v1.AttachedDisk
Methods
__construct
Constructor.
data
array
Optional. Data for populating the Message object.
↳ architecture
string
[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
bool
Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
↳ boot
bool
Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
↳ device_name
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
Google\Cloud\Compute\V1\CustomerEncryptionKey
Encrypts or decrypts a disk using a customer-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. Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group.
↳ disk_size_gb
int|string
The size of the disk in GB.
↳ force_attach
bool
[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
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
int
[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
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
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, see About persistent disks. Check the Interface enum for the list of possible values.
↳ kind
string
[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.
↳ licenses
array
[Output Only] Any valid publicly visible licenses.
↳ mode
string
The mode in which to attach this disk, either READ_WRITE or READ_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.
↳ shielded_instance_initial_state
↳ source
string
Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required except for local SSD. 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
string
Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. Check the Type enum for the list of possible values.
getArchitecture
[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.
Generated from protobuf field optional string architecture = 302803283;
string
hasArchitecture
clearArchitecture
setArchitecture
[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.
Generated from protobuf field optional string architecture = 302803283;
var
string
$this
getAutoDelete
Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
Generated from protobuf field optional bool auto_delete = 464761403;
bool
hasAutoDelete
clearAutoDelete
setAutoDelete
Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).
Generated from protobuf field optional bool auto_delete = 464761403;
var
bool
$this
getBoot
Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
Generated from protobuf field optional bool boot = 3029746;
bool
hasBoot
clearBoot
setBoot
Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.
Generated from protobuf field optional bool boot = 3029746;
var
bool
$this
getDeviceName
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.
Generated from protobuf field optional string device_name = 67541716;
string
hasDeviceName
clearDeviceName
setDeviceName
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.
Generated from protobuf field optional string device_name = 67541716;
var
string
$this
getDiskEncryptionKey
Encrypts or decrypts a disk using a customer-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. Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group.
Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677;
hasDiskEncryptionKey
clearDiskEncryptionKey
setDiskEncryptionKey
Encrypts or decrypts a disk using a customer-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. Instance templates do not store customer-supplied encryption keys, so you cannot use your own keys to encrypt disks in a managed instance group.
Generated from protobuf field optional .google.cloud.compute.v1.CustomerEncryptionKey disk_encryption_key = 271660677;
$this
getDiskSizeGb
The size of the disk in GB.
Generated from protobuf field optional int64 disk_size_gb = 316263735;
int|string
hasDiskSizeGb
clearDiskSizeGb
setDiskSizeGb
The size of the disk in GB.
Generated from protobuf field optional int64 disk_size_gb = 316263735;
var
int|string
$this
getForceAttach
[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.
Generated from protobuf field optional bool force_attach = 142758425;
bool
hasForceAttach
clearForceAttach
setForceAttach
[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.
Generated from protobuf field optional bool force_attach = 142758425;
var
bool
$this
getGuestOsFeatures
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.
Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545;
Google\Protobuf\Internal\RepeatedField
setGuestOsFeatures
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.
Generated from protobuf field repeated .google.cloud.compute.v1.GuestOsFeature guest_os_features = 79294545;
$this
getIndex
[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.
Generated from protobuf field optional int32 index = 100346066;
int
hasIndex
clearIndex
setIndex
[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.
Generated from protobuf field optional int32 index = 100346066;
var
int
$this
getInitializeParams
[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.
Generated from protobuf field optional .google.cloud.compute.v1.AttachedDiskInitializeParams initialize_params = 17697045;
hasInitializeParams
clearInitializeParams
setInitializeParams
[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.
Generated from protobuf field optional .google.cloud.compute.v1.AttachedDiskInitializeParams initialize_params = 17697045;
$this
getInterface
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, see About persistent disks.
Check the Interface enum for the list of possible values.
Generated from protobuf field optional string interface = 502623545;
string
hasInterface
clearInterface
setInterface
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, see About persistent disks.
Check the Interface enum for the list of possible values.
Generated from protobuf field optional string interface = 502623545;
var
string
$this
getKind
[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.
Generated from protobuf field optional string kind = 3292052;
string
hasKind
clearKind
setKind
[Output Only] Type of the resource. Always compute#attachedDisk for attached disks.
Generated from protobuf field optional string kind = 3292052;
var
string
$this
getLicenses
[Output Only] Any valid publicly visible licenses.
Generated from protobuf field repeated string licenses = 337642578;
Google\Protobuf\Internal\RepeatedField
setLicenses
[Output Only] Any valid publicly visible licenses.
Generated from protobuf field repeated string licenses = 337642578;
var
string[]
$this
getMode
The mode in which to attach this disk, either READ_WRITE or READ_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.
Generated from protobuf field optional string mode = 3357091;
string
hasMode
clearMode
setMode
The mode in which to attach this disk, either READ_WRITE or READ_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.
Generated from protobuf field optional string mode = 3357091;
var
string
$this
getShieldedInstanceInitialState
[Output Only] shielded vm initial state stored on disk
Generated from protobuf field optional .google.cloud.compute.v1.InitialStateConfig shielded_instance_initial_state = 192356867;
hasShieldedInstanceInitialState
clearShieldedInstanceInitialState
setShieldedInstanceInitialState
[Output Only] shielded vm initial state stored on disk
Generated from protobuf field optional .google.cloud.compute.v1.InitialStateConfig shielded_instance_initial_state = 192356867;
$this
getSource
Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required except for local SSD. 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.
Generated from protobuf field optional string source = 177235995;
string
hasSource
clearSource
setSource
Specifies a valid partial or full URL to an existing Persistent Disk resource. When creating a new instance, one of initializeParams.sourceImage or initializeParams.sourceSnapshot or disks.source is required except for local SSD. 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.
Generated from protobuf field optional string source = 177235995;
var
string
$this
getType
Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
Check the Type enum for the list of possible values.
Generated from protobuf field optional string type = 3575610;
string
hasType
clearType
setType
Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT.
Check the Type enum for the list of possible values.
Generated from protobuf field optional string type = 3575610;
var
string
$this
