Exportar (0) Imprimir
Expandir todo

Establecer configuración de red

Actualizado: diciembre de 2013

La operación Set Network Configuration configura de forma asincrónica la red virtual.

La solicitud Set Network Configuration se especifica como sigue. Reemplazar <subscription-id> con el identificador de suscripción:

 

Método URI de solicitud Versión de HTTP

PUT

https://management.core.windows.net/<subscription-id>/services/networking/media

HTTP/1.1

Ninguno.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

x-ms-version

Obligatorio. Especifica la versión de la operación que se utiliza para esta solicitud. El valor de este encabezado debe establecerse en 2012-03-01 o superior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

Content-Type

Obligatorio. Establecer en text/plain.

El cuerpo de la solicitud de la operación Set Network Configuration es un archivo Netcfg.xml. Para obtener más información sobre el contenido de un archivo netcfg.cfg, vea Esquema de configuración de red virtual de Windows Azure.

El siguiente ejemplo de código representa un cuerpo de solicitud de configuración de red de ejemplo.

<?xml version="1.0" encoding="utf-8"?>
<NetworkConfiguration xmlns="http://schemas.microsoft.com/ServiceHosting/2011/07/NetworkConfiguration" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
  <VirtualNetworkConfiguration>        
    <Dns>
      <DnsServers>
        <DnsServer name="dns-server-name" IPAddress="IPV4-address-of-the-server"/>
        ...
      </DnsServers>
    </Dns>
    <LocalNetworkSites>
      <LocalNetworkSite name="local-site-name">
        <AddressSpace>
          <AddressPrefix>CIDR-identifier</AddressPrefix>
          ...
        </AddressSpace>
        <VPNGatewayAddress>IPV4-address-of-the-vpn-gateway</VPNGatewayAddress>
      </LocalNetworkSite>      
    </LocalNetworkSites>
    <VirtualNetworkSites>
      <VirtualNetworkSite name="virtual-network-name" AffinityGroup="affinity-group-name">
        <Label>label-for-the-site</Label>
        <AddressSpace>
          <AddressPrefix>CIDR-identifier</AddressPrefix>
          ...
        </AddressSpace>
        <Subnets>
          <Subnet name="subnet-name">
            <AddressPrefix>CIDR-identifier</AddressPrefix>
          </Subnet>
          ...
        </Subnets>
        <DnsServersRef>
          <DnsServerRef name="primary-DNS-name" />
          ...
        </DnsServersRef>
        <Gateway profile="Small">
          <VPNClientAddressPool>
            <AddressPrefix>CIDR-identifier</AddressPrefix>
            ...
          </VPNClientAddressPool>
          <ConnectionsToLocalNetwork>
            <LocalNetworkSiteRef name="local-site-name">
              <Connection type="connection-type"/>
            </LocalNetworkSiteRef>
          </ConnectionsToLocalNetwork>
        </Gateway>
      </VirtualNetworkSite>
      ...
    </VirtualNetworkSites>
  </VirtualNetworkConfiguration>
</NetworkConfiguration>

Contiene las colecciones de parámetros utilizados para configurar un espacio de red virtual dedicado a la suscripción sin solaparse con otras redes.

 

Nombre del elemento Descripción

Dns

Opcional. Contiene una colección de servidores DNS locales utilizados para resolver los nombres de instancias implementadas en Windows Azure. Si no especifica un servidor DNS, Windows Azure de manera predeterminada utiliza el servicio DNS interno de Windows Azure.

LocalNetworkSites

Opcional. Especifica una colección de parámetros que se utilizan para configurar los sitios de red local en configuraciones de red con conectividad entre entornos. Puede especificar un total de cinco sitios de red local de forma predeterminada. Puede cambiar el límite de sitios de red local a un valor distinto de cinco poniéndose en contacto con el servicio de soporte técnico de Azure. Estos valores solo son obligatorios si está realizando una configuración de red entre entornos.

VirtualNetworkSites

