רשימת המיקומים שנתמכים בשירות הזה.
השיטה הזו מציגה את המיקומים לפי היקף המשאבים שצוין בשדה ListLocationsRequest.name:
- מיקומים גלובליים: אם
nameריק, השיטה מציגה את המיקומים הציבוריים שזמינים לכל הפרויקטים. - מיקומים ספציפיים לפרויקט: אם
nameהוא בפורמטprojects/{project}, השיטה מציגה את המיקומים שגלויים לפרויקט הספציפי הזה. המיקומים האלה כוללים מיקומים ציבוריים, פרטיים או מיקומים אחרים שספציפיים לפרויקט ומופעלים בשבילו.
בהטמעות של gRPC וספריית לקוח, שם המשאב מועבר בתור השדה name. בקריאות ישירות לשירות, שם המשאב משולב בנתיב הבקשה על סמך ההטמעה והגרסה הספציפיות של השירות.
בקשת HTTP
GET https://universalledger.googleapis.com/v1/{name=projects/*}/locations כתובות ה-URL כתובות בתחביר של gRPC Transcoding.
פרמטרים של הנתיב
| פרמטרים | |
|---|---|
name |
המשאב שבבעלותו אוסף המיקומים, אם רלוונטי. |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
filter |
מסנן לצמצום התוצאות לקבוצת משנה מועדפת. שפת הסינון מקבלת מחרוזות כמו |
pageSize |
המספר המקסימלי של תוצאות שיוחזרו. אם לא מגדירים את המדיניות, השירות בוחר ברירת מחדל. |
pageToken |
טוקן של דף שהתקבל מהשדה |
extraLocationTypes[] |
זה שינוי אופציונלי. אל תשתמשו בשדה הזה, אלא אם צוין אחרת במפורש. הוא מיועד בעיקר לשימוש פנימי. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
הודעת התשובה של Locations.ListLocations.
אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{
"locations": [
{
object ( |
| שדות | |
|---|---|
locations[] |
רשימה של מיקומים שתואמים למסנן שצוין בבקשה. |
nextPageToken |
האסימון הרגיל של הדף הבא ברשימה. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
ניתן למצוא מידע נוסף כאן: Authentication Overview.
הרשאות IAM
נדרשת הרשאת IAM הבאה במשאב name:
universalledger.locations.list
מידע נוסף זמין במאמרי העזרה בנושא IAM.