NOME
Formatos de tópicos do gdcloud: ajuda suplementar para formatos de recursos.
DESCRIÇÃO
Muitos comandos da gdcloud CLI devolvem uma lista de recursos em caso de êxito. Por predefinição, são formatados no resultado padrão. A flag --format=NAME[PROJECTIONS] pode ser usada para formatar e alterar a saída predefinida para um resultado mais significativo.
Use a flag --format para alterar o formato de saída predefinido de um comando. Os formatos de recursos são descritos detalhadamente mais tarde.
Use projeções para listar um subconjunto de chaves de recursos num recurso.
Nota: para consultar uma lista de campos, pode ordenar e formatar por cada recurso. Pode executar um comando list com o formato definido como yaml, json, csv, text ou table. Por exemplo,
gdcloud clusters list --format=yaml
Formatos
Uma expressão de formato é usada para alterar o formato de saída predefinido de um comando. Estão disponíveis muitos formatos de saída; alguns para uma saída legível por humanos e outros para devolver uma saída legível por máquina. Uma expressão de formato tem duas partes
NAME name
PROJECTIONS [ resource-key [, …] ]
O elemento NAME é obrigatório e o elemento PROJECTIONS pode ser aplicado aos formatos csv, text e table. Os valores desconhecidos são ignorados silenciosamente. Cada comando gdcloud list tem uma expressão de formato predefinida. A flag --format pode alterar ou substituir a predefinição. Por exemplo,
--format="table(clusterref.name,controlPlane.name,controlPlane.image)" lista os recursos do plano de controlo no formato de tabela.
--format=json apresenta o recurso no formato JSON.
Os formatos disponíveis são
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.
EXEMPLOS
Apresentar o estado de todas as informações dos clusters no formato JSON
gdcloud clusters list --format=json
Imprima os detalhes de referência do cluster do utilizador
gdcloud clusters describe user-vm-1 --format="table(clusterref.name,clusterref.namespace)"