Opcional. los parámetros de la colección que describen las redes virtual. Cada red virtual se conoce como site. Puede definir hasta cinco sitios de red virtual por suscripción de manera predeterminada. Puede cambiar el límite de sitios de red virtual a un valor distinto de cinco para una suscripción concreta poniéndose en contacto con el servicio de soporte técnico de Windows Azure. Para especificar los sitios de red virtual, debe tener un grupo de afinidad al que asociar los sitios de red virtual. El grupo de afinidad debe crearse antes de cargar el archivo de configuración. Para obtener más información acerca de la creación de grupos de afinidad, vea Crear grupo de afinidad.

 

Nombre del elemento Descripción

DnsServers

Opcional. Contiene la colección de servidores DNS.

De forma predeterminada, puede especificar hasta nueve servidores DNS en esta sección. Puede cambiar el límite de servidores DNS a un valor distinto de nueve poniéndose en contacto con el servicio de soporte técnico de Azure. Cuando se especifica un servidor DNS aquí, debe formar parte de un sitio web externo, no una parte de una red virtual de Windows Azure. Los nombres de servidor DNS deben ser identificables de forma única en la suscripción.

 

Nombre del elemento Descripción

DnsServer

Opcional. Contiene el nombre y dirección IPv4 del servidor DNS.

 

Nombre del atributo Descripción

nombre

Obligatorio. Especifica el nombre del servidor DNS. Los nombres de servidor DNS deben ser identificables de forma única en la suscripción.

address

Obligatorio. Especifica la dirección IPv4 del servidor DNS.

Puede ser la dirección IP del propio servidor DNS o la dirección IP de un servidor DNS público.

 

Nombre del elemento Descripción

LocalNetworkSite

Opcional. Especifica los parámetros que se utilizan para configurar un sitio de red local.

 

Nombre del atributo Descripción

nombre

Obligatorio. Especifica el identificador de la red local. Cada sitio de red local se denomina mediante un nombre.

El nombre debe ser identificable de forma única en la suscripción. El nombre no debe contener ningún espacio y no puede empezar por un número.

 

Nombre del elemento Descripción

AddressSpace

Obligatorio. Contiene una colección de identificadores de Enrutamiento entre dominios sin clase (CIDR) que especifican el espacio de direcciones que utilizará para el sitio de red local. Se recomienda especificar un solo espacio de direcciones IPv4 público por sitio de red local.

Los identificadores de espacio de dirección deben cumplir los siguientes parámetros:

  • Este es el espacio de direcciones de la red local.

  • Los nombres de direcciones IP que especifique no deben solaparse con los intervalos de direcciones IP de otros sitios de red locales o sitios de red virtual.

Las direcciones pueden ser públicas o privadas.

VPNGatewayAddress

Obligatorio. Especifica la dirección IPv4 de la puerta de enlace VPN. Puede especificar únicamente una dirección IP por sitio de red local. Para establecer el túnel VPN, debe configurar un dispositivo de puerta de enlace VPN en sus instalaciones locales (software o hardware) que admitan el protocolo IKE v1 y a las que se pueda tener acceso mediante una dirección IP pública. Puede especificar únicamente una dirección IPv4 pública por sitio de red local.

 

Nombre del elemento Descripción

AddressPrefix

Obligatorio. Especifica un identificador de CIDR que identifica el espacio de direcciones. Este valor requiere un dispositivo de puerta de enlace VPN que admita el protocolo IKE v1 y al que se pueda tener acceso mediante una dirección IP pública. Solo se permiten direcciones IPv4. Los nombres de direcciones IP no deben solaparse con los intervalos de direcciones IP de otros sitios de red locales o sitios de red virtual. La subred más pequeña admitida es /29.

Ejemplo:

198.51.100.0/22

 

Nombre del elemento Descripción

VirtualNetworkSite

Obligatorio. Contiene los parámetros que describen un sitio de red virtual. Cada sitio de red virtual debe tener un nombre único y debe estar asociado a un grupo de afinidad creado previamente.

 

Nombre del atributo Descripción

nombre

Obligatorio. Especifica un nombre para la red virtual. El nombre debe ser único en la suscripción.

AffinityGroup

Obligatorio. Nombre del grupo de afinidad que desea asociar al sitio de red virtual. El grupo de afinidad debe existir previamente para hacer referencia a él en esta sección.

 

Nombre del elemento Descripción

