Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

Activez l' API Cloud Commerce Consumer Procurement pour votre Google Cloud projet.
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 souscrire l'engagement :
- Administrateur de la facturation (roles/billing.admin) pour le compte de facturation Cloud cible OU l' Google Cloud organisation dans laquelle se trouve votre compte de facturation.
- Administrateur des commandes Consumer Procurement (roles/consumerprocurement.orderAdmin) pour le compte de facturation Cloud cible OU l'organisation dans laquelle se trouve votre compte de facturation. Google Cloud

Identifier 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'offre pour les produits de remise sur engagement d'utilisation existants. Le tableau suivant fournit les noms d'offre avant et après la migration vers le nouveau modèle de remise sur engagement d'utilisation basée sur les dépenses. Vous devez utiliser le nom d'offre qui correspond au modèle de votre compte de facturation Cloud.

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

Les offres suivantes ne sont pas affectées par le nouveau modèle de remise 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.
Dans l'ancien programme de remise sur engagement d'utilisation avant la migration automatique du compte, le montant de votre engagement était le prix à la demande. Pour en savoir plus, consultez la section Remises sur engagement d'utilisation basées sur les dépenses.
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 laquelle vous souhaitez 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 doit se terminer en moins d'une seconde.

Afficher votre commande

Vous pouvez afficher l'état actuel d'un engagement directement dans Google Cloud laconsole 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

Dans la Google Cloud console, accédez à votre compte de facturation Cloud.

Accéder à votre compte de facturation Cloud
Sélectionnez Remises sur engagement d'utilisation dans la barre latérale.
Les engagements que vous avez souscrits s'affichent.