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
- Revisa las restricciones para las políticas de posición.
-
Si aún no lo hiciste, configura la autenticación.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud.
Para ejecutar un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
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. Para ver todas tus políticas de posición, consulta una lista de tus políticas de posición.
Para ver los detalles de configuración de una política de posición, consulta los detalles de una política de posición.
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.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.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.Obtén más información para reemplazar, quitar o borrar políticas de posición.
Obtén más información sobre cómo aplicar una política de posición:
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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Si deseas obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud.
Funciones obligatorias
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 Compute (v1) (
roles/compute.instanceAdmin.v1
) en el proyecto. Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.Este rol predefinido contiene los permisos necesarios para ver o borrar 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 o borrar las políticas de posición:
También puedes obtener estos permisos con roles personalizados o con 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 específico, elige 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 gcloud CLI y REST.
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 comogroupPlacementPolicy:*
.gcloud compute resource-policies list \ --filter="groupPlacementPolicy:*"
El resultado es similar al siguiente:
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étodoresourcePolicies.list
. En la URL de la solicitud, incluye el parámetro de búsquedafilter
y configúralo comogroupPlacementPolicy%3A*
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=groupPlacementPolicy%3A*
Reemplaza lo siguiente:
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 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
Puedes ver los detalles de una política de posición en un proyecto especificado con gcloud CLI y REST.
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:
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étodoresourcePolicies.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Reemplaza lo siguiente:
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
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-03 (UTC)
-