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
Activez l'API Cloud Commerce Procurement pour votre projet Google Cloud.
Assurez-vous que vous disposez de l'un des rôles IAM (Identity and Access Management) suivants pour le compte de facturation Cloud que vous souhaitez utiliser pour souscrire l'engagement:
Administrateur de facturation (
roles/billing.admin
) pour le compte de facturation Cloud OU l'organisation Google Cloud où se trouve votre compte de facturation.Administrateur des commandes d'approvisionnement du consommateur (
roles/consumerprocurement.orderAdmin
) pour le compte de facturation Cloud cible OU l'organisation Google Cloud où se trouve votre compte de facturation.
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
- Accédez à https://console.cloud.google.com/billing.
- Sélectionnez votre compte Cloud Billing.
- Dans la barre latérale, sélectionnez Engagements.
- Votre engagement souscrit est visible dans le tableau affiché.