Visualizzare le policy workload

Questo documento spiega come visualizzare le policy del workload.

Dopo aver creato e applicato le policy del workload ai gruppi di istanze gestite (MIG), puoi visualizzare i dettagli di configurazione di queste policy. La visualizzazione delle policy del workload ti aiuta a ottenere una panoramica di tutte le policy del workload nel tuo progetto o a verificare i dettagli di configurazione di una policy specifica.

Per scoprire di più sui requisiti e sulle limitazioni che applichi quando crei le policy del workload, consulta Informazioni sulle policy del workload.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Cloud de Confiance by S3NS . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa alla modalità di utilizzo degli esempi in questa pagina:

    gcloud

    1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init
  • Imposta una regione e una zona predefinite.

    • REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella Cloud de Confiance documentazione sull'autenticazione di.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le policy del workload, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy del workload. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy del workload sono necessarie le seguenti autorizzazioni:

  • Per visualizzare un elenco delle policy del workload: compute.resourcePolicies.list on the project
  • Per visualizzare i dettagli di una policy del workload: compute.resourcePolicies.get on the project

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Visualizza le policy del workload

Per visualizzare le policy del workload esistenti nel tuo progetto, utilizza uno dei seguenti metodi:

Visualizza un elenco delle policy del workload

Per visualizzare un elenco di tutte le policy del workload nel tuo progetto, seleziona una delle seguenti opzioni:

gcloud

Per visualizzare un elenco delle policy del workload, utilizza il gcloud compute resource-policies list comando con il --filter flag impostato su workloadPolicy:*.

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

L'output è simile al seguente:

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

Per saperne di più sull'utilizzo delle espressioni di filtro per restringere un elenco di risorse di Compute Engine, consulta il gcloud topic filters comando.

REST

Per visualizzare un elenco delle policy del workload in una regione specifica, effettua una GET richiesta al resourcePolicies.list metodo. Nell'URL della richiesta, includi il parametro di query filter e impostalo su workloadPolicy%3A*.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi visualizzare un elenco delle policy del workload.

  • REGION: la regione in cui esistono una o più policy del workload.

L'output è simile al seguente:

{
  "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="
}

Per saperne di più sull'utilizzo delle espressioni di filtro per restringere un elenco di policy delle risorse utilizzando la codifica URL, consulta il filter parametro di query.

Visualizza i dettagli di una policy del workload

Per visualizzare i dettagli di una policy del workload, seleziona una delle seguenti opzioni:

gcloud

Per visualizzare i dettagli di una policy del workload, utilizza il gcloud compute resource-policies describe comando.

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

Sostituisci quanto segue:

  • POLICY_NAME: il nome di una policy del workload esistente.

  • REGION: la regione in cui esiste la policy del workload.

L'output è simile al seguente:

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

Per visualizzare i dettagli di una policy del workload, effettua una GET richiesta al resourcePolicies.get metodo.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui esiste la policy del workload di cui vuoi visualizzare i dettagli.

  • REGION: la regione in cui esiste la policy del workload.

  • POLICY_NAME: il nome di una policy del workload esistente.

L'output è simile al seguente:

{
  "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"
}

Passaggi successivi