Souscrire un engagement basé sur les dépenses

Ce document explique comment acheter un engagement basé sur les dépenses à l'aide de l'API Cloud Commerce Consumer Procurement pour les achats Cloud Marketplace.

Actuellement, cette API n'est compatible qu'avec l'achat d'engagements basés sur les dépenses, et non avec les engagements basés sur les ressources.

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.

Le nouveau modèle de remise sur engagement d'utilisation introduit de nouveaux noms d'offres pour les produits de remise sur engagement d'utilisation existants. Le tableau ci-dessous indique les noms des offres avant et après l'activation du nouveau modèle de remises sur engagement d'utilisation basé sur les dépenses. Vous devez utiliser le nom de l'offre qui correspond au modèle de votre compte de facturation Cloud.

Les offres mises à jour suivantes sont disponibles à l'achat :

Produit Terme Nom de l'offre avant l'inscription Nom de l'offre après l'activation
AlloyDB pour PostgreSQL 1 an services/alloydb.googleapis.com/standardOffers/adbca020-a973-48c9-b9b6-f5d70527790c services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2
AlloyDB pour PostgreSQL 3 ans services/alloydb.googleapis.com/standardOffers/56e5948f-f1ed-45ce-84d6-a8408092e7d5 services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a
Backup and DR (Oracle) 1 an services/backupdr.googleapis.com/standardOffers/5b446c4d-ce38-4d1a-8c76-e8b04ad50069 services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82
Backup and DR (Oracle) 3 ans services/backupdr.googleapis.com/standardOffers/0dba7aa1-3215-4d44-9581-e1c34ca94471 services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354
BigQuery 1 an services/bigqueryreservation.googleapis.com/standardOffers/6e72d4d4-5591-4c7f-aa9f-88d277d9280c services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724
BigQuery 3 ans services/bigqueryreservation.googleapis.com/standardOffers/ad5539c4-a0d9-4abd-82c9-1104a7c8ad64 services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a
Bigtable 1 an services/bigtable.googleapis.com/standardOffers/5a0a5567-1552-445e-9f1b-f1ac69fb0f39 services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193
Bigtable 3 ans services/bigtable.googleapis.com/standardOffers/26e8485e-acef-4e73-9a13-f0b2109befff services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996
Cloud Run 1 an services/run.googleapis.com/standardOffers/55435965-baf5-485f-baea-3fde53566e5e services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5
Cloud Run 3 ans services/run.googleapis.com/standardOffers/a8b22b6c-2992-48d3-9b73-98fc7a47d61c ? services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0
Engagement flexible Compute Engine 1 an services/compute.googleapis.com/standardOffers/ffe0f6a3-2f98-437e-8d49-fc443a05d3c2 services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93
Engagement flexible Compute Engine 3 ans services/compute.googleapis.com/standardOffers/062a285d-8989-4ce7-8f9a-bed8d183236f services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1
Google Kubernetes Engine 1 an services/container.googleapis.com/standardOffers/ae2672e6-47a8-41dc-9448-6956d7f4fbc1 services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44
Google Kubernetes Engine 3 ans services/container.googleapis.com/standardOffers/fcf378c1-fbe0-4aaa-b05e-9597f8b45578 services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015
Dataflow 1 an services/dataflow.googleapis.com/standardOffers/42ae4415-0361-404f-8bc5-1e7c041c2d82 services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95
Dataflow 3 ans services/dataflow.googleapis.com/standardOffers/cac998b8-3d49-4672-ae5b-e5b3c56e05f2 services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573
Firestore 1 an services/firestore.googleapis.com/standardOffers/f8485012-b340-4562-8302-7e27d48f8cfd services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21
Firestore 3 ans services/firestore.googleapis.com/standardOffers/0b48b55a-1fa6-48bc-a3de-2d88f0b99e15 services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300
Managed Service pour Apache Kafka 1 an services/managedkafka.googleapis.com/standardOffers/e1636f7d-1a29-4d53-a89e-c1f60e8dadcf services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956
Managed Service pour Apache Kafka 3 ans services/managedkafka.googleapis.com/standardOffers/31d79333-0c0e-4208-9b20-c6e4f27e5d1d services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66
Memorystore pour Redis 1 an services/redis.googleapis.com/standardOffers/fe93270a-f338-4a76-b303-c323608a9d37 services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456
Memorystore 3 ans services/redis.googleapis.com/standardOffers/8f20579e-7630-4592-8fa6-0d7d3b749354 services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f
Spanner 1 an services/spanner.googleapis.com/standardOffers/29829e5f-681c-4810-a471-8e4611a8042b services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403
Spanner 3 ans services/spanner.googleapis.com/standardOffers/709f6c69-8a49-4032-97f7-ce21fe340603 services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf
Cloud SQL 1 an services/cloudsql.googleapis.com/standardOffers/266e6a8c-2a0d-4b92-af9c-5795760f1fc9 services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3
Cloud SQL 3 ans services/cloudsql.googleapis.com/standardOffers/4998bf0a-51dd-4ce0-8405-aa529dd86d33 services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8

Les offres suivantes ne sont pas concernées par le nouveau modèle de remises sur engagement d'utilisation et sont disponibles à l'achat :

Produit Terme Nom de l'offre
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 (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
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

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 avantages 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

  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é.