Há mais AWS SDK exemplos disponíveis no GitHub repositório AWS Doc SDK Examples
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Use DescribeVolumes
com um CLI
Os exemplos de código a seguir mostram como usar o DescribeVolumes
.
- CLI
-
- AWS CLI
-
Exemplo 1: Para descrever um volume
O
describe-volumes
exemplo a seguir descreve os volumes especificados na região atual.aws ec2 describe-volumes \ --volume-ids
vol-049df61146c4d7901
vol-1234567890abcdef0
Saída:
{ "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 } ] }
Exemplo 2: Para descrever volumes que estão anexados a uma instância específica
O
describe-volumes
exemplo a seguir descreve todos os volumes anexados à instância especificada e definidos para serem excluídos quando a instância for encerrada.aws ec2 describe-volumes \ --region
us-east-1
\ --filtersName=attachment.instance-id,Values=i-1234567890abcdef0
Name=attachment.delete-on-termination,Values=true
Para obter um exemplo da saída de
describe-volumes
, consulte o Exemplo 1.Exemplo 3: Para descrever os volumes disponíveis em uma zona de disponibilidade específica
O
describe-volumes
exemplo a seguir descreve todos os volumes que têm um statusavailable
e estão na zona de disponibilidade especificada.aws ec2 describe-volumes \ --filters
Name=status,Values=available
Name=availability-zone,Values=us-east-1a
Para obter um exemplo da saída de
describe-volumes
, consulte o Exemplo 1.Exemplo 4: Para descrever volumes com base em tags
O
describe-volumes
exemplo a seguir descreve todos os volumes que têm a chave de tagName
e um valor que começa comTest
. A saída é então filtrada com uma consulta que exibe somente as tags e IDs os volumes.aws ec2 describe-volumes \ --filters
Name=tag:Name,Values=Test*
\ --query"Volumes[*].{ID:VolumeId,Tag:Tags}"
Saída:
[ { "Tag": [ { "Value": "Test2", "Key": "Name" } ], "ID": "vol-1234567890abcdef0" }, { "Tag": [ { "Value": "Test1", "Key": "Name" } ], "ID": "vol-049df61146c4d7901" } ]
Para obter mais exemplos de uso de filtros de tags, consulte Como trabalhar com tags no Guia EC2 do usuário da Amazon.
-
Para API obter detalhes, consulte DescribeVolumes
na Referência de AWS CLI Comandos.
-
- PowerShell
-
- Ferramentas para PowerShell
-
Exemplo 1: Este exemplo descreve o EBS volume especificado.
Get-EC2Volume -VolumeId vol-12345678
Saída:
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
Exemplo 2: Este exemplo descreve seus EBS volumes que têm o status 'disponível'.
Get-EC2Volume -Filter @{ Name="status"; Values="available" }
Saída:
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 ...
Exemplo 3: Este exemplo descreve todos os seus EBS volumes.
Get-EC2Volume
-
Para API obter detalhes, consulte DescribeVolumesem Referência de AWS Tools for PowerShell cmdlet.
-