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

Vous pouvez acheter des offres à l'aide de l'API Cloud Commerce Consumer Procurement, une API permettant d'effectuer des achats sur la place de marché Cloud.

Actuellement, seuls les engagements basés sur les dépenses pour certains produits peuvent être souscrits via l'API. Cet article explique comment souscrire un engagement basé sur les dépenses.

Avant de commencer

Identifier l'offre que vous souhaitez acheter

Pour acheter un engagement basé sur les dépenses, vous devez utiliser un nom d'offre qui indique le produit que vous achetez et la période de 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
Sauvegarde et reprise après sinistre 1 an services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a
Sauvegarde et reprise après sinistre 3 ans services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48
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
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 "Offer"

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 les crédits de cet engagement s'appliquent.

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

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 a bien été effectué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 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

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