Vous pouvez afficher ces engagements à l'aide de la console Google Cloud , de la gcloud CLI ou de REST.
Avant de commencer
-
Si ce n'est pas déjà fait, configurez l'authentification.
L'authentification permet de valider votre identité pour accéder aux services et aux API Google Cloud . Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console
Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.
gcloud
-
Installez la Google Cloud CLI. Après l'installation, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud initSi vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
- Définissez une région et une zone par défaut.
REST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI.
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud .
Rôles requis
Pour obtenir l'autorisation dont vous avez besoin pour afficher les engagements basés sur les ressources, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de Compute (roles/compute.viewer) ou Administrateur de Compute (roles/compute.admin) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations compute.commitments.get et compute.commitments.list, qui sont nécessaires pour afficher les engagements basés sur les ressources.
Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.
Afficher la liste des engagements
Vous pouvez afficher la liste de tous les engagements de votre projet à l'aide de la consoleGoogle Cloud , de la gcloud CLI ou de REST.
Console
Dans la console Google Cloud , accédez à la page Remises sur engagement d'utilisation. Accéder aux remises sur engagement d'utilisation
Pour afficher la liste des engagements d'une catégorie spécifique, sélectionnez l'un des onglets suivants :
- Engagements matériels : sélectionnez cet onglet pour afficher les engagements pour les ressources matérielles, telles que les processeurs virtuels, la mémoire, les GPU, les disques SSD locaux et les nœuds à locataire unique.
- Engagements de licences logicielles : sélectionnez cet onglet pour afficher les engagements pour les licences d'OS.
- Engagements de stockage de blocs : sélectionnez cet onglet pour afficher les engagements pour la capacité Exapool.
gcloud
Pour lister tous les engagements d'une région spécifique, utilisez la commande gcloud compute commitments list :
gcloud compute commitments list \
--regions=REGION \
--project=PROJECT_ID
Remplacez les éléments suivants :
REGION: région pour laquelle vous souhaitez afficher les engagements.PROJECT_ID: ID du projet.
Exemples
Par exemple, pour lister les engagements dans la région us-central1 à l'aide du projet project-list-example, exécutez la commande suivante :
gcloud compute commitments list \
--regions=us-central1 \
--project=project-list-example
REST
Pour lister les engagements dans une région spécifique, envoyez une requête GET à la méthode regionCommitments.list :
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
Pour lister les engagements dans toutes les régions de votre projet, envoyez une requête GET à la méthode regionCommitments.aggregatedList :
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments
Remplacez les éléments suivants :
PROJECT_ID: ID du projet pour lequel vous souhaitez afficher les engagements.REGION: région à partir de laquelle vous souhaitez afficher les engagements.
Afficher les détails d'un engagement spécifique
Vous pouvez afficher les propriétés détaillées d'un engagement, par exemple :
- État
- Forfait avec engagement
- Heures de début et de fin de l'engagement
- Paramètres de renouvellement automatique
- Types et quantités de ressources engagées
Vous pouvez afficher vos engagements à l'aide de la console Google Cloud , de la gcloud CLI ou de REST.
Console
Dans la console Google Cloud , accédez à la page Remises sur engagement d'utilisation. Accéder aux remises sur engagement d'utilisation
Sélectionnez l'onglet correspondant à la catégorie d'engagement que vous souhaitez afficher :
- Pour afficher les engagements pour les ressources matérielles, cliquez sur l'onglet Engagements matériels. Les engagements matériels couvrent les processeurs virtuels, la mémoire, les GPU, les disques SSD locaux et les nœuds à locataire unique.
- Pour afficher les engagements pour les licences logicielles premium, sélectionnez l'onglet Engagements de licences logicielles. Les engagements de licence couvrent les licences de système d'exploitation (OS), telles que SUSE Linux Enterprise Server (SLES), SLES pour SAP ou Red Hat Enterprise Linux (RHEL).
- Pour afficher les engagements pour les pools de stockage en réseau, sélectionnez l'onglet Engagements de stockage de blocs. Les engagements de stockage de blocs couvrent la capacité Exapool.
Pour afficher la page d'informations d'un engagement, cliquez sur son nom.
gcloud
Pour décrire un engagement spécifique, utilisez la commande gcloud compute commitments describe :
gcloud compute commitments describe COMMITMENT_NAME \
--region=REGION \
--project=PROJECT_ID
Remplacez les éléments suivants :
COMMITMENT_NAME: nom de votre engagement.REGION: région où se trouve l'engagement.PROJECT_ID: ID du projet.
Exemples
Les exemples suivants décrivent les engagements dans le projet myproject et la région us-central1.
Exemple 1 : Décrire un engagement matériel
Pour décrire un engagement matériel existant (example-hardware-commitment), exécutez la commande suivante :
gcloud compute commitments describe example-hardware-commitment \
--region=us-central1 \
--project=myproject
La commande renvoie les propriétés de votre engagement, semblables à ce qui suit :
autoRenew: true category: MACHINE creationTimestamp: '2025-05-15T09:30:00.000-07:00' endTimestamp: '2026-05-15T09:30:00.000-07:00' kind: compute#commitment name: example-hardware-commitment plan: TWELVE_MONTH region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1 resources: - amount: '4' type: VCPU - amount: '16384' type: MEMORY status: ACTIVE type: GENERAL_PURPOSE
Exemple 2 : Décrire un engagement de stockage de blocs
Pour décrire un engagement de stockage de blocs existant (example-block-storage-commitment), exécutez la commande gcloud beta compute commitments describe :
gcloud beta compute commitments describe example-block-storage-commitment \
--region=us-central1 \
--project=myproject
La commande renvoie les propriétés de votre engagement, en établissant la relation de l'engagement avec les Exapools, comme suit :
autoRenew: true category: PERSISTENT_DISK creationTimestamp: '2025-08-20T14:45:00.000-07:00' endTimestamp: '2026-08-20T14:45:00.000-07:00' kind: compute#commitment name: example-block-storage-commitment persistentDiskResources: - amount: '102400' dimensionType: CAPACITY_OPTIMIZED productType: HYPERDISK_EXAPOOL_BALANCED plan: TWELVE_MONTH region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1 status: ACTIVE
REST
Envoyez une requête GET à la méthode regionCommitments.get :
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
Remplacez les éléments suivants :
PROJECT_ID: ID de votre projet.REGION: région dans laquelle l'engagement a été souscrit.COMMITMENT_NAME: nom de votre engagement.
Exemples
Les exemples suivants récupèrent les détails d'un engagement dans le projet myproject et la région us-central1.
Exemple 1 : Décrire un engagement matériel
Pour récupérer les propriétés d'un engagement matériel (example-hardware-commitment), envoyez la requête GET suivante :
GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment
La réponse contient les propriétés de votre engagement matériel, comme dans l'exemple suivant :
{
"autoRenew": true,
"category": "MACHINE",
"creationTimestamp": "2025-05-15T09:30:00.000-07:00",
"endTimestamp": "2026-05-15T09:30:00.000-07:00",
"kind": "compute#commitment",
"name": "example-hardware-commitment",
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
"resources": [
{
"amount": "4",
"type": "VCPU"
},
{
"amount": "16384",
"type": "MEMORY"
}
],
"status": "ACTIVE",
"type": "GENERAL_PURPOSE"
}
Exemple 2 : Décrire un engagement de stockage de blocs
Pour récupérer les propriétés d'un engagement de stockage de blocs (example-block-storage-commitment), envoyez la requête GET suivante à la méthode beta regionCommitments.get :
GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment
La réponse contient les propriétés représentant votre capacité d'engagement de stockage de blocs, semblable au résultat JSON suivant :
{
"autoRenew": true,
"category": "PERSISTENT_DISK",
"creationTimestamp": "2025-08-20T14:45:00.000-07:00",
"endTimestamp": "2026-08-20T14:45:00.000-07:00",
"kind": "compute#commitment",
"name": "example-block-storage-commitment",
"persistentDiskResources": [
{
"amount": "102400",
"dimensionType": "CAPACITY_OPTIMIZED",
"productType": "HYPERDISK_EXAPOOL_BALANCED"
}
],
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
"status": "ACTIVE"
}