Utiliser l'API pour souscrire un engagement basé sur les dépenses

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

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

Avant de commencer

Identifier l'offre que vous souhaitez souscrire

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. Vous devez utiliser le nom d'offre qui correspond au modèle de votre compte de facturation Cloud.

Les offres suivantes sont disponibles à l'achat et suivent le nouveau modèle de consommation (remise directe, sans crédits) :

Produit Terme Champ d'application Nom de l'offre Paramètres obligatoires
AlloyDB pour PostgreSQL 1 an Monde services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2 commitment_amount (recommended)
ou hourly_commit
AlloyDB pour PostgreSQL 3 ans Monde services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a commitment_amount (recommended)
ou hourly_commit
Backup and DR (Oracle) 1 an Monde services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82 commitment_amount (recommended)
ou hourly_commit
Backup and DR (Oracle) 3 ans Monde services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354 commitment_amount (recommended)
ou hourly_commit
BigQuery 1 an Régional services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724 commitment_amount (recommandé)
ou hourly_commit,

region
BigQuery 3 ans Régional services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a commitment_amount (recommandé)
ou hourly_commit,

region
Bigtable 1 an Monde services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193 commitment_amount (recommended)
ou hourly_commit
Bigtable 3 ans Monde services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996 commitment_amount (recommended)
ou hourly_commit
Cloud Run 3 ans Régional services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0 commitment_amount (recommandé)
ou hourly_commit,

region
Cloud Run an Régional services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5 commitment_amount (recommandé)
ou hourly_commit,

region
Cloud SQL 1 an Régional services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3 commitment_amount (recommandé)
ou hourly_commit,

region
Cloud SQL 3 ans Régional services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8 commitment_amount (recommandé)
ou hourly_commit,

region
Engagement flexible Compute Engine 1 an Monde services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93 commitment_amount (recommended)
ou hourly_commit
Engagement flexible Compute Engine 3 ans Monde services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1 commitment_amount (recommended)
ou hourly_commit
Dataflow 1 an Monde services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95 commitment_amount (recommended)
ou hourly_commit
Dataflow 3 ans Monde services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573 commitment_amount (recommended)
ou hourly_commit
Firestore 1 an Monde services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21 commitment_amount (recommended)
ou hourly_commit
Firestore 3 ans Monde services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300 commitment_amount (recommended)
ou hourly_commit
Forfait Économies flexibles Gemini Enterprise 1 an Monde services/aiplatform.googleapis.com/standardOffers/740fd2e8-ff1d-4304-9e85-61c0f8d75811 commitment_amount
Forfait Économies flexibles Gemini Enterprise 3 ans Monde services/aiplatform.googleapis.com/standardOffers/4733352d-24b5-4609-b3ff-d2a694f51654 commitment_amount
Google Kubernetes Engine 1 an Régional services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44 commitment_amount (recommandé)
ou hourly_commit,

region
Google Kubernetes Engine 3 ans Régional services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015 commitment_amount (recommandé)
ou hourly_commit,

region
Managed Service pour Apache Kafka 1 an Monde services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956 commitment_amount (recommended)
ou hourly_commit
Managed Service pour Apache Kafka 3 ans Monde services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66 commitment_amount (recommended)
ou hourly_commit
Memorystore pour Redis 1 an Monde services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456 commitment_amount (recommended)
ou hourly_commit
Memorystore 3 ans Monde services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f commitment_amount (recommended)
ou hourly_commit
Spanner 1 an Monde services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403 commitment_amount (recommended)
ou hourly_commit
Spanner 3 ans Monde services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf commitment_amount (recommended)
ou hourly_commit

Les offres suivantes sont disponibles à l'achat et suivent l'ancien modèle de crédit (prix catalogue + compensation de crédit) :

Produit Terme Champ d'application Nom de l'offre Paramètres obligatoires
Backup and DR (VMWare) 1 an Régional services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a hourly_commit,

region
Backup and DR (VMWare) 3 ans Régional services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48 hourly_commit,

region
NetApp Volumes 1 an Monde services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca hourly_commit
NetApp Volumes 3 ans Monde services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c hourly_commit

Identifier les paramètres de l'offre

Voici les paramètres que vous devez définir pour souscrire l'offre :

  • Commitment_amount (recommandé) ou Hourly_commit :

    • Pour les engagements sur le nouveau modèle de remise sur engagement d'utilisation basé sur les dépenses : commitment_amount (recommandé) ou hourly_commit. Le paramètre hourly_commit sera à terme obsolète et remplacé par le paramètre générique commitment_amount à l'avenir pour les engagements sur le nouveau modèle. Certaines remises sur engagement d'utilisation sont compatibles avec une récurrence différente (horaire, mensuelle, etc.) et ne seront compatibles qu'avec le paramètre commitment_amount. Consultez la colonne "Paramètres obligatoires" dans les tableaux d'offres pour connaître les exigences spécifiques.

    • Pour les offres qui ne sont pas concernées par le nouveau modèle de remise sur engagement d'utilisation : spécifiez hourly_commit. Cela représente le crédit appliqué à votre compte de facturation Cloud chaque heure. Les anciennes remises sur engagement d'utilisation ne sont pas compatibles avec commitment_amount.

  • Région (region) : région à laquelle s'appliquent les avantages de cet engagement.

    • Pour les engagements régionaux : spécifiez la région cible (par exemple, us-central1). Pour trouver les dossiers et les régions compatibles pour chaque produit, consultez la documentation de ce produit ou la présentation des remises sur engagement d'utilisation.
    • Pour les engagements mondiaux : omettez ce paramètre, car les engagements mondiaux s'appliquent à toutes les régions.

Souscrire l'offre

Pour souscrire une offre, appelez billingAccounts.orders.place, et fournissez les paramètres suivants dans le corps de la requête :

  • Le paramètre de valeur d'engagement correspondant à votre type de remise sur engagement d'utilisation :

    • Pour les engagements sur le nouveau modèle de remise sur engagement d'utilisation basé sur les dépenses : fournissez commitment_amount (recommandé) ou hourly_commit (obsolète, sera supprimé à l'avenir). Pour les nouvelles offres de remise sur engagement d'utilisation (telles qu'AI Platform), vous devez spécifier commitment_amount.
    • Pour les anciennes remises sur engagement d'utilisation : fournissez hourly_commit.

  • region (uniquement pour les engagements régionaux). Si vous souscrivez un engagement mondial, omettez le paramètre region.

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": "commitment_amount",
        "value": {
            "doubleValue": COMMITMENT_AMOUNT
        }
        }, {
        "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 doit se terminer en moins d'une seconde.

Afficher votre commande

Vous pouvez afficher l'état actuel d'un engagement directement dans la console ou en appelant billingAccounts.orders.get. Google Cloud 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. Dans la Google Cloud console, accédez à votre compte de facturation Cloud.

    Accéder à votre compte de facturation Cloud

  2. Sélectionnez Remises sur engagement d'utilisation dans la barre latérale.

  3. Les engagements que vous avez souscrits s'affichent.