הגדרת 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. בקישורים הבאים תוכלו למצוא הוראות:

After installing the Google Cloud CLI, initialize it by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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