NOME
gdcloud topic formats: ajuda complementar para formatos de recursos.
DESCRIÇÃO
Muitos comandos da CLI gdcloud retornam uma lista de recursos em caso de sucesso. Por padrão, eles são formatados na saída padrão. A flag --format=NAME[PROJECTIONS] pode ser usada para formatar e mudar a saída padrão para um resultado mais significativo.
Use a flag --format para mudar o formato de saída padrão de um comando. Os formatos de recursos são descritos em detalhes mais adiante.
Use projeções para listar um subconjunto de chaves de recursos em um recurso.
Observação: para consultar uma lista de campos, é possível classificar e formatar por recurso. Você 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 mudar o formato de saída padrão de um comando. Há muitos formatos de saída disponíveis, alguns para impressão de saída legível por humanos e outros para retorno de saída legível por máquina. Uma expressão de formato tem duas partes:
NAME name
PROJEÇÕES [ resource-key [, …] ]
NAME é obrigatório, e PROJECTIONS pode ser aplicado aos formatos csv, text e table. Valores desconhecidos são ignorados silenciosamente. Cada comando gdcloud list tem uma expressão de formato padrão. A flag --format pode alterar ou substituir o padrão. Por exemplo,
--format="table(clusterref.name,controlPlane.name,controlPlane.image)" lista os recursos do plano de controle em formato de tabela.
--format=json lista 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
Listar o status de todas as informações de cluster no formato JSON
gdcloud clusters list --format=json
Imprimir os detalhes de referência do cluster de usuário
gdcloud clusters describe user-vm-1 --format="table(clusterref.name,clusterref.namespace)"