NAME
gdcloud topic formats - 资源格式的补充帮助。
说明
许多 gdcloud CLI 命令在成功后会返回资源列表。默认情况下，这些资源会整齐显示在标准输出中。--format=NAME[PROJECTIONS] 标志可用于设置输出格式，并将默认输出更改为更有意义的结果。
使用 --format 标志可更改命令的默认输出格式。资源格式将在后面详细介绍。
使用投影列出资源中的资源键的子集。
注意：如需引用字段列表，您可以按每个资源进行排序和格式设置。您可以运行 list 命令，并将格式设置为 yaml、json、csv、text 或 table。例如，
gdcloud clusters list --format=yaml
格式
格式表达式用于更改命令的默认输出格式。有许多输出格式可用；一些用于整齐显示人类可读的输出，另一些用于返回机器可读的输出。格式表达式包含两个部分：
NAME 名称
PROJECTIONS [ 资源键 [, …] ]
必须使用 NAME，并且 PROJECTIONS 可应用于 csv、text 和 table 格式。未知值会被忽略，且不会显示任何消息。每个 gdcloud list 命令都有一个默认格式表达式。--format 标志可以更改或替换默认表达式。例如，
--format="table(clusterref.name,controlPlane.name,controlPlane.image)" 会以表格格式列出控制平面资源。
--format=json 会以 JSON 格式列出资源。
可用的格式包括：
Comma Separated Values (<https //www.ietf.org/rfc/rfc4180.txt>) with no keys. Use this format with a projection to define values to print.
JSON (<https //www.json.org>), JavaScript Object Notation.
Aligned left-adjusted columns and column headings are the disambiguated right hand components of the column keys in uppercase. For example, the projection keys `(first.name, last.name)` produce the default column heading `('FIRST.NAME', 'LAST.NAME')`. If the screen reader option is `True`, you might observe flattened list output instead of a table with columns. To turn it off, run `gdcloud config set accessibility/screen_reader false`.
A flattened tree. Each output line contains one `key` `value` pair. Use this format with a projection to define values to print.
YAML (<https //www.yaml.org>), YAML ain't markup language.
示例
以 JSON 格式列出所有集群信息的状态
gdcloud clusters list --format=json
输出用户集群的集群引用详细信息
gdcloud clusters describe user-vm-1 --format="table(clusterref.name,clusterref.namespace)"