Formats des thèmes gdcloud

NOM

gdcloud topic formats : aide supplémentaire sur les formats de ressources.

DESCRIPTION

De nombreuses commandes de la CLI gdcloud renvoient une liste de ressources en cas de réussite. Par défaut, ils sont mis en forme et affichés dans la sortie standard. L'option --format=NAME[PROJECTIONS] permet de mettre en forme la sortie par défaut et de la remplacer par un résultat plus pertinent.

Utilisez l'option --format pour modifier le format de sortie par défaut d'une commande. Les formats de ressources sont décrits en détail plus loin.

Utilisez des projections pour lister un sous-ensemble de clés de ressources dans une ressource.

Remarque : Pour faire référence à une liste de champs, vous pouvez les trier et les mettre en forme par ressource. Vous pouvez exécuter une commande list avec le format défini sur yaml, json, csv, text ou table. Par exemple,

gdcloud clusters list --format=yaml

Formats

Une expression de format permet de modifier le format de sortie par défaut d'une commande. De nombreux formats de sortie sont disponibles : certains pour une sortie lisible par l'humain et d'autres pour une sortie lisible par une machine. Une expression de format comporte deux parties.

NAME name

PROJECTIONS [ resource-key [, …] ]

NAME est obligatoire, et PROJECTIONS peut être appliqué aux formats csv, text et table. Les valeurs inconnues sont ignorées silencieusement. Chaque commande gdcloud list possède une expression de format par défaut. L'option --format peut modifier ou remplacer la valeur par défaut. Par exemple,

--format="table(clusterref.name,controlPlane.name,controlPlane.image)" liste les ressources du plan de contrôle au format tableau.

--format=json liste la ressource au format JSON.

Les formats disponibles sont les suivants :

## 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

Lister l'état de toutes les informations sur les clusters au format JSON

gdcloud clusters list --format=json

Imprimer les informations de référence du cluster d'utilisateur

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