הגדרת Cloud Billing Budget API

במדריך הזה מפורטים כל שלבי ההגדרה שנדרשים כדי להתחיל להשתמש ב-Cloud Billing Budget API.

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

לפני שתקראו את המדריך הזה:

1. קראו את המאמר סקירה כללית על Cloud Billing Budget API
2. קראו את המאמר הדרישות המוקדמות ל-Cloud Billing API.

מידע על מסוף Google Cloud

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

‫1. יצירת פרויקט חדש או בחירה בפרויקט קיים

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

המלצה בקשר לפרויקטים: כדאי ליצור פרויקט נפרד ב- Google Cloud שישמש אתכם לניהול החיוב ו-FinOps בחשבון לחיוב ב-Cloud, כולל השימוש ב-Cloud Billing Budget API. כאן מוסבר למה כדאי להשתמש בפרויקט שמתמקד ב-FinOps בכל התרחישים של ניהול החיובים.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

2. הפעלת החיוב

כדי לשלוח קריאה ל-Cloud Billing Budget API, צריך לוודא שהחיוב מופעל בפרויקט שבו אתם משתמשים. אם פעלתם בהתאם להמלצה בחלק של הפרויקט, זה יהיה הפרויקט ב- Google Cloud שמשמש לניהול החיוב או ה-FinOps.

Make sure that billing is enabled for your Google Cloud project.

באמצעות החשבון לחיוב ב-Cloud אתם יכולים לקבוע מי משלם על קבוצה מסוימת של משאבים ב-Google Cloud . המשאבים, כמו ממשקי API שמופעלים, מאורגנים בפרויקטים. אפשר לקשר חשבון לחיוב ב-Cloud לפרויקט אחד או יותר. השימוש בפרויקט מחויב בחשבון שמקושר לחיוב ב-Cloud. ברוב המקרים, מגדירים את החיוב בזמן שיוצרים פרויקט. מידע נוסף זמין במשאבי העזרה בנושא חיוב ב-Cloud.

עלות השימוש

התקציבים שאתם מגדירים לחיוב ב-Cloud משמשים למעקב אחרי העלויות שנצברות בחשבון לחיוב ב-Cloud. החשבון לחיוב ב-Cloud שאחריו עוקבים יכול להיות זה שמקושר לפרויקט שבו אתם משתמשים כדי לשלוח קריאה ל-Cloud Billing Budget API. חשוב לזכור שלקוחות Google Cloud יכולים להשתמש ב-Cloud Billing Budget API בחינם. אם תבחרו להגדיר התראות תקציב פרוגרמטיות, תחויבו במחירים הרגילים של Pub/Sub.

3. הפעלת ה-API

כדי לשלוח קריאה ל-Cloud Billing Budget API, צריך להפעיל את Cloud Billing Budget API בפרויקט שבו אתם משתמשים. אם פעלתם בהתאם להמלצה בחלק של הפרויקט, זה יהיה הפרויקט ב- Google Cloud שמשמש לניהול החיוב או ה-FinOps.

רוצים לדעת איך מפעילים או משביתים שירותים?

Enable the Cloud Billing Budget API.

Enable the API

4. הגדרת אימות והרשאה

אם אתם מתכוונים להשתמש ב-Cloud Billing Budget API, עליכם להגדיר אימות. כל אפליקציית לקוח שמשתמשת ב-API צריכה לאשר את הזהות שלה על ידי אימות. מידע נוסף נמצא במאמר אימות לחיוב ב-Cloud.

אפשר לבצע אימות כחשבון משתמש ספציפי, כמו חשבון Google או חשבון שירות. לחשבון המשתמש הזה צריכים להיות תפקידים מהממשק לניהול זהויות והרשאות גישה (IAM) שיש להם את ההרשאות שנדרשות ל-Cloud Billing Budget API.

כדי לוודא שלחשבון הראשי יש את ההרשאות שנדרשות לניהול התקציבים, צריך לבקש מהאדמין לתת לחשבון (באמצעות IAM) את התפקיד אדמין של חשבון לחיוב (roles/billing.admin) בחשבון לחיוב. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שהאדמין גם יוכל לתת לחשבון הראשי את ההרשאות שנדרשות באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

במאמר עדכון הרשאות לחיוב ב-Cloud מוסבר איך מקצים תפקידים בחשבון לחיוב.

5. התקנה והפעלה של CLI של gcloud

אם אתם מתכוונים להשתמש ב-Cloud Billing Budget API, אתם צריכים להתקין ולהפעיל את Google Cloud CLI‏. ‫Google Cloud CLI היא קבוצת כלים שבעזרתם אפשר לנהל את המשאבים והאפליקציות שמתארחים ב- Google Cloud. אחד מהכלים האלה הוא ה-CLI של gcloud. בקישורים הבאים תוכלו למצוא הוראות:

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

6. בדיקת ה-SDK והאימות

אם הגדרתם אימות בשלבים הקודמים, תוכלו להשתמש ב-CLI של gcloud כדי לבדוק את סביבת האימות. מפעילים את הפקודה הבאה כדי לוודא שאין שגיאות ושפרטי הכניסה מוחזרים:

gcloud auth print-access-token

הפקודה הזו משמשת כדי לאמת שליחת קריאות ל-API בכל הדוגמאות לשליחת קריאה ל-Cloud Billing Budget API באמצעות שורות הפקודה ב-REST.

7. התקנה של ספריית הלקוח של Cloud Billing Budget API

ה-Cloud Billing Budget API מבוסס על HTTP ועל JSON, כך שכל לקוח HTTP סטנדרטי יכול לשלוח בקשות לממשק ולנתח את התשובות.

יש שלוש אפשרויות לשלוח קריאה ל-API:

• ספריות לקוח ש-Google תומכת בהן (מומלץ)

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

• REST

• gRPC