NAME
gdcloud-Themenformate – Zusätzliche Hilfe zu Ressourcenformaten.
BESCHREIBUNG
Viele gdcloud-CLI-Befehle geben bei Erfolg eine Liste von Ressourcen zurück. Standardmäßig werden sie in der Standardausgabe formatiert. Mit dem Flag --format=NAME[PROJECTIONS] kann die Standardausgabe formatiert und in ein aussagekräftigeres Ergebnis geändert werden.
Mit dem Flag --format können Sie das Standardausgabeformat eines Befehls ändern. Ressourcenformate werden später ausführlich beschrieben.
Mit Projektionen können Sie eine Teilmenge von Ressourcenschlüsseln in einer Ressource auflisten.
Hinweis: Eine Liste von Feldern kann nach jeder Ressource sortiert und formatiert werden. Sie können einen list-Befehl ausführen, wobei das Format auf yaml, json, csv, text oder table festgelegt ist. Beispiel:
gdcloud clusters list --format=yaml
Formate
Mit einem Formatausdruck wird das Standardausgabeformat eines Befehls geändert. Es sind viele Ausgabeformate verfügbar, einige für die formatierte Ausgabe für Menschen und andere für die Rückgabe von maschinenlesbarer Ausgabe. Ein Formatausdruck besteht aus zwei Teilen:
NAME name
PROJECTIONS [ resource-key [, …] ]
NAME ist erforderlich und PROJECTIONS kann auf die Formate csv, text und table angewendet werden. Unbekannte Werte werden stillschweigend ignoriert. Jeder gdcloud list-Befehl hat einen Standardformatausdruck. Das Flag --format kann die Standardeinstellung ändern oder ersetzen. Beispiel:
--format="table(clusterref.name,controlPlane.name,controlPlane.image)" listet Ressourcen der Steuerungsebene im Tabellenformat auf.
--format=json listet die Ressource im JSON-Format auf.
Die verfügbaren Formate sind:
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.
BEISPIELE
Status aller Clusterinformationen im JSON-Format auflisten
gdcloud clusters list --format=json
Clusterreferenzdetails des Nutzerclusters ausgeben
gdcloud clusters describe user-vm-1 --format="table(clusterref.name,clusterref.namespace)"