Cómo ver las políticas de cargas de trabajo

En este documento, se explica cómo ver las políticas de cargas de trabajo.

Después de crear y aplicar políticas de cargas de trabajo a grupos de instancias administrados (MIG), puedes ver los detalles de configuración de esas políticas. Ver las políticas de carga de trabajo te ayuda a obtener una descripción general de todas las políticas de carga de trabajo de tu proyecto o a verificar los detalles de configuración de una política específica.

Para obtener más información sobre los requisitos y las limitaciones que se aplican cuando creas políticas de cargas de trabajo, consulta Acerca de las políticas de cargas de trabajo.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Cloud de Confiance by S3NS . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    gcloud

    1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init
  • Configura una región y una zona predeterminadas.

    • REST

    Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

      Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Cloud de Confiance .

Roles obligatorios

Para obtener los permisos que necesitas para ver las políticas de cargas de trabajo, pídele a tu administrador que te otorgue el rol de IAM Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de cargas de trabajo. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de cargas de trabajo:

  • Para ver una lista de tus políticas de carga de trabajo, haz lo siguiente: compute.resourcePolicies.list on the project
  • Para ver los detalles de una política de carga de trabajo, haz lo siguiente: compute.resourcePolicies.get on the project

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Consulta tus políticas de cargas de trabajo

Para ver las políticas de cargas de trabajo que existen en tu proyecto, usa uno de los siguientes métodos:

Consulta una lista de tus políticas de cargas de trabajo

Para ver una lista de todas las políticas de cargas de trabajo de tu proyecto, selecciona una de las siguientes opciones:

gcloud

Para ver una lista de las políticas de cargas de trabajo, usa el comando gcloud compute resource-policies list con la marca --filter establecida como workloadPolicy:*.

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

El resultado es similar a lo siguiente:

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

Si quieres obtener más información sobre el uso de las expresiones de filtro para limitar una lista de recursos de Compute Engine, consulta el comando gcloud topic filters.

REST

Para ver una lista de las políticas de carga de trabajo en una región específica, realiza una solicitud GET al método resourcePolicies.list. En la URL de la solicitud, incluye el parámetro de búsqueda filter y configúralo como workloadPolicy%3A*.

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto en el que deseas ver una lista de las políticas de cargas de trabajo.

  • REGION: Es la región en la que existen una o más políticas de cargas de trabajo.

El resultado es similar a lo siguiente:

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

Si deseas obtener más información sobre el uso de expresiones de filtro para limitar una lista de políticas de recursos a través de la codificación de URL, consulta el parámetro de consulta filter.

Visualiza los detalles de una política de cargas de trabajo

Para ver los detalles de una política de carga de trabajo, selecciona una de las siguientes opciones:

gcloud

Para ver los detalles de una política de cargas de trabajo, usa el comando gcloud compute resource-policies describe.

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de una política de carga de trabajo existente.

  • REGION: Es la región en la que existe la política de carga de trabajo.

El resultado es similar a lo siguiente:

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

Para ver los detalles de una política de carga de trabajo, realiza una solicitud GET al método resourcePolicies.get.

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la política de cargas de trabajo de la que deseas ver los detalles.

  • REGION: Es la región en la que existe la política de carga de trabajo.

  • POLICY_NAME: Es el nombre de una política de carga de trabajo existente.

El resultado es similar a lo siguiente:

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

¿Qué sigue?