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

API zum Kauf einer ausgabenbasierten Zusicherung verwenden

In diesem Dokument wird beschrieben, wie Sie mit der Cloud Commerce Consumer Procurement API für Cloud Marketplace-Käufe eine ausgabenbasierte Zusicherung erwerben.

Diese API unterstützt nur den Kauf ausgabenbasierter Zusicherungen, nicht ressourcenbasierter Zusicherungen.

Hinweis

Aktivieren Sie die Cloud Commerce Consumer Procurement API für Ihr Google Cloud Projekt.
Sie benötigen eine der folgenden Rollen für Identity and Access Management (IAM) für das Cloud-Rechnungskonto , mit dem Sie die Zusicherung erwerben möchten:
- Abrechnungsadministrator (roles/billing.admin) für das Cloud-Rechnungskonto ODER die Google Cloud Organisation, in der sich Ihr Rechnungskonto befindet.
- Bestelladministrator für Verbraucherkäufe (roles/consumerprocurement.orderAdmin) für das Cloud-Zielrechnungskonto ODER die Google Cloud Organisation, in der sich Ihr Rechnungskonto befindet.

Angebot auswählen

Wenn Sie eine ausgabenbasierte Zusicherung erwerben möchten, verwenden Sie einen Angebotsnamen, der das Produkt und die Rabattlaufzeit angibt.

Mit dem neuen CUD-Modell werden neue Angebotsnamen für bestehende CUD-Produkte eingeführt. In der folgenden Tabelle sind die Angebotsnamen vor und nach der Migration zum neuen ausgabenbasierten Rabatt für zugesicherte Nutzung-Modell aufgeführt. Sie müssen den Angebotsnamen verwenden, der dem Modell Ihres Cloud-Rechnungskonto entspricht.

Die folgenden aktualisierten Angebote können erworben werden:

Die folgenden Angebote sind vom neuen CUD-Modell nicht betroffen und können erworben werden:

Produkt	Begriff	Angebotsname
Sicherung für GKE	1 Jahr	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Sicherung für GKE	3 Jahre	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Backup and DR (VMWare)	1 Jahr	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Backup and DR (VMWare)	3 Jahre	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	1 Jahr	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3 Jahre	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

Angebotsparameter identifizieren

Zusicherungen haben zwei Parameter:

Zusicherungsbetrag (hourly_commit): Das Guthaben, das Ihrem Cloud-Rechnungskonto jede Stunde nach dem Kauf dieser Zusicherung gutgeschrieben wird.
Im alten CUD-Programm vor der automatischen Kontomigration war der Zusicherungs betrag stattdessen der On-Demand-Preis. Weitere Informationen finden Sie unter Ausgabenbasierte Rabatte für zugesicherte Nutzung.
Region (region): Die Region, für die die Vorteile dieser Zusicherung gelten.

Wenn Sie eine Zusicherung erwerben, müssen Sie beide Parameter angeben.

Angebot erwerben

Rufen Sie billingAccounts.orders.placeauf, um ein Angebot zu erwerben, und geben Sie die folgenden Parameter an:

Die hourly_commit, die den Wert der Zusicherung in US-Dollar angibt.
Die region, für die Sie die Zusicherung erwerben möchten.

Führen Sie den folgenden Befehl aus, um eine Bestellung aufzugeben:

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

Dadurch wird der Name eines Vorgangs mit langer Ausführungszeit zurückgegeben:

{
    "name": "OPERATION_NAME"
}

Führen Sie den folgenden Befehl aus, um zu prüfen, ob der zurückgegebene Vorgang mit langer Ausführungszeit erfolgreich abgeschlossen wurde:

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'

Der Vorgang mit langer Ausführungszeit sollte in weniger als einer Sekunde abgeschlossen sein.

Bestellung ansehen

Sie können den aktuellen Status einer Zusicherung direkt in Google Cloud der Console oder durch Aufrufen billingAccounts.orders.get ansehen. Das Feld name der erstellten Bestellung gibt den Bestellnamen an.

cURL

Führen Sie den folgenden Befehl aus, um eine Bestellung anzusehen:

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'

Console

Rufen Sie in der Google Cloud Console Ihr Cloud-Rechnungskonto auf.

Zu Ihrem Cloud-Rechnungskonto
Wählen Sie in der Seitenleiste Rabatte für zugesicherte Nutzung (Committed Use Discounts, CUDs) aus.
Die von Ihnen erworbenen Zusicherungen werden angezeigt.