Afficher les règles de charge de travail

Ce document explique comment afficher les règles relatives aux charges de travail.

Une fois que vous avez créé et appliqué des stratégies de charge de travail à des groupes d'instances gérés (MIG), vous pouvez afficher les détails de configuration de ces stratégies. L'affichage des règles de charge de travail vous permet d'obtenir une vue d'ensemble de toutes les règles de charge de travail de votre projet ou de vérifier les détails de configuration d'une règle spécifique.

Pour en savoir plus sur les exigences et les limites que vous appliquez lorsque vous créez des règles de charge de travail, consultez À propos des règles de charge de travail.

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 :
gcloud
1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :
  gcloud init
  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.
  
  Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
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 les autorisations nécessaires pour afficher les règles de charge de travail, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) 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 requises pour afficher les règles de charge de travail. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles de charge de travail :

Pour afficher la liste de vos règles de charge de travail : compute.resourcePolicies.list on the project
Pour afficher les détails d'une stratégie de charge de travail : compute.resourcePolicies.get on the project

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher vos règles de charge de travail

Pour afficher les règles de charge de travail qui existent dans votre projet, utilisez l'une des méthodes suivantes :

Pour afficher toutes les stratégies de charge de travail existantes dans un projet, affichez la liste de vos stratégies de charge de travail.
Pour afficher les détails de configuration d'une stratégie de charge de travail spécifique, affichez les détails d'une stratégie de charge de travail.

Afficher la liste de vos règles de charge de travail

Pour afficher la liste de toutes les règles de charge de travail de votre projet, sélectionnez l'une des options suivantes :

gcloud

Pour afficher la liste des stratégies de charge de travail, utilisez la commande gcloud compute resource-policies list avec l'option --filter définie sur workloadPolicy:*.

gcloud compute resource-policies list \
    --filter="workloadPolicy:*"

Le résultat ressemble à ce qui suit :

NAME: workload-policy-01
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T02:20:11.010-07:00

NAME: workload-policy-02
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2026-03-18T09:24:58.281-07:00

Pour en savoir plus sur l'utilisation d'expressions de filtre pour affiner la liste des ressources Compute Engine, consultez la commande gcloud topic filters.

REST

Pour afficher la liste des règles de charge de travail dans une région spécifique, envoyez une requête GET à la méthode resourcePolicies.list. Dans l'URL de la requête, incluez le paramètre de requête filter et définissez-le sur workloadPolicy%3A*.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=workloadPolicy%3A*

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel vous souhaitez afficher la liste des stratégies de charge de travail.
REGION : région dans laquelle se trouvent une ou plusieurs règles de charge de travail.

Le résultat ressemble à ce qui suit :

{
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "workloadPolicy": {
        "type": "HIGH_THROUGHPUT"
      },
      "kind": "compute#resourcePolicy",
      "id": "7592369487854686373",
      "creationTimestamp": "2026-03-18T02:20:11.010-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "workload-policy-01",
      "status": "READY"
    },
    {
      "workloadPolicy": {
        "type": "HIGH_THROUGHPUT",
        "maxTopologyDistance": "BLOCK"
      },
      "kind": "compute#resourcePolicy",
      "id": "5947350722329145141",
      "creationTimestamp": "2026-03-18T09:24:58.281-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-02",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "workload-policy-02",
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "ntWQ-oLKD9MWsxuxLOpT5pDF0To=/2MdxB9oc-_-zK6Z7g0OIqrUQ0BI="
}

Pour plus d'informations sur l'utilisation d'expressions de filtre pour affiner une liste de stratégies de ressources à l'aide de l'encodage d'URL, consultez le paramètre de requête filter.

Afficher les détails d'une règle de charge de travail

Pour afficher les détails d'une règle de charge de travail, sélectionnez l'une des options suivantes :

gcloud

Pour afficher les détails d'une règle de charge de travail, utilisez la commande gcloud compute resource-policies describe.

gcloud compute resource-policies describe POLICY_NAME \
    --region=REGION

Remplacez les éléments suivants :

POLICY_NAME : nom d'une stratégie de charge de travail existante.
REGION : région où se trouve la règle de charge de travail.

Le résultat ressemble à ce qui suit :

creationTimestamp: '2026-03-18T02:20:11.010-07:00'
id: '7592369487854686373'
kind: compute#resourcePolicy
name: workload-policy-01
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01
status: READY
workloadPolicy:
  type: HIGH_THROUGHPUT

REST

Pour afficher les détails d'une règle de charge de travail, envoyez une requête GET à la méthode resourcePolicies.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Remplacez les éléments suivants :

PROJECT_ID : ID du projet dans lequel se trouve la stratégie de charge de travail dont vous souhaitez afficher les détails.
REGION : région où se trouve la règle de charge de travail.
POLICY_NAME : nom d'une stratégie de charge de travail existante.

Le résultat ressemble à ce qui suit :

{
  "workloadPolicy": {
    "type": "HIGH_THROUGHPUT"
  },
  "kind": "compute#resourcePolicy",
  "id": "7592369487854686373",
  "creationTimestamp": "2026-03-18T02:20:11.010-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/workload-policy-01",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "workload-policy-01",
  "status": "READY"
}

Étapes suivantes

Découvrez comment remplacer, retirer ou supprimer des stratégies de charge de travail.

Afficher les règles de charge de travail Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

gcloud

REST

Rôles requis

Autorisations requises

Afficher vos règles de charge de travail

Afficher la liste de vos règles de charge de travail

gcloud

REST

Afficher les détails d'une règle de charge de travail

gcloud

REST

Étapes suivantes

Afficher les règles de charge de travail