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
Activez le paramètre API Cloud Commerce Consumer Procurement pour votre projet Google Cloud.
Assurez-vous de disposer de l'un des éléments suivants : Les rôles Identity and Access Management (IAM) pour la facturation Cloud compte que vous souhaitez utiliser pour souscrire l'engagement:
Administrateur de la facturation (
roles/billing.admin
) pour le compte de facturation Cloud cible OU Organisation Google Cloud dans laquelle se trouve votre compte de facturation.Administrateur des commandes d'approvisionnement des consommateurs (
roles/consumerprocurement.orderAdmin
) pour l'instance Cloud Billing cible compte OU l'organisation Google Cloud dans laquelle votre de votre compte.
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
- Accédez à https://console.cloud.google.com/billing.
- Sélectionnez votre compte Cloud Billing.
- Sélectionnez Engagements dans la barre latérale.
- L'engagement que vous avez souscrit est visible dans le tableau affiché.