Afficher les règles de charge de travail

Ce document explique comment afficher les règles de charge de travail.

Après avoir créé et appliqué des règles de charge de travail à des groupes d'instances gérés (MIG), vous pouvez afficher les détails de configuration de ces règles. 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 Google Cloud services et aux API. 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, initialisezla 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.

  • 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' Google Cloud authentification.

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 sur le projet
  • Pour afficher les détails d'une règle de charge de travail : compute.resourcePolicies.get sur le projet

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 :

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 règles de charge de travail, utilisez la gcloud compute resource-policies list commande 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 GET requête à la resourcePolicies.list méthode. 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 règles 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 filter paramètre de requête.

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 gcloud compute resource-policies describe commande.

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

Remplacez les éléments suivants :

  • POLICY_NAME: nom d'une règle de charge de travail existante.

  • REGION : région dans laquelle 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 GET requête à la resourcePolicies.get méthode.

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 règle de charge de travail dont vous souhaitez afficher les détails.

  • REGION : région dans laquelle se trouve la règle de charge de travail.

  • POLICY_NAME: nom d'une règle 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"
}

Étape suivante