Visualiza las políticas de posición

En este documento, se describe cómo ver las políticas de posición.

Ver las políticas de posición es útil para ver todas las políticas de posición existentes en un proyecto o verificar los detalles de configuración de una política de posición específica.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. 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 según cómo planeas usar las muestras en esta página:

    gcloud

    1. Instala la Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad (IdP) externo, primero debes acceder a gcloud CLI con tu identidad federada.

  • 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 la Google Cloud CLI.

      Si usas un proveedor de identidad (IdP) externo, primero debes acceder 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. Google Cloud

Roles obligatorios

Si deseas obtener los permisos que necesitas para ver las políticas de posición, 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 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 las políticas de posición:

  • Para ver una lista de tus políticas de posición: 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 roles personalizados o otros roles predefinidos.

Visualiza tus políticas de posición

Para ver las políticas de posición que están disponibles en un proyecto, elige uno de los siguientes métodos que se describen en este documento:

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

Para ver una lista de todas las políticas de posición de tu proyecto, selecciona una de las siguientes opciones:

gcloud

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

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

El resultado es similar al siguiente:

NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00

NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-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 posición que se encuentran en una región específica, realiza un 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 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: 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": "5587673659722509355",
      "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-compact-policy",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "5970772604948130963",
      "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-spread-policy",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 5
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

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 posición

Para ver los detalles de una política de posición, selecciona una de las siguientes opciones:

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 \
    --region=REGION

Reemplaza lo siguiente:

  • 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:

  • Si estás viendo los detalles de una política de posición compacta, haz lo siguiente:

    creationTimestamp: '2024-05-09T02:09:24.588-07:00'
groupPlacementPolicy:
  collocation: COLLOCATED
id: '5587673659722509355'
kind: compute#resourcePolicy
name: example-compact-policy
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-compact-policy
status: READY

  • Si estás viendo los detalles de una política de posición distribuida, haz lo siguiente:

    creationTimestamp: '2024-05-09T02:08:13.404-07:00'
groupPlacementPolicy:
  availabilityDomainCount: 5
id: '5970772604948130963'
kind: compute#resourcePolicy
name: example-spread-policy
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-spread-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:

  • Si estás viendo los detalles de una política de posición compacta, haz lo siguiente:

    {
  "kind": "compute#resourcePolicy",
  "id": "5587673659722509355",
  "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-compact-policy",
  "groupPlacementPolicy": {
    "collocation": "COLLOCATED"
  },
  "status": "READY"
}

  • Si estás viendo los detalles de una política de posición distribuida, haz lo siguiente:

    {
  "kind": "compute#resourcePolicy",
  "id": "5970772604948130963",
  "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "example-spread-policy",
  "groupPlacementPolicy": {
    "availabilityDomainCount": 5
  },
  "status": "READY"
}

Próximos pasos