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. UseisAttached
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
-
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: