gdcloud topic formats

שם

gdcloud topic formats - Supplementary help for resource formats.

תיאור

הרבה פקודות ב-CLI של gdcloud מחזירות רשימה של משאבים אם הן מבוצעות בהצלחה. כברירת מחדל, הם מודפסים בפלט הסטנדרטי בפורמט קריא. אפשר להשתמש בדגל --format=NAME[PROJECTIONS] כדי לעצב את פלט ברירת המחדל ולשנות אותו לתוצאה משמעותית יותר.

משתמשים בדגל --format כדי לשנות את פורמט הפלט שמוגדר כברירת מחדל של פקודה. בהמשך המאמר מפורטים פורמטים של משאבים.

משתמשים בתבניות נתונים כדי להציג רשימה של קבוצת משנה של מפתחות משאבים במשאב.

הערה: כדי לעיין ברשימת השדות, אפשר למיין ולעצב לפי כל משאב. אפשר להריץ פקודת list עם פורמט שמוגדר ל-yaml,‏ json,‏ csv,‏ text או table. לדוגמה,

gdcloud clusters list --format=yaml

פורמטים

ביטוי פורמט משמש לשינוי פורמט הפלט שמוגדר כברירת מחדל של פקודה. יש הרבה פורמטים של פלט. חלקם מיועדים להדפסה יפה של פלט שקריא לאנשים, וחלקם מיועדים להחזרת פלט שקריא למחשבים. ביטוי פורמט מורכב משני חלקים

NAME name

PROJECTIONS [ resource-key [, …] ]

השדה NAME הוא שדה חובה, ואפשר להחיל את השדה PROJECTIONS על פורמטים של csv, ‏ text ו-table. המערכת מתעלמת מערכים לא ידועים בלי להציג הודעה. לכל פקודה gdcloud list יש ביטוי פורמט שמוגדר כברירת מחדל. הדגל --format יכול לשנות את ברירת המחדל או להחליף אותה. לדוגמה,

--format="table(clusterref.name,controlPlane.name,controlPlane.image)" מציג את משאבי מישור הבקרה בפורמט טבלה.

‫--format=json מציג את המשאב בפורמט JSON.

הפורמטים הזמינים הם

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

דוגמאות

רשימת הסטטוס של כל פרטי האשכולות בפורמט JSON 

gdcloud clusters list --format=json

הדפסת פרטי ההפניה של אשכול המשתמש 

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