AWS CLI 使用 --query 选项提供内置输出筛选功能。为演示其工作方式,我们首先来看看下面的默认 JSON 输出,它描述了连接到不同 EC2 实例的两个 EBS (Elastic Block Storage) 卷。
$ aws ec2 describe-volumes { "Volumes": [ { "AvailabilityZone": "us-west-2a", "Attachments": [ { "AttachTime": "2013-09-17T00:55:03.000Z", "InstanceId": "i-a071c394", "VolumeId": "vol-e11a5288", "State": "attached", "DeleteOnTermination": true, "Device": "/dev/sda1" } ], "VolumeType": "standard", "VolumeId": "vol-e11a5288", "State": "in-use", "SnapshotId": "snap-f23ec1c8", "CreateTime": "2013-09-17T00:55:03.000Z", "Size": 30 }, { "AvailabilityZone": "us-west-2a", "Attachments": [ { "AttachTime": "2013-09-18T20:26:16.000Z", "InstanceId": "i-4b41a37c", "VolumeId": "vol-2e410a47", "State": "attached", "DeleteOnTermination": true, "Device": "/dev/sda1" } ], "VolumeType": "standard", "VolumeId": "vol-2e410a47", "State": "in-use", "SnapshotId": "snap-708e8348", "CreateTime": "2013-09-18T20:26:15.000Z", "Size": 8 } ] }
首先,我们可以使用以下命令仅显示 Volumes 列表中的第一个卷。
$ aws ec2 describe-volumes --query 'Volumes[0]' { "AvailabilityZone": "us-west-2a", "Attachments": [ { "AttachTime": "2013-09-17T00:55:03.000Z", "InstanceId": "i-a071c394", "VolumeId": "vol-e11a5288", "State": "attached", "DeleteOnTermination": true, "Device": "/dev/sda1" } ], "VolumeType": "standard", "VolumeId": "vol-e11a5288", "State": "in-use", "SnapshotId": "snap-f23ec1c8", "CreateTime": "2013-09-17T00:55:03.000Z", "Size": 30 }
现在,我们使用通配符表示法 [*] 循环访问整个列表,并筛选出三个元 素:VolumeId、AvailabilityZone 和 Size。请注意,词典表示法要求您为每个键提供一个别名,如: {Alias1:Key1,Alias2:Key2}。词典本身是无序的,因此,此种结构中的键别名的顺序在某些情况下可能不一 致。
$ aws ec2 describe-volumes --query 'Volumes[*].{ID:VolumeId,AZ:AvailabilityZone,Size:Size}' [ { "AZ": "us-west-2a", "ID": "vol-e11a5288", "Size": 30 }, { "AZ": "us-west-2a", "ID": "vol-2e410a47", "Size": 8 } ]
在使用词典表示法时,您也可以使用串联的键(如 key1.key2[0].key3)来筛选深度嵌套在结构中的元 素。下面的示例通过 Attachments[0].InstanceId 键(其别名为简单的 InstanceId)对此进行演 示。
$ aws ec2 describe-volumes --query 'Volumes[*]. {ID:VolumeId,InstanceId:Attachments[0].InstanceId,AZ:AvailabilityZone,Size:Size}' [ { "InstanceId": "i-a071c394", "AZ": "us-west-2a", "ID": "vol-e11a5288", "Size": 30 }, { "InstanceId": "i-4b41a37c", "AZ": "us-west-2a", "ID": "vol-2e410a47", "Size": 8 } ]
您也可以使用列表表示法筛选多个元素:[key1, key2]。这样做会对每个对象将筛选出的所有属性格式化 为一个排序 列表,而不管类型如何。
$ aws ec2 describe-volumes --query 'Volumes[*].[VolumeId, Attachments[0].InstanceId, AvailabilityZone, Size]' [ [ "vol-e11a5288", "i-a071c394", "us-west-2a", 30 ], [ "vol-2e410a47", "i-4b41a37c", "us-west-2a", 8 ] ]
要按特定字段的值筛选结果,请使用 JMESPath "?" 运算符。以下示例查询仅输出 us-west-2a 可用区中的 卷:
$ aws ec2 describe-volumes --query 'Volumes[?AvailabilityZone==`us-west-2a`]'
Note 在指定诸如以上 JMESPath 查询表达式中的“us-west-2”这样的文字值时,必须将该值放在反引号 (`) 中,以便使它能够正确读取。 在以下部分中将更详细地解释如何组合使用这三种输出格式。--query 选项是十分强大的工具,您可用 它来自定义输出的内容和样式。有关底层 JSON 处理库 JMESPath 的更多示例和完整规范,请访问 http:// jmespath.org/specification.html。