Method: projects.locations.list

• בקשת HTTP
• פרמטרים של הנתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התגובה
• היקפי הרשאות
• כדאי לנסות!

רשימת המיקומים שנתמכים בשירות הזה.

השיטה הזו מציגה מיקומים על סמך היקף המשאבים שצוין בשדה [ListLocationsRequest.name]:

• מיקומים גלובליים: אם name ריק, השיטה מציגה את המיקומים הציבוריים שזמינים לכל הפרויקטים.
• מיקומים ספציפיים לפרויקט: אם name הוא בפורמט projects/{project}, השיטה מציגה את המיקומים שגלויים לפרויקט הספציפי הזה. המיקומים האלה כוללים מיקומים ציבוריים, פרטיים או מיקומים אחרים שספציפיים לפרויקט ומופעלים בשבילו.

בהטמעות של gRPC וספריית לקוח, שם המשאב מועבר בתור השדה name. בקריאות ישירות לשירות, שם המשאב משולב בנתיב הבקשה על סמך ההטמעה והגרסה הספציפיות של השירות.

בקשת HTTP

GET https://networkservices.googleapis.com/v1alpha1/{name=projects/*}/locations

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

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

פרמטרים
name	string המשאב שבבעלותו אוסף המיקומים, אם רלוונטי.

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

פרמטרים
filter	string מסנן לצמצום התוצאות לקבוצת משנה מועדפת. שפת הסינון מקבלת מחרוזות כמו "displayName=tokyo", והיא מתועדת בפירוט רב יותר ב-AIP-160.
pageSize	integer המספר המקסימלי של תוצאות שיוחזרו. אם לא מגדירים את המדיניות, השירות בוחר ברירת מחדל.
pageToken	string טוקן של דף שהתקבל מהשדה nextPageToken בתגובה. שולחים את הטוקן של הדף כדי לקבל את הדף הבא.
extraLocationTypes[]	string זה שינוי אופציונלי. אל תשתמשו בשדה הזה. הוא לא נתמך והמערכת מתעלמת ממנו, אלא אם צוין אחרת במפורש. הוא מיועד בעיקר לשימוש פנימי.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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