将 DescribeVolumes 与 CLI 配合使用 - AWS SDK 代码示例

AWS 文档 SDK 示例 GitHub 存储库中还有更多 AWS SDK 示例。

将 DescribeVolumes 与 CLI 配合使用

以下代码示例演示如何使用 DescribeVolumes。

CLI
AWS CLI

示例 1：描述卷

以下 describe-volumes 示例描述了当前区域中的指定卷。

aws ec2 describe-volumes \
    --volume-ids vol-049df61146c4d7901 vol-1234567890abcdef0

输出：

{
    "Volumes": [
        {
            "AvailabilityZone": "us-east-1a",
            "Attachments": [
                {
                    "AttachTime": "2013-12-18T22:35:00.000Z",
                    "InstanceId": "i-1234567890abcdef0",
                    "VolumeId": "vol-049df61146c4d7901",
                    "State": "attached",
                    "DeleteOnTermination": true,
                    "Device": "/dev/sda1"
                }
            ],
            "Encrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-2a:123456789012:key/8c5b2c63-b9bc-45a3-a87a-5513eEXAMPLE,
            "VolumeType": "gp2",
            "VolumeId": "vol-049df61146c4d7901",
            "State": "in-use",
            "Iops": 100,
            "SnapshotId": "snap-1234567890abcdef0",
            "CreateTime": "2019-12-18T22:35:00.084Z",
            "Size": 8
        },
        {
            "AvailabilityZone": "us-east-1a",
            "Attachments": [],
            "Encrypted": false,
            "VolumeType": "gp2",
            "VolumeId": "vol-1234567890abcdef0",
            "State": "available",
            "Iops": 300,
            "SnapshotId": "",
            "CreateTime": "2020-02-27T00:02:41.791Z",
            "Size": 100
        }
    ]
}

示例 2：描述连接到特定实例的卷

以下 describe-volumes 示例描述了既连接到指定实例又设置为在实例终止时删除的所有卷。

aws ec2 describe-volumes \
    --region us-east-1 \
    --filters Name=attachment.instance-id,Values=i-1234567890abcdef0 Name=attachment.delete-on-termination,Values=true

有关 describe-volumes 的输出示例，请参阅示例 1。

示例 3：描述特定可用区中的可用卷

以下 describe-volumes 示例描述了状态为 available 且位于指定可用区中的所有卷。

aws ec2 describe-volumes \
    --filters Name=status,Values=available Name=availability-zone,Values=us-east-1a

有关 describe-volumes 的输出示例，请参阅示例 1。

示例 4：根据标签描述卷

以下 describe-volumes 示例描述了具有标签键 Name 和以 Test 开头的值的所有卷。然后，使用仅显示卷的标签和 ID 的查询筛选输出。

aws ec2 describe-volumes \
    --filters Name=tag:Name,Values=Test* \
    --query "Volumes[*].{ID:VolumeId,Tag:Tags}"

输出：

[
    {
       "Tag": [
           {
               "Value": "Test2",
               "Key": "Name"
           }
       ],
       "ID": "vol-1234567890abcdef0"
   },
   {
       "Tag": [
           {
               "Value": "Test1",
               "Key": "Name"
           }
       ],
       "ID": "vol-049df61146c4d7901"
    }
]

有关使用标签筛选器的更多示例，请参阅《Amazon EC2 用户指南》中的使用标签。

  • 有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 DescribeVolumes。

PowerShell
Tools for PowerShell V4

示例 1：此示例描述指定的 EBS 卷。

Get-EC2Volume -VolumeId vol-12345678

输出：

Attachments      : {}
AvailabilityZone : us-west-2c
CreateTime       : 7/17/2015 4:35:19 PM
Encrypted        : False
Iops             : 90
KmsKeyId         :
Size             : 30
SnapshotId       : snap-12345678
State            : in-use
Tags             : {}
VolumeId         : vol-12345678
VolumeType       : standard

示例 2：此示例描述状态为“可用”的 EBS 卷。

Get-EC2Volume -Filter @{ Name="status"; Values="available" }

输出：

Attachments      : {}
AvailabilityZone : us-west-2c
CreateTime       : 12/21/2015 2:31:29 PM
Encrypted        : False
Iops             : 60
KmsKeyId         :
Size             : 20
SnapshotId       : snap-12345678
State            : available
Tags             : {}
VolumeId         : vol-12345678
VolumeType       : gp2
...

示例 3：此示例描述所有 EBS 卷。

Get-EC2Volume

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V4)》中的 DescribeVolumes。

Tools for PowerShell V5

示例 1：此示例描述指定的 EBS 卷。

Get-EC2Volume -VolumeId vol-12345678

输出：

Attachments      : {}
AvailabilityZone : us-west-2c
CreateTime       : 7/17/2015 4:35:19 PM
Encrypted        : False
Iops             : 90
KmsKeyId         :
Size             : 30
SnapshotId       : snap-12345678
State            : in-use
Tags             : {}
VolumeId         : vol-12345678
VolumeType       : standard

示例 2：此示例描述状态为“可用”的 EBS 卷。

Get-EC2Volume -Filter @{ Name="status"; Values="available" }

输出：

Attachments      : {}
AvailabilityZone : us-west-2c
CreateTime       : 12/21/2015 2:31:29 PM
Encrypted        : False
Iops             : 60
KmsKeyId         :
Size             : 20
SnapshotId       : snap-12345678
State            : available
Tags             : {}
VolumeId         : vol-12345678
VolumeType       : gp2
...

示例 3：此示例描述所有 EBS 卷。

Get-EC2Volume

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V5)》中的 DescribeVolumes。