Souscrire une offre d'engagement à l'aide de l'API Cloud Commerce Consumer Procurement

Vous pouvez acheter des offres à l'aide de l'API Cloud Commerce Consumer Procurement, un API permettant d'effectuer des achats sur Cloud Marketplace.

Actuellement, seuls les engagements basés sur les dépenses pour certains produits peuvent être souscrits via l'API. Ce guide d'utilisation explique comment souscrire un engagement basé sur les dépenses.

Avant de commencer

Identifier l'offre que vous souhaitez acheter

Pour souscrire un engagement basé sur les dépenses, vous devez utiliser un nom d'offre qui indique le le produit que vous achetez et la durée de la remise.

Les Offres suivantes sont disponibles à l'achat:

Produit Terme Nom de l'offre
VMWare Engine 1 an services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e
VMWare Engine 3 ans services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c
Engagement flexible Compute Engine 1 an services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2
Engagement flexible Compute Engine 3 ans services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f
AlloyDB pour PostgreSQL 1 an services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c
AlloyDB pour PostgreSQL 3 ans services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5
Cloud Bigtable 1 an services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39
Cloud Bigtable 3 ans services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff
Cloud Run 1 an services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e
Cloud Run 3 ans services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c
Cloud Spanner 1 an services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b
Cloud Spanner 3 ans services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603
Cloud SQL 1 an services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9
Cloud SQL 3 ans services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33
Kubernetes Engine 1 an services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1
Kubernetes Engine 3 ans services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578
Memorystore 1 an services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37
Memorystore 3 ans services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354

Identifier les paramètres "Offer"

Les engagements comportent deux paramètres:

  • Montant de l'engagement (hourly_commit): avoir appliqué à votre compte de facturation Cloud chaque heure suivant la souscription de cet engagement.
  • Région (region): région à laquelle les crédits de cet engagement s'appliquent.

Lorsque vous souscrivez un engagement, vous devez spécifier les deux paramètres.

Les produits ont des valeurs et des contraintes spécifiques pour leurs paramètres. Par exemple, Si vous souhaitez acheter VMWare Engine, vous pouvez vous référer aux valeurs suivantes et des contraintes:

Produit Engagement minimal Engagement maximal Régions
VMWare Engine 5 $ par heure 10 000 $ par heure 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

Souscrire l'offre

Pour acheter une offre, appelez billingAccounts.orders.place, et définissez les paramètres suivants:

  • hourly_commit indiquant la valeur monétaire de l'engagement.

  • Les region pour lesquels souscrire l'engagement.

Pour passer une commande, exécutez la commande suivante:

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

Cette commande renvoie le nom d'une opération de longue durée:

{
    "name": "OPERATION_NAME"
}

Pour vérifier que l'opération de longue durée renvoyée a bien été exécutée, exécutez la commande suivante : la commande suivante:

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'

L'opération de longue durée devrait s'effectuer en moins d'une seconde.

Afficher votre commande

Vous pouvez afficher l'état actuel d'un engagement directement dans la console Google Cloud. en appelant billingAccounts.orders.get Le champ name de la campagne créée indique son nom.

cURL

Pour afficher une commande, exécutez la commande suivante:

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. Accédez à https://console.cloud.google.com/billing.
  2. Sélectionnez votre compte Cloud Billing.
  3. Sélectionnez Engagements dans la barre latérale.
  4. L'engagement que vous avez souscrit est visible dans le tableau affiché.