View a markdown version of this page

CLI로 DescribeVolumes 사용 - AWS SDK 코드 예제

Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. AWS

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CLI로 DescribeVolumes 사용

다음 코드 예시는 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: 이 예제에서는 상태가 'available'인 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 참조(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: 이 예제에서는 상태가 'available'인 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 참조(V5)의 DescribeVolumes을 참조하세요.