Derzeit können über die API nur ausgabenbasierte Zusicherungen für ausgewählte Produkte erworben werden. In dieser Anleitung wird beschrieben, wie Sie eine ausgabenbasierte Zusicherung erwerben.
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, das Sie für den Kauf der Zusicherung verwenden möchten:
Abrechnungsadministrator (
roles/billing.admin) für das Cloud-Rechnungskonto ODER die Google Cloud-Organisation, in der sich das Rechnungskonto befindet.Administrator von Nutzer-Beschaffungsaufträgen (
roles/consumerprocurement.orderAdmin) für das Cloud-Zielrechnungskonto ODER die Google Cloud-Organisation, in der sich das Rechnungskonto 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 erworbene Produkt und den Rabattzeitraum angibt.
Die folgenden Angebote können erworben werden:
| Produkt | Begriff | Angebotsname |
|---|---|---|
| VMware Engine | 1 Jahr | services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e |
| VMware Engine | 3 Jahre | services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c |
| Flexible Zusicherung für Compute Engine | 1 Jahr | services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2 |
| Flexible Zusicherung für Compute Engine | 3 Jahre | services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f |
| 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 |
| Cloud Bigtable | 1 Jahr | services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39 |
| Cloud 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 |
| Cloud Spanner | 1 Jahr | services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b |
| Cloud 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 |
| Kubernetes Engine | 1 Jahr | services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1 |
| Kubernetes Engine | 3 Jahre | services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578 |
| 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 |
Angebotsparameter identifizieren
Zusicherungen haben zwei Parameter:
- Zusicherungsbetrag (
hourly_commit): Das Guthaben, das Ihrem Cloud-Rechnungskonto jede Stunde nach dem Kauf dieser Zusicherung zugewiesen wird. - Region (
region): Die Region, für die das Guthaben dieser Zusicherung gilt.
Wenn Sie eine Zusicherung erwerben, müssen Sie beide Parameter angeben.
Produkte haben bestimmte Werte und Einschränkungen für ihre Parameter. Wenn Sie beispielsweise VMware Engine erwerben möchten, können Sie sich auf die folgenden Werte und Einschränkungen beziehen:
| Produkt | Mindestvertragsdauer | Maximale Zusicherung | Regionen |
|---|---|---|---|
| VMware Engine | 5 $ pro Stunde | 10.000 $ pro Stunde | asia-northeast1 asia-south1 asia-southeast1 australia-southeast1 europe-west2 europe-west3 europe-west4 northamerica-northeast northamerica-northeast1 southamerica-east1 us-central1 us-east4 us-west2 |
Angebot kaufen
Um ein Angebot zu kaufen, rufen Sie billingAccounts.orders.place auf 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 erworben 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"
}
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 lang andauernde 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 oder durch Aufrufen von billingAccounts.orders.get aufrufen.
Im Feld name des erstellten Auftrags wird der Name des Auftrags angegeben.
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
- Rufen Sie https://console.cloud.google.com/billing auf.
- Wählen Sie Ihr Cloud Billing-Konto aus.
- Wählen Sie in der Seitenleiste Zusicherungen aus.
- Ihre erworbene Zusicherung ist in der angezeigten Tabelle sichtbar.