Method: projects.locations.instances.list

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

בקשת HTTP


GET https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/instances

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

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

פרמטרים
parent

string

חובה. חשבון ההורה שממנו רוצים להציג את רשימת המכונות. הפורמט: projects/{project}/locations/{location}

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

פרמטרים
pageSize

integer

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

string

זה שינוי אופציונלי. אסימון שמזהה דף תוצאות שהשרת צריך להחזיר.
filter

string

זה שינוי אופציונלי. ביטוי לסינון התוצאות.
orderBy

string

זה שינוי אופציונלי. מיון התוצאות לפי סדר מוגדר. ערכים נתמכים: name,‏ createTime.

גוף הבקשה

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

גוף התשובה

הודעת תגובה ל-instances.list.

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

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

object (Instance)

אם המיקום המבוקש {location} הוא '-', התשובה מכילה רשימה של מופעים מכל המיקומים. מקרים שבהם המיקום לא נגיש לא ייכללו.
nextPageToken

string

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

string

מיקומים שלא ניתן להגיע אליהם.

היקפי הרשאות

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/memorystore.read-write
  • https://www.googleapis.com/auth/memorystore.read-only

הרשאות IAM

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

  • memorystore.instances.list

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