API zum Kauf einer ausgabenbasierten Zusicherung verwenden

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

Mit dieser API können nur ausgabenbasierte Zusicherungen gekauft werden, keine ressourcenbasierten.

Hinweise

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

Wählen Sie das Angebot aus, das Sie kaufen möchten.

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

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

Die folgenden aktualisierten Angebote sind verfügbar:

Die folgenden Angebote sind vom neuen Modell für Rabatte für zugesicherte Nutzung nicht betroffen und können weiterhin gekauft werden:

Produkt	Begriff	Angebotsname
Backup for GKE	1 Jahr	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Backup for GKE	3 Jahre	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
Sicherung und Notfallwiederherstellung (VMware)	1 Jahr	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
Sicherung und Notfallwiederherstellung (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`

Angebots-Parameter ermitteln

Verpflichtungen haben zwei Parameter:

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

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

Angebot kaufen

Wenn Sie ein Angebot kaufen möchten, rufen Sie billingAccounts.orders.place auf und geben Sie die folgenden Parameter an:

Die hourly_commit gibt den Dollarwert der Zusage an.
Die region, für die die Zusicherung gekauft werden soll.

Führen Sie zum Aufgeben einer Bestellung den folgenden Befehl aus:

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 Zusage direkt in der Google Cloud -Konsole oder durch Aufrufen von billingAccounts.orders.get ansehen. Das Feld name der erstellten Bestellung gibt den Namen der Bestellung an.

cURL

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

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 (CUDs) aus.
Ihre erworbenen Zusicherungen werden angezeigt.