Disk - Amazon Lightsail

Disk

Describes a block storage disk.

Contents

addOns

An array of objects representing the add-ons enabled on the disk.

Type: Array of AddOn objects

Required: No

arn

The Amazon Resource Name (ARN) of the disk.

Type: String

Pattern: .*\S.*

Required: No

attachedTo

The resources to which the disk is attached.

Type: String

Pattern: \w[\w\-]*\w

Required: No

attachmentState

This member has been deprecated.

(Discontinued) The attachment state of the disk.

Note

In releases prior to November 14, 2017, this parameter returned attached for system disks in the API response. It is now discontinued, but still included in the response. Use isAttached instead.

Type: String

Required: No

autoMountStatus

The status of automatically mounting a storage disk to a virtual computer.

Important

This parameter only applies to Lightsail for Research resources.

Type: String

Valid Values: Failed | Pending | Mounted | NotMounted

Required: No

createdAt

The date when the disk was created.

Type: Timestamp

Required: No

gbInUse

This member has been deprecated.

(Discontinued) The number of GB in use by the disk.

Note

In releases prior to November 14, 2017, this parameter was not included in the API response. It is now discontinued.

Type: Integer

Required: No

iops

The input/output operations per second (IOPS) of the disk.

Type: Integer

Required: No

isAttached

A Boolean value indicating whether the disk is attached.

Type: Boolean

Required: No

isSystemDisk

A Boolean value indicating whether this disk is a system disk (has an operating system loaded on it).

Type: Boolean

Required: No

location

The AWS Region and Availability Zone where the disk is located.

Type: ResourceLocation object

Required: No

name

The unique name of the disk.

Type: String

Pattern: \w[\w\-]*\w

Required: No

path

The disk path.

Type: String

Required: No

resourceType

The Lightsail resource type (Disk).

Type: String

Valid Values: ContainerService | Instance | StaticIp | KeyPair | InstanceSnapshot | Domain | PeeredVpc | LoadBalancer | LoadBalancerTlsCertificate | Disk | DiskSnapshot | RelationalDatabase | RelationalDatabaseSnapshot | ExportSnapshotRecord | CloudFormationStackRecord | Alarm | ContactMethod | Distribution | Certificate | Bucket

Required: No

sizeInGb

The size of the disk in GB.

Type: Integer

Required: No

state

Describes the status of the disk.

Type: String

Valid Values: pending | error | available | in-use | unknown

Required: No

supportCode

The support code. Include this code in your email to support when you have questions about an instance or another resource in Lightsail. This code enables our support team to look up your Lightsail information more easily.

Type: String

Required: No

tags

The tag keys and optional values for the resource. For more information about tags in Lightsail, see the Amazon Lightsail Developer Guide.

Type: Array of Tag objects

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: