Visualiza las políticas de posición

En este documento, se explica cómo ver las políticas de posición. Específicamente, explica cómo ver las políticas de posición disponibles en un proyecto especificado o ver los detalles de configuración de una de estas políticas.

Antes de comenzar

Roles obligatorios

Si deseas obtener los permisos que necesitas para ver o borrar las políticas de posición, pídele a tu administrador que te otorgue el rol de IAM Administrador de instancias de procesamiento (v1) (roles/compute.instanceAdmin.v1) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

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

Permisos necesarios

Se requieren los siguientes permisos para ver o borrar políticas de posición:

  • Para ver una lista de las políticas de posición, ve a compute.resourcePolicies.list en el proyecto.
  • Para ver los detalles de una política de posición: compute.resourcePolicies.get en el proyecto.

También puedes obtener estos permisos con funciones personalizadas o con otras funciones predefinidas

  • Configura la autenticación.

    Selecciona la pestaña sobre cómo planeas usar las muestras en esta página:

    Consola

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud, no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

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

    REST

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

      Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando: 

      gcloud init

    • Visualiza tus políticas de posición

    Para ver las políticas de posición que están disponibles en un proyecto específico, selecciona uno de los siguientes métodos:

    Visualiza una lista de tus políticas de posición

    Puedes ver una lista de todas las políticas de posición en un proyecto específico con la CLI de gcloud y la API de Compute Engine.

    gcloud

    Para ver una lista de políticas de posición, usa el comando gcloud compute resource-policies list con la marca --filter establecida en groupPlacementPolicy:*.

    gcloud compute resource-policies list \
    --filter="groupPlacementPolicy:*" \
    --project=PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto en el que deseas ver una lista de políticas de posición. Si omites esta marca, su valor se establece en el ID del proyecto actual.

    El resultado es similar a este:

    NAME: policy-1
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:10:51.958-08:00

NAME: policy-2
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:11:16.826-08: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 posición que se encuentran en una región específica, realiza un solicitud GET al método resourcePolicies.list con el filter parámetro de consulta configurado como groupPlacementPolicy%3A*.

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

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto en el que deseas ver una lista de las políticas de posición.

    • REGION: Es la región en la que se encuentran una o más políticas de posición.

    El resultado es similar a este:

    {
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "637231102400797797",
      "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-1",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-1",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "1228789480840827204",
      "creationTimestamp": "2023-07-15T02:10:51.958-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-2",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-2",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 2
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

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

    Visualiza los detalles de una política de posición

    Puedes ver los detalles de una política de posición en un proyecto específico mediante la CLI de gcloud y la API de Compute Engine.

    gcloud

    Para ver los detalles de una política de posición, usa el comando gcloud compute resource-policies describe:

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

    Reemplaza lo siguiente:

    • PROJECT_ID: El ID del proyecto en el que se encuentra la política de posición de la que deseas ver los detalles.

    • POLICY_NAME: Es el nombre de una política de posición existente.

    • REGION: la región en la que se encuentra la política de posición.

    El resultado es similar a este:

    creationTimestamp: '2023-07-15T02:10:51.958-08:00'
groupPlacementPolicy:
  availabilityDomainCount: 2
id: '1228789480840827204'
kind: compute#resourcePolicy
name: pp2
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/example-policy
status: READY

    REST

    Para ver los detalles de una política de posición, 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: El ID del proyecto en el que se encuentra la política de posición de la que deseas ver los detalles.

    • REGION: la región en la que se encuentra la política de posición.

    • POLICY_NAME: Es el nombre de una política de posición existente.

    El resultado es similar a este:

    {
  "kind": "compute#resourcePolicy",
  "id": "637231102400797797",
  "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "policy-1",
  "groupPlacementPolicy": {
      "availabilityDomainCount": 2
  },
  "status": "READY"
}

    Próximos pasos