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 :
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.
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)"