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 apresentados com formatação avançada na saída padrão. A flag --format=NAME[PROJECTIONS] pode ser usada para formatar e alterar o resultado predefinido 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áquinas. 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)"