Sustituir, quitar o eliminar políticas de emplazamiento

En este documento se describe cómo sustituir, retirar o eliminar políticas de emplazamiento.

Sustituir, quitar o eliminar políticas de emplazamiento es útil en los siguientes casos:

• Sustituye una política de colocación en una instancia de máquina virtual (VM) para mover la VM a una posición diferente con respecto a otras VMs.

• Quita una política de colocación de una VM cuando ya no te interese su posición relativa con respecto a otras VMs.

• Eliminar una política de emplazamiento cuando ya no la necesites.

Antes de empezar

• Consulta las restricciones de las políticas de emplazamiento.
• 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 sustituir, quitar o eliminar 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 sustituir, quitar o eliminar políticas de emplazamiento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

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

Sustituir una política de colocación en una VM

Antes de sustituir una política de colocación dispersa por una política de colocación compacta en una VM, asegúrate de que la VM utilice un tipo de máquina y una política de mantenimiento del host compatibles. Si necesitas actualizar la VM antes de sustituir su política de emplazamiento, haz una o ambas de las siguientes acciones:

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

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

Después de sustituir la política de colocación en una VM, debes reiniciar la VM para que la política de colocación recién aplicada surta efecto.

Para sustituir una política de colocación en una VM, selecciona una de las siguientes opciones:

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

Quitar una política de emplazamiento de una VM

Si quieres quitar una política de colocación dispersa con dos o más dominios de disponibilidad de una VM, puedes hacerlo sin detenerla. Si quieres quitar una política de colocación compacta o una política de colocación dispersa con un solo dominio de disponibilidad, primero debes detener la VM antes de quitar la política de colocación asociada.

Si quitas una política de colocación de una VM, no se verá afectada su ubicación física. Sin embargo, si la máquina virtual se está migrando en tiempo real, Compute Engine podría moverla a otra ubicación física.

Para quitar una política de colocación de una VM, selecciona 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 emplazamiento

Solo puedes eliminar una política de emplazamiento si no se ha aplicado a ningún recurso de Compute Engine. De lo contrario, no se podrá eliminar la política de emplazamiento. Si quiere eliminar una política de emplazamiento que se haya aplicado a uno o varios recursos de Compute Engine, haga una de las siguientes acciones:

• Si la política solo se aplica a las VMs y quieres conservarlas, haz lo siguiente:

  1. Elimina la política de asignación de las VMs tal como se describe en este documento.

  2. Elimina la política de emplazamiento tal como se describe en esta sección.

• De lo contrario, haz lo siguiente:

  1. Opcional: Quita la política de colocación de las VMs que quieras conservar tal como se describe en este documento.

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

     1. VMs

     2. Reservas

     3. Plantillas de instancia

  3. Elimina la política de emplazamiento tal como se describe en esta sección.

Para eliminar una política de emplazamiento, 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

Siguientes pasos

• Consulta cómo ver las políticas de emplazamiento.

• Consulta cómo hacer lo siguiente con una VM que especifica una política de asignación:

  • Consulta el estado de la máquina virtual.

  • Conéctate a la VM.