Method: projects.locations.buckets.list

הצגת רשימה של הקטגוריות בפרויקט במיקום מסוים.

בקשת HTTP

GET https://observability.googleapis.com/v1/{parent=projects/*/locations/*}/buckets

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

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

פרמטרים
parent

string

חובה. המאגר הראשי, שהוא הבעלים של האוסף הזה של מאגרי מידע. הפורמט הוא:

projects/[PROJECT_ID]/locations/[LOCATION]

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

פרמטרים
pageSize

integer

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

string

זה שינוי אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של buckets.list. צריך להזין את הטוקן כדי לאחזר את הדף הבא.
showDeleted

boolean

זה שינוי אופציונלי. אם הערך הוא true, התשובה תכלול דליים שנמחקו.

גוף הבקשה

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

גוף התשובה

תשובה לבקשה לרשימת קטגוריות.

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

ייצוג ב-JSON 
{
  "buckets": [
    {
      object (Bucket)
    }
  ],
  "nextPageToken": string
}
שדות
buckets[]

object (Bucket)

זה שינוי אופציונלי. רשימת הקטגוריות.
nextPageToken

string

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

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

הרשאות IAM

נדרשת הרשאת IAM הבאה במשאב parent:

  • observability.buckets.list

מידע נוסף מופיע במאמרי העזרה בנושא IAM.