API zum Kauf einer ausgabenbasierten Zusicherung verwenden

In diesem Dokument wird beschrieben, wie Sie einen ausgabenbasierten Rabatt für zugesicherte Nutzung mit der Cloud Commerce Consumer Procurement API für Cloud Marketplace-Käufe erwerben.

Diese API unterstützt nur den Kauf von ausgabenbasierten Rabatten für zugesicherte Nutzung, nicht von ressourcenbasierten Rabatten.

Hinweis

Angebot auswählen

Wenn Sie einen ausgabenbasierten Rabatt für zugesicherte Nutzung erwerben möchten, verwenden Sie einen Angebotsnamen, der das Produkt und die Rabattlaufzeit angibt. Sie müssen den Angebotsnamen verwenden, der dem Modell Ihres Cloud-Rechnungskonto entspricht.

Die folgenden Angebote können erworben werden und folgen dem neuen Nutzungsmodell (direkter Rabatt, kein Guthaben) :

Produkt Begriff Umfang Angebotsname Erforderliche Parameter
AlloyDB for PostgreSQL 1 Jahr Global services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2 commitment_amount (empfohlen)
oder hourly_commit
AlloyDB for PostgreSQL 3 Jahre Global services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a commitment_amount (empfohlen)
oder hourly_commit
Backup and DR (Oracle) 1 Jahr Global services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82 commitment_amount (empfohlen)
oder hourly_commit
Backup and DR (Oracle) 3 Jahre Global services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354 commitment_amount (empfohlen)
oder hourly_commit
BigQuery 1 Jahr Regional services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724 commitment_amount (empfohlen)
oder hourly_commit,

region
BigQuery 3 Jahre Regional services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a commitment_amount (empfohlen)
oder hourly_commit,

region
Bigtable 1 Jahr Global services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193 commitment_amount (empfohlen)
oder hourly_commit
Bigtable 3 Jahre Global services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996 commitment_amount (empfohlen)
oder hourly_commit
Cloud Run 3 Jahre Regional services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0 commitment_amount (empfohlen)
oder hourly_commit,

region
Cloud Run Jahr Regional services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5 commitment_amount (empfohlen)
oder hourly_commit,

region
Cloud SQL 1 Jahr Regional services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3 commitment_amount (empfohlen)
oder hourly_commit,

region
Cloud SQL 3 Jahre Regional services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8 commitment_amount (empfohlen)
oder hourly_commit,

region
Flexible Zusicherung für Compute Engine 1 Jahr Global services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93 commitment_amount (empfohlen)
oder hourly_commit
Flexible Zusicherung für Compute Engine 3 Jahre Global services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1 commitment_amount (empfohlen)
oder hourly_commit
Dataflow 1 Jahr Global services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95 commitment_amount (empfohlen)
oder hourly_commit
Dataflow 3 Jahre Global services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573 commitment_amount (empfohlen)
oder hourly_commit
Firestore 1 Jahr Global services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21 commitment_amount (empfohlen)
oder hourly_commit
Firestore 3 Jahre Global services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300 commitment_amount (empfohlen)
oder hourly_commit
Gemini Enterprise Flexible Savings Plan 1 Jahr Global services/aiplatform.googleapis.com/standardOffers/740fd2e8-ff1d-4304-9e85-61c0f8d75811 commitment_amount
Gemini Enterprise Flexible Savings Plan 3 Jahre Global services/aiplatform.googleapis.com/standardOffers/4733352d-24b5-4609-b3ff-d2a694f51654 commitment_amount
Google Kubernetes Engine 1 Jahr Regional services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44 commitment_amount (empfohlen)
oder hourly_commit,

region
Google Kubernetes Engine 3 Jahre Regional services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015 commitment_amount (empfohlen)
oder hourly_commit,

