NOMBRE
Formatos de temas de gcloud: ayuda complementaria sobre formatos de recursos.
DESCRIPCIÓN
Muchos comandos de la CLI de gdcloud devuelven una lista de recursos si se ejecutan correctamente. De forma predeterminada, se muestran con formato en la salida estándar. La marca --format=NAME[PROJECTIONS] se puede usar para dar formato y cambiar el resultado predeterminado por uno 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, puede ordenar y dar formato a cada recurso. Puedes ejecutar un comando list con el formato definido como yaml, json, csv, text o table. Por ejemplo,
gdcloud clusters list --format=yaml
Formatos
Una expresión de formato se usa para cambiar el formato de salida predeterminado de un comando. Hay muchos formatos de salida disponibles, algunos para mostrar una salida legible por humanos y otros para devolver una salida legible por máquinas. Una expresión de formato tiene dos partes
NAME name
PROJECTIONS [ resource-key [, …] ]
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 modificar o sustituir el valor predeterminado. Por ejemplo,
--format="table(clusterref.name,controlPlane.name,controlPlane.image)" muestra los recursos del plano de control en formato de tabla.
--format=json muestra el recurso en formato JSON.
Los formatos disponibles son:
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.
EJEMPLOS
Muestra el estado de toda la información de los clústeres en formato JSON.
gdcloud clusters list --format=json
Imprimir los detalles de referencia del clúster de usuarios
gdcloud clusters describe user-vm-1 --format="table(clusterref.name,clusterref.namespace)"