Aujourd'hui, seuls les engagements basés sur les dépenses pour certains produits peuvent être achetés via l'API. Cette procédure explique comment souscrire un engagement basé sur les dépenses.
Avant de commencer
Activez l'API Cloud Commerce Consumer Procurement pour votre projet Google Cloud .
Assurez-vous de disposer de l'un des rôles Identity and Access Management (IAM) suivants pour le compte de facturation Cloud que vous souhaitez utiliser pour acheter l'engagement :
Administrateur de la facturation (
roles/billing.admin
) pour le compte de facturation Cloud cible OU l'organisationGoogle Cloud dans laquelle se trouve votre compte de facturation.Administrateur des commandes d'approvisionnement des consommateurs (
roles/consumerprocurement.orderAdmin
) pour le compte de facturation Cloud cible OU l'organisation Google Cloud dans laquelle se trouve votre compte de facturation.
Identifiez l'offre que vous souhaitez acheter.
Pour souscrire un engagement basé sur les dépenses, vous 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 |
---|---|---|
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 |
Sauvegarde pour GKE | 1 an | services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7 |
Sauvegarde pour GKE | 3 ans | services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5 |
Backup and DR (Oracle) | 1 an | services/backupdr.googleapis.com/standardOffers/5b446c4d-ce38-4d1a-8c76-e8b04ad50069 |
Backup and DR (Oracle) | 3 ans | services/backupdr.googleapis.com/standardOffers/0dba7aa1-3215-4d44-9581-e1c34ca94471 |
Backup and DR (VMware) | 1 an | services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a |
Backup and DR (VMware) | 3 ans | services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48 |
BigQuery | 1 an | services/bigqueryreservation.googleapis.com/standardOffers/6e72d4d4-5591-4c7f-aa9f-88d277d9280c |
BigQuery | 3 ans | services/bigqueryreservation.googleapis.com/standardOffers/ad5539c4-a0d9-4abd-82c9-1104a7c8ad64 |
Bigtable | 1 an | services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39 |
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 |
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 |
Google Kubernetes Engine | 1 an | services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1 |
Google Kubernetes Engine | 3 ans | services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578 |
Dataflow | 1 an | services/dataflow.googleapis.com/standardOffers/42ae4415-0361-404f-8bc5-1e7c041c2d82 |
Dataflow | 3 ans | services/dataflow.googleapis.com/standardOffers/cac998b8-3d49-4672-ae5b-e5b3c56e05f2 |
Firestore | 1 an | services/firestore.googleapis.com/standardOffers/f8485012-b340-4562-8302-7e27d48f8cfd |
Firestore | 3 ans | services/firestore.googleapis.com/standardOffers/0b48b55a-1fa6-48bc-a3de-2d88f0b99e15 |
Managed Service pour Apache Kafka | 1 an | services/managedkafka.googleapis.com/standardOffers/e1636f7d-1a29-4d53-a89e-c1f60e8dadcf |
Managed Service pour Apache Kafka | 3 ans | services/managedkafka.googleapis.com/standardOffers/31d79333-0c0e-4208-9b20-c6e4f27e5d1d |
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 |
NetApp Volumes | 1 an | services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca |
NetApp Volumes | 3 ans | services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c |
Spanner | 1 an | services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b |
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 |
Identifier les paramètres de l'offre
Les engagements comportent deux paramètres :
- Montant de l'engagement (
hourly_commit
) : crédit appliqué à votre compte de facturation Cloud chaque heure après l'achat de cet engagement. - Région (
region
) : région à laquelle s'appliquent les crédits de cet engagement.
Lorsque vous souscrivez un engagement, vous devez spécifier les deux paramètres.
Acheter l'offre
Pour acheter une offre, appelez billingAccounts.orders.place
et fournissez les paramètres suivants :
hourly_commit
indiquant la valeur en dollars de l'engagement.region
pour lequel 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
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 terminée correctement, 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 se terminer en moins d'une seconde.
Afficher votre commande
Vous pouvez afficher l'état actuel d'un engagement directement dans la console Google Cloud ou en appelant billingAccounts.orders.get
.
Le champ name
de la commande créée spécifie le nom de la commande.
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é.