Formatos de temas de gdcloud

NOMBRE

gdcloud topic formats: Ayuda complementaria para los formatos de recursos.

DESCRIPCIÓN

Muchos comandos de la CLI de gdcloud muestran una lista de recursos cuando se ejecutan correctamente. De forma predeterminada, se imprimen con formato en el resultado estándar. La marca --format=NAME[PROJECTIONS] se puede usar para dar formato y cambiar el resultado predeterminado a un resultado más significativo.

Usa la marca --format para cambiar el formato de salida predeterminado de un comando. Los formatos de recursos se describen en detalle más adelante.

Usa proyecciones para enumerar un subconjunto de claves de recursos en un recurso.

Nota: Para consultar una lista de campos, puedes ordenarlos y darles formato según cada recurso. Puedes ejecutar un comando list con el formato establecido en yaml, json, csv, text o table. Por ejemplo:

gdcloud clusters list --format=yaml

Formatos

Se usa una expresión de formato para cambiar el formato de salida predeterminado de un comando. Hay muchos formatos de salida disponibles, algunos para imprimir resultados legibles por humanos y otros para devolver resultados legibles por máquinas. Una expresión de formato tiene dos partes:

NAME name

PROJECTIONS [ clave-de-recurso [, …] ]

NAME es obligatorio y PROJECTIONS se puede aplicar a los formatos csv, text y table. Los valores desconocidos se ignoran de forma silenciosa. Cada comando gdcloud list tiene una expresión de formato predeterminada. La marca --format puede alterar o reemplazar el valor predeterminado. Por ejemplo:

--format="table(clusterref.name,controlPlane.name,controlPlane.image)" enumera los recursos del plano de control en formato de tabla.

--format=json muestra el recurso en formato JSON.

Los formatos disponibles son los siguientes:

## csv

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

JSON (<https //www.json.org>), JavaScript Object Notation.

## table

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`.

## text

A flattened tree. Each output line contains one `key` `value` pair. Use this format with a projection to define values to print.

## yaml

YAML (<https //www.yaml.org>), YAML ain't markup language.

EXAMPLES

Enumera el estado de la información de todos los clústeres en formato JSON

gdcloud clusters list --format=json

Imprime los detalles de referencia del clúster de usuario

gdcloud clusters describe user-vm-1 --format="table(clusterref.name,clusterref.namespace)"