Cambiar el nombre de una VM

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

  • 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 con las convenciones de nombres que requiera tu organización

Identificadores de recursos uniformes (URI) de VM

Cambiar el nombre de una VM puede afectar tus proyectos. En vez de hacer referencia a los recursos de VM por su nombre, puedes usar el 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 donde se ubica la VM.

  • VM_ID: el ID de una VM existente. Para ver el ID de una VM existente, consulta los detalles de la VM y, luego, el valor del campo id.

Precios

Si cambias el nombre de una VM, no cambiará el importe que se te factura. Además, dado que tu factura muestra las VMs de acuerdo con los códigos de artículo (SKU) y no con sus nombres, no verás los nombres de las VMs en tu factura.

Limitaciones

Se aplican limitaciones a los siguientes elementos cuando se cambia el nombre de una VM:

  • Recursos con nombres automáticos:

    • Cuando cambias el nombre de una VM, no se actualizan los nombres de los recursos basados 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 DHCP con el nombre de host actualizado en el formato HOSTNAME.c.PROJECT_ID.internal para DNS global o HOSTNAME.ZONE.c.PROJECT_ID.internal para DNS zonal. Si quieres obtener más información, consulta Tipos de nombres de DNS internos.

  • Consola de Google Cloud:

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

  • Nombres de host:

    • Los nombres de host se modifican cuando cambias el nombre de la instancia. En Windows, es posible que las actualizaciones de nombres de host requieran un reinicio.

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

    • El cambio del nombre de host directamente en él no afecta el nombre del recurso de VM.

  • Grupos de instancias administrados:

    • No puedes cambiar el nombre de las instancias que se encuentran en grupos de instancias administrados (MIG) porque estas instancias heredan de forma automática e irreversible sus nombres de la propiedad base instance name de su MIG sin estado.

  • Convenciones de nombres:

  • Estados de la VM:

    • Detén la instancia antes de cambiarle el nombre porque sólo 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 comenzar

  • Revise y, si corresponde, actualice lo siguiente:
    • Grupos, gráficos y alertas de Cloud Monitoring: Monitoring hace coincidir las strings y, cuando cambias el nombre de una VM, esas strings no se actualizan. Si cambias el nombre de una VM, actualiza tus reglas de Monitoring para incluir las VM con nombres nuevos en tus informes.
    • URL de la consola: Si cambias el nombre de una VM, se cambiarás su URL de consola. Si cambias el nombre de una VM, debes actualizar los vínculos, como los favoritos del navegador, que hagan referencia a la URL de la consola de la VM.
    • Vinculaciones de roles condicionales de Identity and Access Management (IAM): las vinculaciones de roles condicionales son compatibles con la concesión de permisos en nombre del recurso. Por ejemplo, IAM puede otorgar un rol a un usuario si el nombre de una VM comienza con una string particular. Estas vinculaciones no se actualizan cuando cambias el nombre de una VM, por lo que podrías afectar el acceso de un usuario al recurso de la VM debido a que modificas el conjunto de VMs al que se aplica el nombre con prefijo. Si cambias el nombre de una VM, actualiza estas vinculaciones.
    • Caché de servicio DNS interno: El servicio DNS interno asigna nombres de DNS internos a las VM, en los que el nombre de host tiene el formato HOSTNAME.c.PROJECT_ID.internal (para DNS global) y HOSTNAME.ZONE.c.PROJECT_ID.internal (para DNS zonal). Después de cambiar el nombre de una VM, cambiarán esos nombres de host. Luego, el servicio de DNS interno comenzará a resolver el nombre de host nuevo y las solicitudes al nombre de DNS anterior fallarán. Si cambias el nombre de una VM, es posible que debas actualizar la caché de DNS para actualizar el nombre de host. Si quieres obtener más información sobre los nombres de host de 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 el nombre nuevo. Si cambias el nombre de una VM, actualiza cualquier secuencia de comandos o programa que consulte el servidor de metadatos para que pueda consultar el nombre nuevo de la VM.
    • Políticas de la organización que restringen las direcciones IP externas: las restricciones a 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 VM, actualiza la política de la organización de la IP externa con el nombre nuevo de la VM.
    • 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 Cambia el nombre de una computadora que aloja una instancia independiente de SQL Server.
  • Configura la autenticación si aún no lo hiciste. 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:

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    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.

        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.

Roles obligatorios

Para obtener el permiso que necesitas para cambiar el nombre de una VM, 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. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso compute.instances.setName, que se requiere para cambiar el nombre de una VM.

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

Cambiar el nombre de una VM

Solo puedes cambiar el nombre de las VMs detenidas que se encuentran en el estado TERMINATED.

Console

Para cambiar el nombre de una VM, haz lo siguiente:

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

  3. Si aún no lo hiciste, detén la VM de la siguiente manera:

    1. Haz clic en Detener.

    2. Para confirmar la acción, haz clic en Detener.

      Detener la VM puede tardar hasta 90 segundos.

  4. Haz clic en  Cambiar.

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

  6. Haz clic en Guardar.

    El cambio de nombre de la VM puede tomar hasta un minuto en completarse. Si, después de cambiar el nombre de la VM, recibes un error que indica que Google Cloud no puede encontrar la VM, actualiza el navegador.

  7. Si es necesario, haz clic en Iniciar/Reanudar para reiniciar la VM.

gcloud

Para cambiar el nombre de una VM, haz lo siguiente:

  1. Si aún no lo hiciste, 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

    Reemplaza lo siguiente:

    • VM_NAME: el nombre de una VM existente.

    • NEW_VM_NAME: El nombre nuevo para la VM especificada.

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

    • ZONE: la zona donde se ubica la VM.

    El cambio de nombre de la VM puede tomar hasta un minuto en completarse.

  3. Si es necesario, reinicia la VM.

REST

Para cambiar el nombre de una VM, haz lo siguiente:

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

  2. Para cambiar el nombre de la VM, realiza 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"
}

    Reemplaza lo siguiente:

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

    • ZONE: la zona donde se ubica la VM.

    • VM_NAME: el nombre de una VM existente.

    • NEW_VM_NAME: El nombre nuevo para la VM especificada.

    El cambio de nombre de la VM puede tomar hasta un minuto en completarse. Para supervisar el estado del cambio de nombre, sondea el ID de operación que devolvió la API de Rename. Para obtener más información, consulta Controla las respuestas de la API.

  3. Si es necesario, reinicia la VM.

Próximos pasos