הצגת רשימה של שירותים
במאמר הזה מוסבר איך לראות את רשימת ממשקי ה-API והשירותים שמופעלים או זמינים בפרויקט ב- Google Cloud . רשימת ממשקי ה-API והשירותים הזמינים או המופעלים יכולה לכלול גם שירותים ציבוריים שלGoogle Cloud , כמו Pub/Sub, וגם ממשקי API ושירותים ששותפו איתכם באופן פרטי, כמו שירותים שנוצרו באמצעות Cloud Endpoints. מידע נוסף על ההבדלים בין ממשקי API ושירותים ציבוריים לפרטיים זמין במאמר שירותים ציבוריים ופרטיים.
- כדי לקבל או לעקוב אחרי השירותים המופעלים בארגון, אפשר לעיין במאמר רשימת השירותים המופעלים בארגון.
- כדי להציג רשימה של שירותים בפרויקט, מומלץ להשתמש במסוףGoogle Cloud או ב-Google Cloud CLI. במסמך הזה מוסבר איך להשתמש בשני הממשקים.
- כדי לכתוב קוד שמשתמש ב-Service Usage API, צריך להשתמש באחת מספריות הלקוח שלנו.
- כדי להתנסות ב-API, מומלץ להשתמש בפקודה
curl. לא צריך להגדיר סביבת אפליקציה מלאה, אבל יש כמה הגדרות שצריך לבצע.
לפני שמתחילים
כדי לראות את רשימת ממשקי ה-API והשירותים שזמינים ומופעלים, צריך:
- פרויקט Google Cloud . Google Cloud כאן מוסבר איך ליצור פרויקט.
- ההרשאות הנכונות בניהול זהויות והרשאות גישה. במאמר בקרת גישה מוסבר על דרישות IAM לשימוש בשירות.
- כדי להתקין את Google Cloud CLI.
- כדי להשתמש בדוגמאות של
curlבמדריך הזה, צריך לבצע את ההוראות להשלמת ההגדרה הראשונית במאמר תחילת העבודה. השלבים האלה כוללים הגדרה שלgcurl, שהוא כינוי מאומת לפקודה הרגילהcurl, והגדרה של משתנה הסביבהPROJECT_NUMBER.
הצגת רשימה של שירותים מופעלים בארגון
כדי לראות אילו שירותים מופעלים בארגון, אפשר להשתמש בCloud Asset Inventory, שמאפשר לייצא את המצב של כל הפרויקטים שנמצאים בשליטת הארגון בקריאת RPC אחת. אפשר גם להשתמש במאגר משאבי הענן כדי לעקוב אחרי שינויים במצב. כדי לייצא את כל השירותים המופעלים בארגון מסוים, פועלים לפי ההוראות במאמר Listing Assets (רישום נכסים) במסמכי Cloud Asset Inventory.
כדי להציג את רשימת ממשקי ה-API המופעלים בארגון, מריצים את הפקודה הבאה אחרי שמגדירים את מזהה הארגון ואת מזהה פרויקט החיוב:
NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ") gcloud asset list \ --organization='ORGANIZATION_ID' \ --billing-project='BILLING_PROJECT_ID' \ --asset-types='serviceusage.googleapis.com/Service' \ --snapshot-time=$NOW \ --content-type='resource'
הרצת הפקודה הקודמת מאפשרת למשתמש עם הרשאות מתאימות להציג את רשימת השירותים המופעלים בכל הפרויקטים בארגון.
כדי להתנסות בפקודות של Cloud Asset Inventory, מריצים את הפקודות האלה בפרויקט ספציפי. לדוגמה, הפקודה הבאה מפרטת את כל השירותים שמופעלים בפרויקט מסוים:
NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ") gcloud asset list \ --project='PROJECT_ID' \ --billing-project='BILLING_PROJECT_ID' \ --asset-types='serviceusage.googleapis.com/Service' \ --snapshot-time=$NOW \ --content-type='resource'
הצגת רשימה של שירותים מופעלים בפרויקט
הצגת רשימת השירותים המופעלים משתמשת במכסה מהמדד serviceusage.googleapis.com/list_enabled_requests. מכסת ברירת המחדל היא 10 שאילתות לשנייה (QPS).
console
כדי לראות את רשימת ממשקי ה-API והשירותים שמופעלים בפרויקט:
- נכנסים לדף API Dashboard במסוף Google Cloud .
כניסה לדף API Dashboard בוחרים את Google Cloud הפרויקט באחת מהדרכים הבאות:
לוחצים על Google Cloud פרויקט בקטע Select a recent project.
כדי להשתמש בדפדפן הפרויקטים, מבצעים את השלבים הבאים: Google Cloud
- לוחצים על Select project כדי לפתוח את Google Cloud דפדפן הפרויקטים.
- מאתרים את הפרויקט ולוחצים על Google Cloud שם הפרויקט.
- לוחצים על פתיחה כדי לפתוח את הפרויקט.
מופיע הדף APIs & Services. בטבלה שבדף הזה מופיעה רשימה של ממשקי ה-API שמופעלים בפרויקט Google Cloud .
gcloud
כדי לראות את רשימת ממשקי ה-API והשירותים המופעלים בפרויקט הנוכחי, מריצים את הפקודה הבאה:
gcloud services list
הפלט של הפקודה אמור להיראות כך:
NAME TITLE pubsub.googleapis.com Google Cloud Pub/Sub API bigquery.googleapis.com BigQuery API cloudtrace.googleapis.com Stackdriver Trace API servicemanagement.googleapis.com Google Service Management API monitoring.googleapis.com Stackdriver Monitoring API storage-api.googleapis.com Google Cloud Storage JSON API logging.googleapis.com Stackdriver Logging API clouddebugger.googleapis.com Stackdriver Debugger API ...
curl
כדי להציג רשימה של שירותים מופעלים, קוראים לשיטה services.list עם המסנן state:ENABLED.
כדי לראות את רשימת ממשקי ה-API והשירותים המופעלים בפרויקט, מריצים את הפקודה הבאה:
gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"
הצגת רשימה של השירותים שזמינים בפרויקט
הצגת רשימה של כל השירותים הזמינים צורכת מכסה ממכסת serviceusage.googleapis.com/list_available_requests. מכסת ברירת המחדל היא 1 QPS. מערך השירותים הזמינים משתנה לעיתים רחוקות, ואפשר לשמור אותו במטמון לתקופות ארוכות.
console
כדי לראות את רשימת ממשקי ה-API והשירותים שזמינים לכם בפרויקט:
- עוברים לדף API Library במסוף Google Cloud .
כניסה לדף API Library בוחרים את Google Cloud הפרויקט באחת מהדרכים הבאות:
לוחצים על Google Cloud פרויקט בקטע Select a recent project.
כדי להשתמש בדפדפן הפרויקטים, מבצעים את השלבים הבאים: Google Cloud
- לוחצים על Select project כדי לפתוח את Google Cloud דפדפן הפרויקטים.
- מאתרים את הפרויקט ולוחצים על Google Cloud שם הפרויקט.
- לוחצים על פתיחה כדי לפתוח את הפרויקט.
מופיע המסך API Library (ספריית ממשקי ה-API). במסך הזה אפשר לחפש ממשקי API זמינים או לגלול ביניהם.
gcloud
כדי לראות את רשימת ממשקי ה-API והשירותים שזמינים לכם בפרויקט הנוכחי, מריצים את הפקודה הבאה:
gcloud services list --available
התוצאות כוללות את כל השירותים שכבר הופעלו, וגם שירותים שאפשר להפעיל בפרויקט הנוכחי. הפלט של הפקודה אמור להיראות כך:
NAME TITLE places-backend.googleapis.com Google Places API Web Service clouderrorreporting.googleapis.com Stackdriver Error Reporting API analyticsreporting.googleapis.com Google Analytics Reporting API youtube.googleapis.com YouTube Data API v3 adsense.googleapis.com AdSense Management API sqladmin.googleapis.com Google Cloud SQL API genomics.googleapis.com Genomics API adexchangebuyer.googleapis.com Ad Exchange Buyer API II ...
curl
כדי לראות את רשימת השירותים הזמינים, מבצעים קריאה ל-method services.list.
כדי לראות את רשימת ממשקי ה-API והשירותים שזמינים בפרויקט, מריצים את הפקודה הבאה:
gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"
התוצאה כוללת את כל השירותים הציבוריים, את כל השירותים שלמשתמש שקורא לפונקציה יש הרשאה servicemanagement.services.bind לגביהם, ואת כל השירותים שכבר הופעלו בפרויקט.
אפשר להחריג את השירותים שפעילים כרגע בפרויקט על ידי העברת filter=state:DISABLED לקריאה הקודמת.
השלבים הבאים
במאמר הפעלה והשבתה של שירותים מוסבר איך להפעיל או להשבית שירותים בGoogle Cloud פרויקט.