NetworkConfiguration Schema

This section of the service configuration file specifies Virtual Network and DNS values. These settings are optional for cloud services. If you don’t specify values in the Virtual Network elements sections of the service configuration file, the cloud service won’t be deployed into a Virtual Network.

For more information about the Windows Azure Service Configuration Schema, see Windows Azure Service Configuration Schema. For more information about the Windows Azure Service Definitions Schema, see Windows Azure Service Definition Schema.
For more information about Virtual Network, see Windows Azure Virtual Network. For more information about network configuration file elements, see Configure a Virtual Network Using Network Configuration Files and Virtual Network Schema.

The service configuration file includes these elements, described in detail, for Virtual Network:

Example:

<ServiceConfiguration …>
    <NetworkConfiguration>
    <Dns>
      <DnsServers>
        <DnsServer name="name1" IPAddress="IPAddress1" />
        <DnsServer name="name2" IPAddress="IPAddress2" />
        <DnsServer name="name3" IPAddress="IPAddress3" />
      </DnsServers>
    </Dns>
    <VirtualNetworkSite name="name1"/>
    <AddressAssignments>
      <InstanceAddress roleName="roleName1">
        <Subnets>
          <Subnet name="name1" />
          <Subnet name="name2" />
          <Subnet name="name3" />
        </Subnets>
      </InstanceAddress>
      <InstanceAddress roleName="roleName2">
        <Subnets>
          <Subnet name="name4" />
          <Subnet name="name5" />
          <Subnet name="name6" />
        </Subnets>
      </InstanceAddress>
      <InstanceAddress roleName="roleName3">
        <Subnets>
          <Subnet name="name7" />
          <Subnet name="name8" />
          <Subnet name="name9" />
        </Subnets>
      </InstanceAddress>
    </AddressAssignments>
  </NetworkConfiguration>
</ServiceConfiguration>

The Virtual Network file section for Network Configuration contains the following elements:

NetworkConfiguration Element

Dns Element

DnsServers Element

DnsServer Element

VirtualNetworkSite Element

AddressAssignments Element

InstanceAddress Element

Subnets Element

The NetworkConfiguration element is the top-level element for the network configuration section.

The NetworkConfiguration element describes the network configuration that the hosted service will be deployed into. The NetworkConfiguration element can contain zero or one Dns elements, zero or one VirtualNetworkSite elements, and zero or one AddressAssignment elements.

The NetworkConfiguration element is only available using the Windows Azure SDK version 1.7 or higher.

The Dns element specifies the DNS server(s) used by the hosted service. The Dns element can contain zero or one DnsServers elements.

The Dns element is only available using the Windows Azure SDK version 1.7 or higher.

DnsServers Element

This is the parent element to the DNSServer element. This element is Optional.

The DnsServers element specifies the DNS server(s) settings used by the hosted service. The DnsServers element can contain zero or one DnsServer elements.

The DnsServers element is only available using the Windows Azure SDK version 1.7 or higher.

Note
Specifying settings for the following DNS elements does not require Virtual Network.

DnsServer Element

The following table describes the attributes for the DnsServer element.

 

Attribute	Type	Description
name	string	Optional.
IPAddress	string	Required only if name is specified. Must be a valid IPv4 address.

The following table shows the attributes for the VirtualNetworkSite element. The setting for VirtualNetworkSite is used to specify the Virtual Network site that you want deploy your cloud service to. This setting does not create a Virtual Network Site. It references a site that has been previously defined in the network file for your Virtual Network. A cloud service can only be part of one Virtual Network. If you do not specify this setting, the cloud service will not be deployed to a Virtual Network.

The VirtualNetworkSite element is only available using the Windows Azure SDK version 1.7 or higher.

Important
Specifying settings for the following VirtualNetworkSite elements assumes that you have already created your Virtual Network. If you have not created a Virtual Network, either create one, or do not specify settings in this section.

This is the parent element to the InstanceAddress element.

The AddressAssignments element maps roles in the hosted service to subnets in the Virtual Network. If no addresses are explicitly assigned, each role instance is automatically assigned a private address. The AddressAssignments element can contain any number of InstanceAddress elements.

The AddressAssignments element is only available using the Windows Azure SDK version 1.7 or higher.

Important
Specifying settings for the following elements assumes that you have already created your Virtual Network. If you have not created a Virtual Network, either create one, or do not specify settings in this section.

InstanceAddress Element

Subnets Element

Concepts