Amazon EBS API Overview
To configure and use Amazon EBS, we provide eight API functions. This section provides a brief overview of each function. For information on Amazon EBS concepts, see Amazon Elastic Block Store.
-
CreateVolume—Creates a new Amazon EBS volume using the specified size or creates a new volume based on a previously created snapshot.
-
DeleteVolume—Deletes the specified volume.
This function does not delete any snapshots that were created from this volume.
-
DescribeVolumes—Describes all volumes, including size, source snapshot, Availability Zone, creation time, and status (
available
,in-use
). -
AttachVolume—Attaches the specified volume to a specified instance, exposing the volume using the specified device name.
A volume can only be attached to a single instance at any time. The volume and instance must be in the same Availability Zone and the instance must be running.
-
DetachVolume—Detaches the specified volume from the instance to which it is attached.
This operation does not delete the volume. The volume can be attached to another instance and will have the same data as when it was detached.
-
CreateSnapshot—Creates a snapshot of the volume you specify.
Once created, you can use the snapshot to create volumes that contain exactly the same data as the original volume.
-
DeleteSnapshot—Deletes the specified snapshot.
This function does not affect currently running Amazon EBS volumes, regardless of whether they were used to create the snapshot or were derived from the snapshot.
-
DescribeSnapshots—Describes all snapshots, including their source volume, snapshot initiation time, progress (percentage complete), and status (
pending
,completed
). -
ModifySnapshotAttribute—Modifies permissions for a snapshot. You can specify one or more users or
all
to make the snapshot public. -
DescribeSnapshotAttribute—Describes permissions for a snapshot.