Cambiar el nombre de una máquina virtual

Cuando crea una instancia de máquina virtual (VM), debe especificar un nombre. Después de crear la VM, opcionalmente puede cambiarle el nombre. Cambiar el nombre de una máquina virtual puede resultar útil en los siguientes escenarios:

  • 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.
  • Cumplir con las convenciones de nomenclatura requeridas por su organización.

Identificadores uniformes de recursos (URI) de VM

Cambiar el nombre de una VM puede afectar sus proyectos. En lugar de hacer referencia a los recursos de VM por su nombre, puede hacer referencia a ellos 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 donde se encuentra la VM.

  • ZONE : la zona donde se encuentra la VM.

  • VM_ID : el ID de una máquina virtual existente. Para ver el ID de una máquina virtual existente, vea los detalles de la máquina virtual y luego vea el valor del campo id .

Precios

Cambiar el nombre de una máquina virtual no cambia el monto que se le factura. Además, debido a que su factura muestra las máquinas virtuales según sus unidades de mantenimiento de existencias (SKU) y no sus nombres, no verá los nombres de sus máquinas virtuales en su factura.

Limitaciones

Se aplican limitaciones a lo siguiente al cambiar el nombre de una máquina virtual:

  • Recursos nombrados automáticamente:

    • Cuando cambia el nombre de una máquina virtual, los nombres de los recursos que se basaron en el nombre de la máquina virtual original no se actualizan. Por ejemplo, cuando crea una VM, el nombre del disco de arranque es el mismo que el nombre de la VM. Si cambia 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 con el formato HOSTNAME .c. PROJECT_ID .internal para DNS global y HOSTNAME . ZONE .c. PROJECT_ID .internal para DNS zonal. Para obtener más información, consulte Tipos de nombres DNS internos .

  • Consola de Google Cloud:

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

  • Nombres de host:

    • Los nombres de host se modifican cuando cambia el nombre de la instancia. En Windows, las actualizaciones del nombre de host pueden requerir un reinicio.

    • Las máquinas virtuales que tienen nombres de host personalizados no se actualizan.

    • Cambiar el nombre de host directamente en el host no afecta el nombre del recurso de VM.

  • Grupos de instancias administrados:

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

  • Convenciones de nomenclatura:

    • No puede cambiar el nombre de una máquina virtual con un nombre que ya esté en uso por otra máquina virtual en el proyecto.

    • Los nombres de las máquinas virtuales deben cumplir las convenciones de nomenclatura de recursos .

  • Estados de la máquina virtual:

    • Detenga la instancia antes de cambiarle el nombre porque solo puede cambiar el nombre de las máquinas virtuales que se encuentran en el estado TERMINATED . Por ejemplo, no puede cambiar el nombre de una máquina virtual que esté en estado SUSPENDED .

