高级过滤功能__用户指南_命令行工具 CLI-阿里云

注意：此功能适合有多个实例的用户使用。若您只有一个实例，请忽略此功能。

虽然阿里云开放 API 调用返回的数据能够以各种格式呈现出来，但依旧过于繁杂。所以阿里云命令行工具进一步做了过滤数据的功能，您可以使用 filter 功能从结果中直接过滤出想要的值，不论是使用还是二次开发都能够对结果进行处理，方便快捷。

从开放 API 调用过来的数据默认采用 json 格式，因此您在使用命令行工具时，可以根据 json 的特点，使用 filter 功能直接获取您想要的结果。

以 ECS DecribeRegions 为例，在命令行窗口执行如下命令，输出原始的 json 格式，如下图所示。

aliyuncli ecs DescribeRegions --output json

filter 1

过滤1

您可以直接输入一个 key 值进行过滤。请执行如下命令进行过滤。过滤结果如下图所示。

aliyuncli ecs DescribeRegions –output json –filter Regions

filter 2

过滤2

若 json 的值是一个 array，那么命令行工具支持数组下标格式。请执行如下命令进行过滤。过滤结果如下图所示。

aliyuncli ecs DescribeRegions –output json –filter Regions.Region[0]

filter 3

另外，命令行工具还支持‘*’的表达，表示所有结果的集合。Filter 的结果是多个时，会以 array 形式返回。请执行如下命令进行过滤。过滤结果如下图所示。

aliyuncli ecs DescribeRegions –output json –filter Regions.Region[*].RegionId

filter 4

过滤3

命令行工具还可以对显示结果精确到一个值进行过滤。请执行如下命令进行过滤。过滤结果如下图所示。

aliyuncli ecs DescribeRegions –output json –filter Regions.Region[3].RegionId

filter 5

最后更新：2016-11-23 16:04:06