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

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

Aujourd'hui, l'API est en version bêta, et seuls les engagements basés sur les dépenses peuvent être souscrits via l'API. Ce guide explique comment souscrire un engagement basé sur les dépenses.

Avant de commencer

Identifiez l'offre que vous souhaitez acheter.

Pour souscrire un engagement basé sur les dépenses, utilisez un nom d'offre qui indique 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
Moteur VMWare 1 an services/vmwareengine.googleapis.com/standardOffers/094acb28-d4fc-49fb-9490-0c469cc7048e
Moteur VMWare 3 years services/vmwareengine.googleapis.com/standardOffers/f179581e-c899-4271-9462-9f9e0ed1526c

Identifier les paramètres d'offre

Les engagements disposent de deux paramètres:

  • Montant de l'engagement (hourly_commit): le crédit appliqué à votre compte de facturation Cloud toutes les heures après avoir souscrit cet engagement.
  • Region (region): région pour laquelle les crédits de cet engagement s'appliquent.

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

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

Produit Engagement minimal Engagement maximal Régions
Moteur VMWare 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

Acheter l'offre

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

  • Valeur de hourly_commit indiquant la valeur en euros de l'engagement.

  • region pour lequel l'engagement doit être souscrit.

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

Cela 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 s'est bien terminée, exécutez 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 prendre moins d'une seconde.

Afficher votre commande

Vous pouvez afficher l'état actuel d'un engagement directement dans Google Cloud Console ou en appelant billingAccounts.orders.get. Le champ name de la campagne créée spécifie le nom de la campagne.

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. Dans la barre latérale, sélectionnez Engagements.
  4. Votre engagement souscrit est visible dans le tableau affiché.