Antes de comenzar

  • Revise y, si corresponde, actualice lo siguiente:
    • Grupos, gráficos y alertas de Cloud Monitoring: la supervisión coincide con cadenas y, cuando cambia el nombre de una máquina virtual, estas cadenas no se actualizan. Si cambia el nombre de una máquina virtual, actualice sus reglas de monitoreo para incluir las máquinas virtuales cuyo nombre cambió en sus informes.
    • URL de consola : al cambiar el nombre de una máquina virtual se cambia la URL de su consola. Si cambia el nombre de una máquina virtual, debe actualizar los enlaces, como los marcadores del navegador que hacen referencia a la URL de la consola de la máquina virtual.
    • Enlaces de roles condicionales de gestión de identidad y acceso (IAM) : los enlaces de roles condicionales admiten la concesión de permisos sobre el nombre del recurso. Por ejemplo, IAM podría otorgar una función a un usuario si el nombre de una VM comienza con una cadena particular. Estos enlaces no se actualizan cuando cambia el nombre de una VM, por lo que el acceso de un usuario al recurso de VM podría verse afectado porque está cambiando el conjunto de VM al que se aplica el nombre con prefijo. Si cambia el nombre de una VM, actualice estos enlaces.
    • Caché del servicio DNS interno : el servicio DNS interno asigna nombres DNS internos a las máquinas virtuales, en las 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, estos nombres de host cambian. Luego, el servicio DNS interno comienza a resolver el nuevo nombre de host y las solicitudes al nombre DNS anterior fallan. Si cambia el nombre de una VM, es posible que deba actualizar su caché DNS para actualizar el nombre de host. Para obtener más información sobre los nombres de host DNS globales y DNS zonales, consulte Tipos de nombres DNS internos .
    • Consultas de metadatos : después de cambiar el nombre de una máquina virtual, el servidor de metadatos informa el nuevo nombre. Si cambia el nombre de una máquina virtual, actualice todos los scripts o programas que consulten el servidor de metadatos para que consulten el nuevo nombre de la máquina virtual.
    • Políticas de organización que restringen direcciones IP externas : las restricciones contra las máquinas virtuales que tienen una dirección IP externa hacen referencia al nombre de la máquina virtual. Cuando cambia el nombre de una máquina virtual, esta restricción no se actualiza. Si cambia el nombre de una máquina virtual, actualice la política de organización de IP externa con el nuevo nombre de la máquina virtual.
    • Nombres de host de SQL Server : si cambia el nombre de una máquina virtual que aloja SQL Server, debe actualizar el nombre de la máquina virtual del servidor SQL. Para obtener más información, consulte Cambiar el nombre de una computadora que hospeda una instancia independiente de SQL Server .
  • 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:

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

      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.

        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 el permiso que necesita para cambiar el nombre de una máquina virtual, solicite a su administrador que le otorgue el rol de IAM de Administrador de instancia informática (v1) ( roles/compute.instanceAdmin.v1 ) en el 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 el permiso compute.instances.setName , que es necesario para cambiar el nombre de una máquina virtual.

Es posible que también pueda obtener este permiso con roles personalizados u otros roles predefinidos .

Cambiar el nombre de una máquina virtual

Solo puede cambiar el nombre de las máquinas virtuales detenidas que se encuentren en estado TERMINATED .

Consola

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

  1. En la consola de Google Cloud, vaya a la página de instancias de VM .

    Ir a instancias de VM

  2. En la columna Nombre , haga clic en el nombre de la VM.

  3. Si aún no lo ha hecho, detenga la máquina virtual haciendo lo siguiente:

    1. Haga clic Detener .

    2. Para confirmar, haga clic en Detener .

  4. Haga clic en Editar .

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

  6. Haga clic en Guardar .

    Cambiar el nombre de la máquina virtual puede tardar hasta un minuto en completarse. Si, después de cambiar el nombre de la VM, aparece un error que Google Cloud no puede encontrar la VM, actualice su navegador.

  7. Si es necesario, reinicie la máquina virtual haciendo clic en Inicio/Reanudar .

nube de gcloud

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

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

    Reemplace lo siguiente:

    • VM_NAME : el nombre de una VM existente.

    • NEW_VM_NAME : el nuevo nombre para la VM especificada.

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

    • ZONE : la zona donde se encuentra la VM.

    Cambiar el nombre de la máquina virtual puede tardar hasta un minuto en completarse.

  3. Si es necesario, reinicie la VM .

DESCANSAR

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

  1. Si aún no lo ha hecho, detenga la VM .

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

    Reemplace lo siguiente:

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

    • ZONE : la zona donde se encuentra la VM.

    • VM_NAME : el nombre de una VM existente.

    • NEW_VM_NAME : el nuevo nombre para la VM especificada.

    Cambiar el nombre de la máquina virtual puede tardar hasta un minuto en completarse. Para monitorear el estado del cambio de nombre, sondee el ID de operación devuelto por la API de cambio de nombre. Para obtener más información, consulte Manejo de respuestas de API .

  3. Si es necesario, reinicie la VM .

¿Qué sigue?