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

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, mit dem Sie die Bindung abschließen möchten:

  • Abrechnungsadministrator (roles/billing.admin) für das Cloud Billing-Zielkonto ODER die Google Cloud-Organisation, in der sich Ihr Rechnungskonto befindet.

  • Administrator von Nutzer-Beschaffungsaufträgen (roles/consumerprocurement.orderAdmin) für das Cloud Billing-Zielkonto ODER die Google Cloud-Organisation, in der sich Ihr Rechnungskonto befindet.

Angebot auswählen, 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:

Angebotsparameter identifizieren

Verpflichtungen haben zwei Parameter:

• Zusicherungsbetrag (hourly_commit): Der Betrag, der Ihrem Cloud-Rechnungskonto nach dem Kauf dieser Zusicherung stündlich gutgeschrieben wird.
• Region (region): Die Region, für die die Gutschriften für diese Zusicherung gelten.

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

Angebot kaufen

Wenn du ein Angebot kaufen möchtest, rufe billingAccounts.orders.place auf und gib die folgenden Parameter an:

• hourly_commit gibt den Dollarwert der Verpflichtung 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

Dies gibt den Namen eines lang andauernden Vorgangs zurück:

{
    "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 Verpflichtung direkt in der Google Cloud Console oder durch Aufrufen von billingAccounts.orders.get einsehen. Das Feld name der erstellten Bestellung gibt den Bestellnamen an.

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'