Ver las políticas de emplazamiento

En este documento se describe cómo ver las políticas de emplazamiento.

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

Antes de empezar

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

    Select the tab for how you plan to use the samples on this page:

    gcloud

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

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    2. Set a default region and zone.

    REST

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

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

      gcloud init

      Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

    Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Roles obligatorios

Para obtener los permisos que necesitas para ver las políticas de colocación, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de instancias de Compute (v. 1) (roles/compute.instanceAdmin.v1) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de emplazamiento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para ver las políticas de emplazamiento, se necesitan los siguientes permisos:

  • Para ver una lista de tus políticas de emplazamiento, sigue estos pasos: compute.resourcePolicies.list on the project
  • Para ver los detalles de una política de emplazamiento, sigue estos pasos: compute.resourcePolicies.get on the project

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

Ver las políticas de emplazamiento

Para ver las políticas de emplazamiento disponibles en un proyecto, selecciona uno de los métodos que se describen en este documento:

Ver una lista de sus políticas de emplazamiento

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

gcloud

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

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

El resultado debería ser 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

Para obtener más información sobre cómo usar expresiones de filtro para acotar una lista de recursos de Compute Engine, consulta el comando gcloud topic filters.

REST

Para ver una lista de políticas de emplazamiento que se encuentran en una región específica, haz una solicitud GET al método resourcePolicies.list. En la URL de solicitud, incluya el parámetro de consulta filter y asígnele el valor groupPlacementPolicy%3A*.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que quiere ver una lista de políticas de emplazamiento.

  • REGION: la región en la que se encuentran una o varias políticas de emplazamiento.

El resultado debería ser similar al siguiente:

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

Para obtener más información sobre cómo usar expresiones de filtro para acotar una lista de políticas de recursos mediante la codificación de URLs, consulta el parámetro de consulta filter.

Ver los detalles de una política de emplazamiento

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

gcloud

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

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

Haz los cambios siguientes:

  • POLICY_NAME: el nombre de una política de emplazamiento.

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

El resultado debería ser similar al siguiente:

  • Si está viendo los detalles de una política de posición compacta:

    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á viendo los detalles de una política de posición distribuida:

    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 emplazamiento, haz una solicitud GET al método resourcePolicies.get.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto en el que se encuentra la política de emplazamiento de la que quieres ver los detalles.

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

  • POLICY_NAME: el nombre de una política de emplazamiento.

El resultado debería ser similar al siguiente:

  • Si está viendo los detalles de una política de posición compacta:

    {
  "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á viendo los detalles de una política de posición distribuida:

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

Siguientes pasos