Etiqueta

Obligatorio. Especifica un identificador descriptivo para la red virtual. No existen garantías de unicidad. Las etiquetas pueden tener un máximo de 100 caracteres y pueden contener caracteres especiales.

AddressSpace

Obligatorio. Especifica el espacio de direcciones de la red virtual. Este es un espacio de dirección IP privado que cumple la RFC 1918. Las direcciones que especifica no deben solaparse con las especificadas para otros sitios de red virtual o los sitios de red local.

Subredes

Opcional. Contiene la especificación de las subredes que desea crear en el espacio de direcciones de los sitios de red virtual.

DnsServersRef

Opcional. Contiene la especificación de los servidores DNS que se utilizan para la resolución de nombres en esta red virtual. Debe hacer referencia a los servidores DNS que declaró previamente en el elemento Dns.

Puerta de enlace

Obligatorio únicamente para conexiones entre entornos. Contiene referencias de puerta de enlace a los sitios de red local a los que la red virtual puede conectarse. Si no necesita una conectividad entre entornos, esta sección es opcional.

 

Nombre del elemento Descripción

Subred

Obligatorio. Contiene los parámetros de una subred específica. Puede especificar las varias subredes para la red virtual. Las direcciones IP de las subredes que especifique deben estar contenidas totalmente dentro del intervalo de direcciones IP de red virtual en la que resida. Para configurar una subred para la conectividad entre entornos, especifique una subred con el nombre GatewaySubnet.

 

Nombre del atributo Descripción

nombre

Opcional. Especifica el nombre de la subred. Los nombres de la subred deben ser únicos con la red virtual.

noteNota
El nombre GatewaySubnet se reserva para uso en conectividad entre entornos.

 

Nombre del elemento Descripción

AddressSpace

Obligatorio. Especifica el espacio de direcciones de la subred.

 

Nombre del elemento Descripción

DnsServerRef

Obligatorio. Especifica un servidor DNS para la resolución de nombres. Si no establece ninguna referencias de servidor DNS, el servicio DNS de Windows Azure se establece como valor predeterminado para el virtual. Si no especifica ningún servidor DNS, la resolución de nombres no funcionará a través de un vínculo VPN. Puede especificar hasta nueve servidores DNS.

 

Nombre del atributo Descripción

nombre

Obligatorio. Nombre del servidor DNS que se va a utilizar para la resolución de nombres de red virtual.

 

Nombre del atributo Descripción

perfil

Obligatorio. Especifica el tamaño de la conexión de la puerta de enlace. El único valor admitido es Small.

La lista de redes locales a las que la red virtual puede conectarse.

 

Nombre del elemento Descripción

VPNClientAddressPool

El VPNClientAddressPool reserva un grupo de direcciones IP para los clientes VPN. Este objeto se usa para la conectividad punto a sitio.

ConnectionsToLocalNetwork

Obligatorio únicamente para conexiones entre entornos. Contiene la lista de redes locales a las que la red virtual puede conectarse. Ahora solo puede especificar un sitio. Cualquier sitio al que se haga referencia en esta sección se debe definir en la configuración de red y debe encontrarse en el espacio de direcciones total

 

Nombre del elemento Descripción

AddressPrefix

Identificador de CIDR que identifica una dirección del grupo.

 

Nombre del elemento Descripción

LocalNetworkSiteRef

Obligatorio. Especifica el nombre de la red local. Cualquier sitio al que se haga referencia se debe definir en el elemento LocalNetworkSite de esta solicitud.

 

Nombre del atributo Descripción

nombre

Obligatorio. Especifica el nombre de la red local.

 

Nombre del elemento Descripción

Conexión

Especifica el tipo de conexión del sitio de red local. El valor de este elemento puede ser IPsec o Dedicated. El valor predeterminado es IPsec.

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración. Para una operación asincrónica, puede llamar a obtener el estado de la operación con el valor del encabezado para determinar si la operación se ha completado, ha generado un error o aún está en curso. Para obtener más información, vea Realizar seguimiento de solicitudes asincrónicas de administración de servicios.

Solo el propietario de la cuenta puede llamar a esta operación.

Mostrar:
© 2014 Microsoft