region
Managed Service for Apache Kafka 1 Jahr Global services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956 commitment_amount (empfohlen)
oder hourly_commit
Managed Service for Apache Kafka 3 Jahre Global services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66 commitment_amount (empfohlen)
oder hourly_commit
Memorystore for Redis 1 Jahr Global services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456 commitment_amount (empfohlen)
oder hourly_commit
Memorystore 3 Jahre Global services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f commitment_amount (empfohlen)
oder hourly_commit
Spanner 1 Jahr Global services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403 commitment_amount (empfohlen)
oder hourly_commit
Spanner 3 Jahre Global services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf commitment_amount (empfohlen)
oder hourly_commit

Die folgenden Angebote können erworben werden und folgen dem Legacy-Guthabenmodell (Listenpreis + Guthaben-Offset) :

Produkt Begriff Umfang Angebotsname Erforderliche Parameter
Backup and DR (VMWare) 1 Jahr Regional services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a hourly_commit,

region
Backup and DR (VMWare) 3 Jahre Regional services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48 hourly_commit,

region
NetApp Volumes 1 Jahr Global services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca hourly_commit
NetApp Volumes 3 Jahre Global services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c hourly_commit

Angebotsparameter angeben

Hier sind die Parameter, die Sie festlegen sollten, um das Angebot zu erwerben:

  • Commitment_amount (empfohlen) oder Hourly_commit:

    • Für Rabatte für zugesicherte Nutzung auf Basis der Ausgaben: commitment_amount (empfohlen) oder hourly_commit. Der Parameter hourly_commit wird eingestellt und in Zukunft durch den generischen Parameter commitment_amount für Zusicherungen für das neue Modell ersetzt. Einige Rabatte für zugesicherte Nutzung unterstützen eine andere Wiederholung (stündlich, monatlich usw.) und nur den Parameter commitment_amount. Informationen zu den spezifischen Anforderungen finden Sie in der Spalte „Erforderliche Parameter“ in den Angebotstabellen.

    • Für Angebote, die vom neuen Rabatt für zugesicherte Nutzung-Modell nicht betroffen sind: Geben Sie hourly_commit an. Dies entspricht dem Guthaben, das Ihrem Cloud-Rechnungskonto jede Stunde gutgeschrieben wird. Legacy-Rabatte für zugesicherte Nutzung unterstützen commitment_amount nicht.

  • Region (region): Die Region, für die die Vorteile dieses Rabatts für zugesicherte Nutzung gelten.

    • Für regionale Rabatte für zugesicherte Nutzung: Geben Sie die Zielregion an (z. B. us-central1). Informationen zu Ordnern und unterstützten Regionen für die einzelnen Produkte finden Sie in der Dokumentation des jeweiligen Produkts oder in der Übersicht zu Rabatten für zugesicherte Nutzung.
    • Für globale Rabatte für zugesicherte Nutzung: Lassen Sie diesen Parameter weg, da globale Rabatte für zugesicherte Nutzung in allen Regionen gelten.

Angebot erwerben

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

  • Der Parameter für den Wert des Rabatts für zugesicherte Nutzung, der Ihrem Rabatttyp entspricht:

    • Für Zusicherungen für das neue ausgabenbasierte Rabattmodell: Geben Sie commitment_amount (empfohlen) oder hourly_commit (eingestellt, wird in Zukunft entfernt) an. Für neue Rabattangebote für zugesicherte Nutzung (z. B. AI Platform) müssen Sie commitment_amount angeben.
    • Für Legacy-Rabatte für zugesicherte Nutzung: Geben Sie hourly_commit an.

  • Die region (nur für regionale Rabatte für zugesicherte Nutzung). Wenn Sie einen globalen Rabatt für zugesicherte Nutzung erwerben, lassen Sie den Parameter region weg.

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": "commitment_amount",
        "value": {
            "doubleValue": COMMITMENT_AMOUNT
        }
        }, {
        "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 der Google Cloud Console oder durch Aufrufen von billingAccounts.orders.get ansehen. Im Feld name der erstellten Bestellung wird der Bestellname angegeben.

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

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

    Zu Ihrem Cloud-Rechnungskonto

  2. Wählen Sie in der Seitenleiste Rabatte für zugesicherte Nutzung (Committed Use Discounts, CUDs) aus.

  3. Die erworbenen Rabatte für zugesicherte Nutzung werden angezeigt.