Create A VM Instance With A Custom Hostname
Create A VM Instance With A Custom Hostname
hostname
bookmark_border
LINUX WINDOWS
When you create a virtual machine (VM) instance, Google Cloud creates an internal DNS
name from the VM name. Unless you specify a custom hostname, Google Cloud uses the
automatically created internal DNS name as the hostname it provides to the VM.
You can create a VM with a custom hostname by specifying any fully qualified DNS name.
Custom hostnames are useful to maintain conventions or to support requirements for
applications that expect a particular hostname.
Even when you specify a custom hostname, Google Cloud creates the Compute Engine
internal DNS name. You can connect to your VM by using this automatically created internal
DNS record. The internal DNS record resolves to the internal DNS name and not the custom
hostname. With custom hostnames, you still need to create a corresponding DNS record in
the appropriate zone, for example, by using Cloud DNS.
Limitations
You must manually configure the DNS record for your custom hostname. Custom
hostnames are not resolved by the automatically created records provided by Compute
Engine internal DNS. You can use any of the following to host the DNS record for the
custom hostname:
a Cloud DNS public or private zone
any other public DNS name server
You cannot change a custom hostname after you have created the VM.
Naming convention
Custom hostnames must conform to RFC 1035 requirements for valid hostnames. To meet
these requirements, custom hostnames must meet the following format specifications:
The hostname contains at least two labels described as follows:
Each label contains regular expressions that includes only these characters: [a-
z]([-a-z0-9]*[a-z0-9])?.
my-host1234
my-host1234.example.com
Follow the API instructions to create an instance from an image or a snapshot, and specify
the hostname field in the request body.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"name": "VM_NAME",
"hostname": "HOST_NAME",
...
}
HOST_NAME: the fully qualified domain hostname that you want to assign
Consolegcloud
1. To view the custom hostname for your VM, go to the VM instances page.
Go to VM instances
2. Click the instance name to open the VM instance details page.
3. Review the Hostname section. The Hostname field is visible only if a custom
hostname is set.
What's next
Connect to Linux VMs.
Connect to Windows VMs.