Cambiar el nombre de una VM

Cuando creas una instancia de máquina virtual, debes especificar un nombre. Después de crear la máquina virtual, puedes cambiarle el nombre. Cambiar el nombre de una VM puede ser útil en los siguientes casos:

  • Para representar mejor la carga de trabajo que se ejecuta en la VM.
  • Para hacer referencia al sistema operativo que se ejecuta en la VM.
  • Para cumplir las convenciones de nomenclatura que requiera tu organización.

Identificadores uniformes de recursos (URIs) de las VMs

Cambiar el nombre de una VM puede afectar a tus proyectos. En lugar de hacer referencia a los recursos de la máquina virtual por su nombre, puede hacerlo por su URI, que es permanente. El URI tiene el siguiente formato:

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

El URI incluye los siguientes valores:

  • PROJECT_ID: el ID del proyecto en el que se encuentra la VM.

  • ZONE: la zona en la que se encuentra la VM.

  • VM_ID: el ID de una máquina virtual. Para ver el ID de una VM, consulta los detalles de la VM y, a continuación, el valor del campo id.

Precios

Cambiar el nombre de una máquina virtual no afecta al importe que se te factura. Además, como en tu factura se muestran las máquinas virtuales según sus unidades de mantenimiento de stock (SKUs) y no por sus nombres, no verás los nombres de tus máquinas virtuales en la factura.

Limitaciones

Se aplican las siguientes limitaciones al cambiar el nombre de una máquina virtual:

  • Recursos con nombres automáticos:

    • Cuando cambias el nombre de una VM, no se actualizan los nombres de los recursos que se basaban en el nombre original de la VM. Por ejemplo, cuando creas una VM, el nombre del disco de arranque es el mismo que el de la VM. Si cambias el nombre de la VM, el nombre del disco de arranque no cambia.

  • Servidor DHCP:

    • Después de cambiar el nombre de una VM, el servidor DHCP responde a las solicitudes de DHCP con el nombre de host actualizado con el formato HOSTNAME.c.PROJECT_ID.internal para el DNS global y HOSTNAME.ZONE.c.PROJECT_ID.internal para el DNS de zona. Para obtener más información, consulta Tipos de nombres DNS internos.

  • ConsolaGoogle Cloud :

    • Debes actualizar el navegador para que la consola actualice el nombre de la VM. Google Cloud

  • Nombres de host:

    • Los nombres de host se modifican en Linux cuando cambias el nombre de la instancia. En Windows, el nombre de host no se actualiza, aunque reinicies la instancia.

    • Las VMs que tienen nombres de host personalizados no se actualizan.

    • Si cambias el nombre de host directamente en el host, no se modificará el nombre del recurso de la máquina virtual.

  • Grupos de instancias:

    • No puedes cambiar el nombre de las instancias que forman parte de un grupo de instancias no gestionado o gestionado.

  • Convenciones de nomenclatura:

  • Estados de las VMs:

    • Detén la instancia antes de cambiarle el nombre, ya que solo puedes cambiar el nombre de las VMs que estén en el estado TERMINATED. Por ejemplo, no puedes cambiar el nombre de una VM que esté en el estado SUSPENDED.

