Method: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces.list

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

בקשת HTTP


GET https://biglake.googleapis.com/iceberg/v1/restcatalog/v1/{apiParent=projects/*/catalogs/*}/namespaces

כתובות ה-URL כתובות בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
apiParent

string

חובה. ההורה מנתיב המשאב.

פרמטרים של שאילתה

פרמטרים
pageToken

string

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

pageSize

integer

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

parent

string

זה שינוי אופציונלי. מרחב שמות אופציונלי, שמתחתיו יוצגו מרחבי שמות. אם לא מציינים ערך או מציינים ערך ריק, צריך לציין את כל מרחבי השמות ברמה העליונה. אם מרחב השמות של ההורה הוא מרחב שמות מרובה חלקים, צריך להפריד בין החלקים באמצעות בייט של מפריד יחידות (0x1F). לא הורה אמיתי, לכן הערך הוא ST_NOT_REQUIRED.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת התגובה ל-API‏ namespaces.list.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "namespaces": [
    array
  ],
  "next-page-token": string,
  "unreachable": [
    string
  ]
}
שדות
namespaces[]

array (ListValue format)

רשימת מרחבי השמות.

next-page-token

string

הטוקן של הדף הבא להחלפה בין דפים.

unreachable[]

string

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

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/bigquery
  • https://www.googleapis.com/auth/cloud-platform

ניתן למצוא מידע נוסף כאן: Authentication Overview.