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 campoid
.
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 oHOSTNAME.ZONE.c.PROJECT_ID.internal
para DNS zonal. Si quieres obtener más información, consulta Tipos de nombres de DNS internos.
- 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
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.
- 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
Convenciones de nombres:
No puedes cambiar el nombre de una VM con un nombre que ya esté en uso en el proyecto.
Los nombres de las VMs deben cumplir con las convenciones de nomenclatura de recursos.
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 estadoSUSPENDED
.
- 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
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) yHOSTNAME.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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
En la consola de Google Cloud, ve a la página Instancias de VM.
En la columna Nombre, haz clic en el nombre de la VM.
Si aún no lo hiciste, detén la VM de la siguiente manera:
Haz clic en
Detener.Para confirmar la acción, haz clic en Detener.
Detener la VM puede tardar hasta 90 segundos.
Haz clic en
Cambiar.En el campo Nombre de instancia de VM, ingresa un nombre nuevo para la VM.
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.
Si es necesario, haz clic en
Iniciar/Reanudar para reiniciar la VM.Si aún no lo hiciste, detén la VM.
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.
Si es necesario, reinicia la VM.
Si aún no lo hiciste, detén la VM.
Para cambiar el nombre de la VM, realiza una solicitud
POST
al métodoinstances.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.
Si es necesario, reinicia la VM.
Aprende a ver los detalles de la VM.
Obtén más información para detener o iniciar una VM.
Obtén más información para suspender o reanudar una VM.
Obtén más información sobre el ciclo de vida de las VMs.
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.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:
gcloud
Para cambiar el nombre de una VM, haz lo siguiente:
REST
Para cambiar el nombre de una VM, haz lo siguiente:
Próximos pasos
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-08-15 (UTC)
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema de traducción" },{ "type": "thumb-down", "id": "otherDown", "label":"Otro" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Fácil de comprender" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Resolvió mi problema" },{ "type": "thumb-up", "id": "otherUp", "label":"Otro" }] -