Antes de empezar

  • Revisa y, si procede, actualiza lo siguiente:
    • Grupos, gráficos y alertas de Cloud Monitoring: Monitoring busca coincidencias de cadenas y, cuando cambias el nombre de una VM, estas cadenas no se actualizan. Si cambias el nombre de una VM, actualiza tus reglas de monitorización para incluir las VMs con el nuevo nombre en tus informes.
    • URLs de la consola: si cambias el nombre de una VM, se modificará su URL de la consola. Si cambias el nombre de una máquina virtual, debes actualizar los enlaces, como los marcadores del navegador, que hagan referencia a la URL de la consola de la máquina virtual.
    • Vinculaciones de roles condicionales de Gestión de Identidades y Accesos (IAM): las vinculaciones de roles condicionales permiten conceder permisos en el nombre del recurso. Por ejemplo, IAM puede asignar un rol a un usuario si el nombre de una VM empieza por una cadena concreta. Estas vinculaciones no se actualizan cuando cambias el nombre de una VM, por lo que el acceso de un usuario al recurso de la VM puede verse afectado porque estás cambiando el conjunto de VMs al que se aplica el nombre con el prefijo. Si cambias el nombre de una máquina virtual, actualiza estos enlaces.
    • Caché del servicio DNS interno: el servicio DNS interno asigna nombres DNS internos a las VMs, en los que el nombre de host tiene el formato HOSTNAME.c.PROJECT_ID.internal para el DNS global y HOSTNAME.ZONE.c.PROJECT_ID.internal para el DNS de zona. Después de cambiar el nombre de una máquina virtual, estos nombres de host cambian. A continuación, el servicio DNS interno empieza a resolver el nuevo nombre de host y las solicitudes al nombre DNS anterior fallan. Si cambias el nombre de una máquina virtual, es posible que tengas que actualizar la caché de DNS para actualizar el nombre de host. Para obtener más información sobre los nombres de host DNS globales y zonales, consulta Tipos de nombres de DNS internos.
    • Consultas de metadatos: Después de cambiar el nombre de una VM, el servidor de metadatos informa del nuevo nombre. Si cambias el nombre de una VM, actualiza las secuencias de comandos o los programas que consulten el servidor de metadatos para que consulten el nuevo nombre de la VM.
    • Políticas de organización que restringen las direcciones IP externas: las restricciones contra las VMs que tienen una dirección IP externa hacen referencia al nombre de la VM. Cuando cambias el nombre de una VM, esta restricción no se actualiza. Si cambias el nombre de una máquina virtual, actualiza la política de organización de la IP externa con el nuevo nombre de la máquina virtual.
    • Nombres de host de SQL Server: si cambias el nombre de una VM que aloja SQL Server, debes actualizar el nombre de la VM de SQL Server. Para obtener más información, consulta el artículo Cambiar el nombre de un ordenador que aloja una instancia independiente de SQL Server.
  • 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:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    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 el permiso que necesitas para cambiar el nombre de una VM, 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 el 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 el permiso compute.instances.setName, que es necesario para cambiar el nombre de una máquina virtual.

También puedes obtener este permiso con roles personalizados u otros roles predefinidos.

Cambiar el nombre de una VM

Solo puedes cambiar el nombre de las VMs detenidas que tengan el estado TERMINATED.

Consola

Para cambiar el nombre de una máquina virtual, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. En la columna Nombre, haz clic en el nombre de la máquina virtual.

  3. Si aún no lo has hecho, haz clic en Detener para detener la VM. Si no aparece la opción Detener, haz clic en Más acciones > Detener.

  4. Haz clic en Editar.

  5. En el campo Nombre de instancia de VM, introduce un nombre para la VM.

  6. Haz clic en Guardar.

    El cambio de nombre de la máquina virtual puede tardar hasta un minuto en completarse. Si, después de cambiar el nombre de la máquina virtual, aparece un error que indica que no se puede encontrar la máquina virtual, actualiza el navegador. Google Cloud

  7. Si es necesario, reinicia la VM haciendo clic en Iniciar o Reanudar.

gcloud

Para cambiar el nombre de una máquina virtual, sigue estos pasos:

  1. Si aún no lo has hecho, detén la VM.

  2. Para cambiar el nombre de la VM, usa el comando gcloud compute instances set-name.

    gcloud compute instances set-name VM_NAME \
    --new-name=NEW_VM_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

    Haz los cambios siguientes:

    • VM_NAME: nombre de una VM.

    • NEW_VM_NAME: el nuevo nombre de la VM especificada.

    • PROJECT_ID: el ID del proyecto en el que se encuentra la VM.

    • ZONE: la zona en la que se encuentra la VM.

    El cambio de nombre de la máquina virtual puede tardar hasta un minuto en completarse.

  3. Si es necesario, reinicia la máquina virtual.

REST

Para cambiar el nombre de una máquina virtual, sigue estos pasos:

  1. Si aún no lo has hecho, detén la VM.

  2. Para cambiar el nombre de la VM, haz una solicitud POST al método instances.setName.

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

{
  "currentName": "VM_NAME",
  "name": "NEW_VM_NAME"
}

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto en el que se encuentra la VM.

    • ZONE: la zona en la que se encuentra la VM.

    • VM_NAME: nombre de una VM.

    • NEW_VM_NAME: el nuevo nombre de la VM especificada.

    El cambio de nombre de la máquina virtual puede tardar hasta un minuto en completarse. Para monitorizar el estado del cambio de nombre, sondea el ID de operación devuelto por la API rename. Para obtener más información, consulta Gestionar respuestas de la API.

  3. Si es necesario, reinicia la máquina virtual.

Siguientes pasos