Reemplazar, eliminar o eliminar políticas de ubicación

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Este documento describe cómo reemplazar, eliminar o eliminar políticas de ubicación.

Reemplazar, eliminar o eliminar políticas de ubicación resulta útil en los siguientes casos:

• Reemplace una política de ubicación en una instancia de máquina virtual (VM) para mover la VM a una posición diferente en relación con otras VM.

• Elimine una política de ubicación de una máquina virtual cuando ya no esté interesado en su posición en relación con otras máquinas virtuales.

• Elimine una política de ubicación cuando ya no la necesite.

Antes de comenzar

• Revise las restricciones para las políticas de ubicación.
• 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.

  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 reemplazar, eliminar o eliminar políticas de ubicación, solicite a su administrador que le otorgue la función de IAM Compute Instance Admin (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 reemplazar, eliminar o eliminar políticas de ubicación. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

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

Reemplazar una política de ubicación en una VM

Antes de reemplazar una política de ubicación extendida en una máquina virtual con una política de ubicación compacta, asegúrese de que la máquina virtual utilice un tipo de máquina compatible y una política de mantenimiento de host . Si necesita actualizar la máquina virtual antes de reemplazar su política de ubicación, realice una o ambas de las siguientes acciones:

• Cambie la política de mantenimiento del host de la VM .

• Cambie el tipo de máquina de la VM .

Después de reemplazar la política de ubicación en una máquina virtual, debe reiniciar la máquina virtual para que la política de ubicación recién aplicada entre en vigor.

Para reemplazar una política de ubicación en una máquina virtual, seleccione una de las siguientes opciones:

Para obtener más información sobre cómo actualizar las propiedades de una VM, consulte Actualizar las propiedades de la VM .

Eliminar una política de ubicación de una máquina virtual

Si desea eliminar una política de ubicación distribuida con dos o más dominios de disponibilidad de una máquina virtual, puede hacerlo sin detener la máquina virtual. Si desea eliminar una política de ubicación compacta o una política de ubicación distribuida con un solo dominio de disponibilidad, primero debe detener la máquina virtual antes de eliminar la política de ubicación adjunta a ella.

Eliminar una política de ubicación de una máquina virtual no afecta su ubicación física. Sin embargo, si la VM está migrando en vivo, Compute Engine podría moverla a una ubicación física diferente.

Para eliminar una política de ubicación de una máquina virtual, seleccione una de las siguientes opciones:

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

Eliminar una política de ubicación

Solo puedes eliminar una política de ubicación si no se aplica a ningún recurso de Compute Engine. De lo contrario, no se podrá eliminar la política de ubicación. Si desea eliminar una política de ubicación que se aplica a uno o más recursos de Compute Engine, realice una de las siguientes acciones:

• Si la política se aplica solo a las máquinas virtuales y desea conservarlas, haga lo siguiente:

  1. Elimine la política de ubicación de las máquinas virtuales como se describe en este documento.

  2. Elimine la política de ubicación como se describe en esta sección.

• De lo contrario, haga lo siguiente:

  1. Opcional: elimine la política de ubicación de cualquier máquina virtual que desee conservar como se describe en este documento.

  2. Elimine todos los demás recursos de Compute Engine a los que se aplica la política de ubicación en el siguiente orden:

     1. máquinas virtuales

     2. Reservas

     3. Plantillas de instancia

  3. Elimine la política de ubicación como se describe en esta sección.

Para eliminar una política de ubicación, seleccione una de las siguientes opciones:

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

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

¿Qué sigue?

• Obtenga información sobre cómo ver las políticas de ubicación .

• Aprenda a hacer lo siguiente con una máquina virtual que especifique una política de ubicación:

  • Ver el estado de la VM .

  • Conéctese a la máquina virtual .