Viewing and modifying hostnames

To allow your role instances to be referenced by host name, you must set the value for the host name in the service configuration file for each role. You do that by adding the desired host name to the vmName attribute of the Role element. The value of the vmName attribute is used as a base for the host name of each role instance. For example, if vmName is webrole and there are three instances of that role, the host names of the instances will be webrole0, webrole1, and webrole2. You do not need to specify a host name for virtual machines in the configuration file, because the host name for a virtual machine is populated based on the virtual machine name. For more information about configuring a Microsoft Azure service, see Azure Service Configuration Schema (.cscfg File)

Viewing hostnames

You can view the host names of virtual machines and role instances in a cloud service by using any of the tools below.

Service configuration file

You can download the service configuration file for a deployed service from the Configure blade of the service in the Azure portal. You can then look for the vmName attribute for the Role name element to see the host name. Keep in mind that this host name is used as a base for the host name of each role instance. For example, if vmName is webrole and there are three instances of that role, the host names of the instances will be webrole0, webrole1, and webrole2.

Remote Desktop

After you enable Remote Desktop (Windows), Windows PowerShell remoting (Windows), or SSH (Linux and Windows) connections to your virtual machines or role instances, you can view the host name from an active Remote Desktop connection in various ways:

  • Type hostname at the command prompt or SSH terminal.
  • Type ipconfig /all at the command prompt (Windows only).
  • View the computer name in the system settings (Windows only).

Azure Service Management REST API

From a REST client, follow these instructions:

  1. Ensure that you have a client certificate to connect to the Azure portal. To obtain a client certificate, follow the steps presented in How to: Download and Import Publish Settings and Subscription Information.
  2. Set a header entry named x-ms-version with a value of 2013-11-01.
  3. Send a request in the following format: https://management.core.windows.net/<subscription-id>/services/hostedservices/<service-name>?embed-detail=true
  4. Look for the HostName element for each RoleInstance element.

Warning

You can also view the internal domain suffix for your cloud service from the REST call response by checking the InternalDnsSuffix element, or by running ipconfig /all from a command prompt in a Remote Desktop session (Windows), or by running cat /etc/resolv.conf from an SSH terminal (Linux).

Modifying a hostname

You can modify the host name for any virtual machine or role instance by uploading a modified service configuration file, or by renaming the computer from a Remote Desktop session.

Next steps

Name Resolution (DNS)

Azure Service Configuration Schema (.cscfg)

Azure Virtual Network Configuration Schema

Specify DNS settings using network configuration files