Mit der Cloud Commerce Consumer Procurement API ein Angebot mit Zusicherung erwerben

Sie können Angebote mit der Cloud Commerce Consumer Procurement API, einer API für Cloud Marketplace-Käufe

Derzeit können nur ausgabenbasierte Zusicherungen für ausgewählte Produkte über die API verwenden. In dieser Anleitung wird beschrieben, wie Sie eine ausgabenbasierte Zusicherung erwerben.

Hinweis

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

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

Die folgenden Angebote können gekauft werden:

Produkt Begriff Angebotsname
AlloyDB for PostgreSQL 1 Jahr services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c
AlloyDB for PostgreSQL 3 Jahre services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5
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 1 Jahr services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a
Sicherung und Notfallwiederherstellung 3 Jahre services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48
Bigtable 1 Jahr services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39
Bigtable 3 Jahre services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff
Cloud Run 1 Jahr services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e
Cloud Run 3 Jahre services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c
Flexible Compute Engine-Zusicherung 1 Jahr services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2
Flexible Compute Engine-Zusicherung 3 Jahre services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f
Google Kubernetes Engine 1 Jahr services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1
Google Kubernetes Engine 3 Jahre services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578
Dataflow 1 Jahr services/dataflow.googleapis.com/standardOffers/42ae4415-0361-404f-8bc5-1e7c041c2d82
Dataflow 3 Jahre services/dataflow.googleapis.com/standardOffers/cac998b8-3d49-4672-ae5b-e5b3c56e05f2
Memorystore 1 Jahr services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37
Memorystore 3 Jahre services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354
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
Spanner 1 Jahr services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b
Spanner 3 Jahre services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603
Cloud SQL 1 Jahr services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9
Cloud SQL 3 Jahre services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33

Angebotsparameter identifizieren

Zusicherungen haben zwei Parameter:

  • Verpflichtungsbetrag (hourly_commit): Der Betrag, der Ihrem Cloud-Rechnungskonto nach dem Kauf dieser Verpflichtung stündlich gutgeschrieben wird.
  • Region (region): Die Region, für die das Guthaben dieser Zusicherung gilt.

Wenn Sie ein Abo abschließen, müssen Sie beide Parameter angeben.

Angebot kaufen

Um ein Angebot zu erwerben, rufen Sie billingAccounts.orders.place, und geben Sie die folgenden Parameter an:

  • Die hourly_commit, die den Wert der Zusicherung in Dollar angibt.

  • Die region, für die die Zusicherung gekauft werden soll.

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 lang andauernden Vorgangs zurückgegeben:

{
    "name": "OPERATION_NAME"
}

Um zu prüfen, ob der zurückgegebene langlaufende Vorgang erfolgreich abgeschlossen wurde, führen Sie den folgenden Befehl aus:

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 langwierige Vorgang sollte in weniger als einer Sekunde abgeschlossen sein.

Bestellung ansehen

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

cURL

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

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 https://console.cloud.google.com/billing auf.
  2. Wählen Sie Ihr Cloud Billing-Konto aus.
  3. Wählen Sie in der Seitenleiste Zusicherungen aus.
  4. Die von Ihnen gekaufte Zusicherung wird in der angezeigten Tabelle angezeigt.