Use DescribeVolumeStatus with an AWS SDK or CLI

The following code examples show how to use DescribeVolumeStatus.

CLI

AWS CLI

To describe the status of a single volume

This example command describes the status for the volume vol-1234567890abcdef0.

Command:

aws ec2 describe-volume-status --volume-ids vol-1234567890abcdef0

Output:

{
    "VolumeStatuses": [
        {
            "VolumeStatus": {
                "Status": "ok",
                "Details": [
                    {
                        "Status": "passed",
                        "Name": "io-enabled"
                    },
                    {
                        "Status": "not-applicable",
                        "Name": "io-performance"
                    }
                ]
            },
            "AvailabilityZone": "us-east-1a",
            "VolumeId": "vol-1234567890abcdef0",
            "Actions": [],
            "Events": []
        }
    ]
}

To describe the status of impaired volumes

This example command describes the status for all volumes that are impaired. In this example output, there are no impaired volumes.

Command:

aws ec2 describe-volume-status --filters Name=volume-status.status,Values=impaired

Output:

{
    "VolumeStatuses": []
}

If you have a volume with a failed status check (status is impaired), see Working with an Impaired Volume in the Amazon EC2 User Guide.

• For API details, see DescribeVolumeStatus in AWS CLI Command Reference.

PowerShell

Tools for PowerShell

Example 1: This example describes the status of the specified volume.

Get-EC2VolumeStatus -VolumeId vol-12345678

Output:

Actions          : {}
AvailabilityZone : us-west-2a
Events           : {}
VolumeId         : vol-12345678
VolumeStatus     : Amazon.EC2.Model.VolumeStatusInfo

(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus

Output:

Details                         Status
-------                         ------
{io-enabled, io-performance}    ok

(Get-EC2VolumeStatus -VolumeId vol-12345678).VolumeStatus.Details

Output:

Name                            Status
----                            ------
io-enabled                      passed
io-performance                  not-applicable

• For API details, see DescribeVolumeStatus in AWS Tools for PowerShell Cmdlet Reference.