מדריך למתחילים: הפעלת Cloud Location Finder והרצת שאילתה

מדריך למתחילים: הפעלת Cloud Location Finder והרצת שאילתה

בדף הזה מוסבר איך להפעיל את Cloud Location Finder באמצעות Google Cloud CLI, ואיך למצוא מיקומי ענן לפי קרבה, תחום שיפוט וטביעת רגל פחמנית. אפשר למצוא מיקומים באמצעות בקשות HTTP או פקודות Google Cloud CLI.

לפני שמתחילים

1. התקינו את ה-CLI של Google Cloud.
2. כדי לאתחל את ה-CLI של Google Cloud, מריצים את הפקודה הבאה:

   gcloud init
   

אם כבר התקנתם את Google Cloud CLI בעבר, צריך לוודא שפועלת אצלכם הגרסה העדכנית ביותר של gcloud components update.

3. מפעילים את Cloud Location Finder API:

   gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
   

4. הוספת התפקיד cloudlocationfinder.viewer:

   gcloud projects add-iam-policy-binding PROJECT \
       --member USER_IDENTIFIER \
       --role roles/cloudlocationfinder.viewer
   

   • מחליפים את PROJECT במזהה הפרויקט.
   • מחליפים את USER_IDENTIFIER במזהה של חשבון המשתמש. לדוגמה, user:[e-mail].
5. אם אתם מתכננים למצוא מיקומים של Google Distributed Cloud במודל מחובר באמצעות Cloud Location Finder, הפעילו את GDC Hardware Management API והוסיפו את התפקיד gdchardwaremanagement.reader:

   gcloud projects add-iam-policy-binding PROJECT \
       --member USER_IDENTIFIER \
       --role roles/gdchardwaremanagement.reader
   

דוגמאות לשאילתות נפוצות ב-Cloud Location Finder

בעזרת Cloud Location Finder אפשר לשלוח שאילתות למאגר המיקומים בענן כדי לזהות מיקומים בענן שנמצאים בקרבת מקום על סמך קרבה, קוד אזור או צריכת אנרגיה ללא פליטת פחמן (CFE%) של Google. בקטעים הבאים מופיעות דוגמאות נפוצות לאינטראקציה עם מאגר Cloud Location Finder.

‫Cloud Location Finder משתמש בתחביר של gRPC Transcoding.

• מחליפים את PROJECT במזהה הפרויקט.
• מחליפים את CLOUD_REGION באזור הענן של המקור כדי למצוא את המיקום הקרוב ביותר, כולל הקידומת של ספק שירותי הענן. לדוגמה, gcp-us-central1 או aws-us-east-1.
• מחליפים את CLOUD_PROVIDER בספק הענן כדי למצוא את המיקום הקרוב ביותר. לדוגמה, AWS או GCP.

מציאת אזור הענן הקרוב ביותר

אפשר להשתמש בשאילתה הזו כדי לזהות את התחום (zone) הקרוב ביותר למיקום בענן באמצעות נתוני קירבה של ספק שירותי ענן שאתם מציינים. Google Cloud

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/projects/PROJECT/locations/global/cloudLocations:search?source_cloud_location=projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION&query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_ZONE&page_size=1"

gcloud

gcloud cloudlocationfinder cloud-locations search \
    --source-cloud-location=CLOUD_REGION \
    --query="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_ZONE" \
    --limit=1

חיפוש כל האזורים המחוברים של Google Distributed Cloud באזור מסוים

אפשר להשתמש בשאילתה הזו כדי להציג רשימה של אזורים מחוברים של Distributed Cloud באזור ספציפי.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT 'https://cloudlocationfinder.googleapis.com/v1/projects/PROJECT/locations/global/cloudLocations?filter=containing_cloud_location="projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION%20AND%20cloud_provider=CLOUD_PROVIDER_GCP%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_GDCC_ZONE"'

gcloud

gcloud cloudlocationfinder cloud-locations list --filter='cloud_provider=CLOUD_PROVIDER_GCP AND cloud_location_type=CLOUD_LOCATION_TYPE_GDCC_ZONE AND containing_cloud_location="projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION"'

חיפוש אזורים בתוך טריטוריה ספציפית

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

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/projects/PROJECT/locations/global/cloudLocations:search?source_cloud_location=projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION&query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_REGION%20AND%20territory_code=TERRITORY_CODE&page_size=1"

gcloud

gcloud cloudlocationfinder cloud-locations search \
    --source-cloud-location=CLOUD_REGION \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" AND filter="territory_code=\"TERRITORY_CODE\"" \
    --limit=1

רשימת מיקומי ענן שממזערים את טביעת הרגל הפחמנית

אפשר להשתמש בשאילתה הזו כדי לזהות אזורים עם טביעת הרגל הפחמנית הכי נמוכה על סמך אנרגיה נטולת פחמן עבור אזורים Google Cloud .

הערה: נתוני CFE זמינים רק עבור Google Cloud מיקומים.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/projects/PROJECT/locations/global/cloudLocations?query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_REGION&page_size=5"

gcloud

gcloud cloudlocationfinder cloud-locations list \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" \
    --limit=5

המאמרים הבאים

• בדיקת מיקומים נתמכים
• מידע נוסף על התחביר של שאילתות חיפוש מיקום
• הפניית API