Diese Seite wurde von der Cloud Translation API übersetzt.

API zum Kauf einer ausgabenbasierten Zusicherung verwenden

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

Derzeit können mit dieser API nur ausgabenbasierte Zusicherungen erworben 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 CUD-Modell werden neue Angebotsnamen für bestehende CUD-Produkte eingeführt. In der folgenden Tabelle finden Sie die Angebotsnamen vor und nach der Aktivierung des neuen ausgabenbasierten CUD-Modells. 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 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 die zugesicherte Nutzung ist der Betrag der Zusicherung stattdessen der On-Demand-Preis. Weitere Informationen zu den Unterschieden zwischen dem alten und dem neuen Programm für ausgabenbasierte Rabatte für zugesicherte Nutzung finden Sie unter Verbesserungen am Programm für ausgabenbasierte Rabatte für zugesicherte Nutzung.
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.