Ver políticas de ubicación

Este documento describe cómo ver las políticas de ubicación.

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

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. 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.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Roles requeridos

Para obtener los permisos que necesita para ver las políticas de ubicación, solicite a su administrador que le otorgue el rol de IAM de Administrador de instancias informáticas (v1) ( roles/compute.instanceAdmin.v1 ) en su proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene los permisos necesarios para ver las políticas de ubicación. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

Se requieren los siguientes permisos para ver las políticas de ubicación:

  • Para ver una lista de sus políticas de ubicación: compute.resourcePolicies.list on the project
  • Para ver los detalles de una política de ubicación: compute.resourcePolicies.get on the project

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Ver sus políticas de ubicación

Para ver las políticas de ubicación que están disponibles en un proyecto, seleccione uno de los siguientes métodos descritos en este documento:

Ver una lista de sus políticas de ubicación

Para ver una lista de todas las políticas de ubicación de su proyecto, seleccione una de las siguientes opciones:

nube de gcloud

Para ver una lista de políticas de ubicación, usa el comando gcloud compute resource-policies list con el indicador --filter establecido en 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

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

DESCANSAR

Para ver una lista de políticas de ubicación ubicadas en una región específica, realice una solicitud GET al método resourcePolicies.list . En la URL de solicitud, incluya el parámetro de consulta filter y configúrelo en groupPlacementPolicy%3A* .

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto en el que desea ver una lista de políticas de ubicación.

  • REGION : la región donde se encuentran una o más políticas de colocación.

El resultado es 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 el uso de expresiones de filtro para limitar una lista de políticas de recursos usando codificación URL , consulte el parámetro de consulta filter .

Ver los detalles de una política de colocación

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

nube de gcloud

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

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

Reemplace lo siguiente:

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

  • REGION : la región donde se encuentra la política de colocación.

El resultado es similar al siguiente:

  • Si está viendo los detalles de una política de ubicació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 colocación de diferenciales:

    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

DESCANSAR

Para ver los detalles de una política de ubicación, realice una solicitud GET al método resourcePolicies.get .

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra la política de ubicación cuyos detalles desea ver.

  • REGION : la región donde se encuentra la política de colocación.

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

El resultado es similar al siguiente:

  • Si está viendo los detalles de una política de ubicació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 colocación de diferenciales: 

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

¿Qué sigue?