Azure Sphere CLI 支持的输出格式

项目
08/09/2023

Azure Sphere CLI 支持多种可查看数据的格式。默认情况下，它使用 table 作为显示 CLI 输出的默认格式，但也支持其他格式。

注意

为命令显示的输出可能因不同的输出类型而异。

参数值和输出类型为：

输出格式	描述
`table`	ASCII 表，其中键作为列标题。这是默认格式。
`json`	JSON 字符串。
`jsonc`	着色的 JSON。
`yaml`	YAML，JSON 的一种计算机可读替代方法。
`yamlc`	着色 YAML。
`tsv`	不带键的制表符分隔值。
`none`	除了错误和警告之外，没有其他输出。

支持的命令

可以使用、 --out或 -o指定命令--output所需的输出格式。如果缺少需要编写脚本的命令，请通过 azsphere 反馈告知我们。以下命令支持它：

表输出格式

格式 table 是将输出打印为 ASCII 表的默认格式，便于阅读和扫描。如果想要快速、可搜索的数据概述，则此格式是最佳选择。它可用于获取重点信息的摘要，尤其是列表命令。

azsphere tenant list --output table
 ------------------------------------ --------------------- -------------
 Id                                   Name                  Roles
 ========================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant               Contributor
 ------------------------------------ --------------------- -------------
 768c2cd6-059a-49ad-9f53-89f5271cea15 MyTenant1              Administrator
                                                             Contributor
 ------------------------------------ --------------------- -------------

可以使用 --query 参数自定义要在输出中显示的属性和列。以下示例演示如何在列表命令中仅选择 TenantID 和 Role。

azsphere tenant list --query '[].{TenantID:id, Role:roles}'
 ------------------------------------ -------------
 TenantID                             Role
 ==================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb Contributor
 ------------------------------------ -------------
 183adhc9-a5c8-8he2-84a2-c4f00f73a471 Administrator
                                      Contributor
 ------------------------------------ -------------

注意

以 JSON 格式运行命令，查看要在查询中使用的可用属性名称。例如，运行 azsphere tenant list --output json 命令时，输出将显示可用于该命令的名称和值。
默认情况下，嵌套对象、某些键和字段不会在表输出中打印。如果需要在输出中查看这些内容，可以使用 JMESPath 重新键入功能来更改密钥名称并避免筛选。有关使用查询筛选数据的详细信息，请参阅查询 CLI 命令输出。

JSON 输出格式

JSON 输出格式以结构化格式包括所有原始数据和嵌套数据。建议使用 JSON 输出进行简洁的输出和编写脚本。仅当命令成功并返回 0 时，这才适用。

以下示例以默认 JSON 格式显示租户列表。

azsphere tenant list --output json
[
  {
    "id": "143adbc9-1bf0-4be2-84a2-084a331d81cb",
    "name": "MyTenant",
    "roles": [
      "Contributor"
    ]
  },
  {
    "id": "768c2cd6-059a-49ad-9f53-89f5271cea15",
    "name": "MyTenant1",
    "roles": [
      "Administrator",
      "Contributor"
    ]
  }
]

YAML 输出格式

格式 yaml 将输出打印为 YAML，这是一种纯文本数据序列化格式。 YAML 往往比 JSON 更易于读取。

azsphere tenant list --output yaml
- id: 143adbc9-1bf0-4be2-84a2-084a331d81cb
  name: MyTenant
  roles:
  - Contributor
- id: 768c2cd6-059a-49ad-9f53-89f5271cea15
  name: MyTenant1
  roles:
  - Administrator
  - Contributor

TSV 输出格式

输出 tsv 格式返回制表符分隔值和新行分隔值，无需其他格式、键或其他符号。输出 tsv 类似于输出， table 但在以下方面有所不同：

输出中 tsv 不显示列标题。
输出 table 显示列表并 tsv 显示列表的长度。
嵌套对象不会在输出中 tsv 打印。
输出 tsv 以制表符分隔，无法缩放以适应终端。

azsphere tenant list --output tsv
143adbc9-1bf0-4be2-84a2-084a331d81cb    MyTenant    1
768c2cd6-059a-49ad-9f53-89f5271cea15    MyTenant1    2

通过