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

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

• 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'organisation Google 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 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:

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

Lorsque vous achetez 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 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 doit 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 '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'