Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

שימוש ב-API לרכישת התחייבות להוצאה

במאמר הזה מוסבר איך לרכוש התחייבות להוצאה באמצעות Cloud Commerce Consumer Procurement API לרכישות ב-Cloud Marketplace.

ה-API הזה תומך רק ברכישת התחייבויות להוצאה, ולא בהתחייבויות לשימוש במשאבים.

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

מפעילים את Cloud Commerce Consumer Procurement API בפרויקט ב- Google Cloud .
צריך לוודא שיש לכם אחד מהתפקידים הבאים בממשק לניהול הזהויות והרשאות הגישה (IAM) בחשבון לחיוב ב-Cloud שבו אתם רוצים להשתמש כדי לרכוש את ההתחייבות:
- אדמין לחיוב (roles/billing.admin) בחשבון לחיוב ב-Cloud או בארגוןGoogle Cloud שבו נמצא החשבון לחיוב.
- אדמין של הזמנת רכש לצרכן (roles/consumerprocurement.orderAdmin) בחשבון היעד לחיוב ב-Cloud או בארגון Google Cloud שבו נמצא החשבון לחיוב.

מזהים את המבצע שרוצים לרכוש.

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

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

המבצעים המעודכנים הבאים זמינים לרכישה:

המוצרים הבאים לא מושפעים ממודל ה-CUD החדש וזמינים לרכישה:

מוצר	מונח	שם המבצע
גיבוי ל-GKE	שנה אחת	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
גיבוי ל-GKE	3 שנים	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
‫Backup and DR (VMWare)	שנה אחת	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
‫Backup and DR (VMWare)	3 שנים	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	שנה אחת	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3 שנים	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

זיהוי הפרמטרים של המבצע

להתחייבויות יש שני פרמטרים:

סכום ההתחייבות (hourly_commit): הזיכוי שמוחל על החשבון לחיוב ב-Cloud בכל שעה אחרי שרוכשים את ההתחייבות הזו.
בתוכנית CUDs מדור קודם לפני העברה אוטומטית של החשבון, סכום ההתחייבות היה המחיר לפי דרישה. מידע נוסף זמין במאמר הנחות תמורת התחייבות להוצאה.
‫Region (region): האזור שבו חלים היתרונות של ההתחייבות הזו.

כשרוכשים התחייבות, צריך לציין את שני הפרמטרים.

רכישת המבצע

כדי לרכוש מבצע, צריך להתקשר אל billingAccounts.orders.place ולספק את הפרמטרים הבאים:

הסמל hourly_commit שמציין את ערך ההתחייבות בדולרים.
הסכום region לרכישת ההתחייבות.

כדי לבצע הזמנה, מריצים את הפקודה הבאה:

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/billingAccounts/BILLING_ACCOUNT_ID/orders:place' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID' \
    -d '@-' <<EOF
    {
    "displayName": "DISPLAY_NAME",
    "lineItemInfo": [{
        "parameters": [{
        "name": "hourly_commit",
        "value": {
            "doubleValue": HOURLY_COMMIT
        }
        }, {
        "name": "region",
        "value": {
            "stringValue": "REGION"
        }
        }],
        "offer": "OFFER_NAME"
    }]
    }
EOF

הפעולה הזו מחזירה את השם של פעולה ממושכת:

{
    "name": "OPERATION_NAME"
}

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

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/OPERATION_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

הפעולה ארוכת הטווח אמורה להסתיים תוך פחות משנייה אחת.

צפייה בהזמנה

אפשר לראות את המצב הנוכחי של ההתחייבות ישירות במסוף Google Cloud או באמצעות קריאה ל-billingAccounts.orders.get. השדה name של ההזמנה שנוצרה מציין את שם ההזמנה.

cURL

כדי להציג הזמנה, מריצים את הפקודה הבאה:

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

המסוף

נכנסים לחשבון לחיוב ב-Cloud במסוף Google Cloud .

כניסה לחשבון לחיוב ב-Cloud
בסרגל הצד, בוחרים באפשרות Committed use discounts (CUDs).
ההתחייבויות שרכשתם מוצגות.