VENTAS: 1-800-867-1389

Actualizar rol

Actualizado: julio de 2014

La operación Update Role actualiza la configuración de la máquina virtual especificada.

La solicitud Update Role se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción, <cloudservice-name> por el nombre del servicio en la nube, <deployment-name> por el nombre de la implementación y <role-name> por el nombre de la máquina virtual.

 

Método URI de solicitud

PUT

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roles/<role-name>

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguna.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

x-ms-version

Requerido. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debería establecerse en 01/03/2012 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración de servicios.

El formato del cuerpo de la solicitud es el siguiente:

    
<PersistentVMRole xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ConfigurationSets>
    <ConfigurationSet>
      <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
      <InputEndpoints>
        <InputEndpoint>
          <LoadBalancedEndpointSetName>name-of-loadbalanced-set</LoadBalancedEndpointSetName>
          <LocalPort>local-port-number</LocalPort>
          <Name>name-of-endpoint</Name>
          <Port>external-port-number</Port>
          <LoadBalancerProbe>
            <Path>path-of-probe</Path>
            <Port>port-assigned-to-probe</Port>
            <Protocol>probe-protocol</Protocol>
          </LoadBalancerProbe>     
          <Protocol>endpoint-protocol</Protocol>
          <EnableDirectServerReturn>enable-direct-server-return</EnableDirectServerReturn>
          <EndpointAcl>
            <Rules>
              <Rule>
                <Order>priority-of-the-rule</Order>
                <Action>permit-rule</Action>
                <RemoteSubnet>subnet-of-the-rule</RemoteSubnet>
                <Description>description-of-the-rule</Description>
              </Rule>
            </Rules>
          </EndpointAcl>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        <PublicIP>
      <PublicIPs>
    <ConfigurationSet>
  </ConfigurationSets>
  <ResourceExtensionReferences>
    <ResourceExtensionReference>
      <ReferenceName>name-of-reference</ReferenceName>
      <Publisher>name-of-publisher</Publisher>
      <Name>name-of-extension</Name>
      <Version>version-of-extension</Version>
      <ResourceExtensionParameterValues>
        <ResourceExtensionParameterValue>
          <Key>name-of-parameter-key</Key>
          <Value>parameter-value</Value>
          <Type>type-of-parameter</Type>
        </ResourceExtensionParameterValue>
      </ResourceExtensionParameterValues>
      <State>state-of-resource</State>
      <Certificates>
        <Certificate>
          <Thumbprint>certificate-thumbprint</Thumbprint>
          <ThumbprintAlgorithm>certificate-algorithm</ThumbprintAlgorithm>
        </Certificate>
      </Certificates>
    </ResourceExtensionReference>
  </ResourceExtensionReferences>
  <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
  <DataVirtualHardDisks>
    <DataVirtualHardDisk>
      <HostCaching>caching-mode</HostCaching>
      <DiskName>name-of-disk</DiskName>
      <Lun>logical-unit-number</Lun>
      <LogicalDiskSizeInGB>size-in-gb-of-data-disk</LogicalDiskSizeInGB>
      <MediaLink>path-to-vhd</MediaLink>
    </DataVirtualHardDisk>
  </DataVirtualHardDisks>
  <OSVirtualHardDisk>
    <HostCaching>caching-mode</HostCaching>
    <DiskLabel>label-of-operating-system-disk</DiskLabel>
    <MediaLink>path-to-vhd</MediaLink>
    <SourceImageName>name-of-source-image</SourceImageName>
  </OSVirtualHardDisk>
  <RoleSize>size-of-virtual-machine</RoleSize>
  <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>   
</PersistentVMRole>

En la tabla siguiente se describen los elementos del cuerpo de la solicitud.

 

Nombre del elemento Descripción

ConfigurationSets

Opcional. Contiene una colección de conjuntos de configuración que definen la configuración de la aplicación y del sistema.

ResourceExtensionReferences

Opcional. Contiene una colección de extensiones de recursos que se van a instalar en la máquina virtual. Este elemento se usa si ProvisionGuestAgent se establece en true.

El elemento ResourceExtensionReferences solamente se encuentra disponible si utiliza la versión 01/11/2013 o versiones posteriores.

AvailabilitySetName

Opcional. Especifica el nombre de una colección de máquinas virtuales. Las máquinas virtuales especificadas en el mismo conjunto de disponibilidad establecido se asignan a varios nodos para maximizar la disponibilidad. Para obtener más información sobre la disponibilidad de los conjuntos de disponibilidad, vea Administrar la disponibilidad de las máquinas virtuales.

DataVirtualHardDisks

Opcional. Contiene los parámetros que se usan para agregar un disco de datos a una máquina virtual. Para obtener más información sobre los discos de datos, vea Administrar discos e imágenes.

OSVirtualHardDisk

Requerido. Contiene los parámetros utilizados para crear el disco del sistema operativo para una máquina virtual.

RoleSize

Opcional. Especifica el tamaño de la máquina virtual. El tamaño predeterminado es Pequeño. Para obtener más información acerca de los tamaños de las máquinas virtuales, vea Tamaños de máquina virtual y servicio en la nube de Azure.

ProvisionGuestAgent

Opcional. Indica si el agente de VM está instalado en la máquina virtual. Para ejecutar una extensión de recursos en una máquina virtual, este agente debe estar instalado.

Los valores posibles son:

  • true

  • false

Si el agente de VM ya se instaló en una máquina virtual, el valor no puede ser false.

Contiene una colección de conjuntos de configuración que definen la configuración de la aplicación y del sistema.

 

Nombre del elemento Descripción

ConfigurationSetType

Requerido. Solo puede actualizar la configuración en el conjunto NetworkConfiguration.

InputEndpoints

Opcional. Contiene una colección de extremos externos para la máquina virtual.

SubnetNames

Requerido si se especifica StaticVirtualNetworkIPAddress; de lo contrario, opcional en NetworkConfiguration. Contiene una lista de subredes a las que pertenece la máquina virtual.

StaticVirtualNetworkIPAddress

Opcional. Especifica la dirección IP interna para la máquina virtual en una red virtual. Si especifica este elemento, también debe especificar el elemento SubnetNames con solo una subred definida. La dirección IP especificada en este elemento debe pertenecer a la subred que se define en SubnetNames y no debe ser ninguna de las cuatro primeras direcciones IP ni la última dirección IP de la subred.

El elemento StaticVirtualNetworkIPAddress solamente se encuentra disponible si utiliza la versión 01/11/2013 o versiones posteriores.

PublicIPs

Opcional. Contiene una dirección IP pública que se puede usar además de la dirección IP virtual predeterminada para la máquina virtual.

El elemento PublicIPs solamente se encuentra disponible si utiliza la versión 01/05/2014 o versiones posteriores.

Contiene una colección de extremos externos para la máquina virtual.

 

Nombre del elemento Descripción

InputEndpoint

Requerido. Especifica las propiedades que definen un extremo externo para la máquina virtual.

LoadBalancedEndpointSetName

Opcional. Especifica un nombre para un conjunto de extremos de carga equilibrada. Especificando este elemento para un extremo se agrega al conjunto.

No establezca esta propiedad si va a agregar el extremo para conectarse a la máquina virtual a través de Escritorio remoto.

noteNota
El nombre del extremo debe ser único en el ámbito de la máquina virtual.

LocalPort

Requerido. Especifica el puerto interno en el que la máquina virtual escucha para servir al extremo.

Nombre

Requerido. Especifica el nombre del extremo externo.

Puerto

Requerido. Especifica el puerto externo para el extremo.

LoadBalancerProbe

Opcional. Contiene propiedades que definen los valores del extremo que el equilibrador de carga de Azure utiliza para supervisar la disponibilidad de esta máquina virtual antes de enviar tráfico al mismo.

Protocol

Requerido. Especifica el protocolo de transporte para el extremo externo.

Los valores posibles son:

  • TCP

  • UDP

El valor predeterminado es false.

EnableDirectServerReturn

Opcional. Especifica si el extremo usa Direct Server Return. El elemento EnableDirectServerReturn no se admite para los extremos RDP, SSH o WinRM y no se admite cuando el puerto público y el puerto local de un extremo son diferentes. No puede deshabilitar EnableDirectServerReturn en un extremo. Si EnableDirectServerReturn se establece en true, no puede actualizar el valor de Protocol. Se recomienda usar este elemento solo al configurar máquinas virtuales para SQL Server y grupos de disponibilidad AlwaysOn. Para obtener más información, vea Alta disponibilidad y recuperación ante desastres para SQL Server en máquinas virtuales de Azure.

Los valores posibles son:

  • true

  • false

El valor predeterminado es false.

EndpointAcl

Opcional. Contiene una colección de reglas que controlan el tráfico de red al extremo.

El elemento EndpointAcl solamente se encuentra disponible si se utiliza la versión 01-06-2013 o versiones posteriores.

LoadBalancerName

Opcional. Especifica el nombre del equilibrador de carga interno asociado al extremo. El nombre del equilibrador de carga interno se especifica en LoadBalancers.

El elemento LoadBalancerName solamente se encuentra disponible si utiliza la versión 01/05/2014 o versiones posteriores.

IdleTimeoutInMinutes

Opcional. Especifica el tiempo de espera para la conexión TCP inactiva. El valor se puede establecer entre 4 y 30 minutos. El valor predeterminado es 4 minutos. Este elemento solo se usa cuando el protocolo se establece en TCP.

El elemento IdleTimeoutInMinutes solamente se encuentra disponible si utiliza la versión 01/06/2014 o versiones posteriores.

Contiene propiedades que definen los valores del extremo que el equilibrador de carga de Azure utiliza para supervisar la disponibilidad de esta máquina virtual antes de enviar tráfico al mismo.

 

Nombre del elemento Descripción

Path

Opcional. Especifica la ruta relativa para inspeccionar a fin de determinar el estado de disponibilidad de la máquina virtual. Si el protocolo está establecido en TCP, este valor debe ser NULL.

Ejemplo:

ruta

El sondeo utilizará https://example.com/path para realizar el sondeo.

Puerto

Opcional. Especifica el puerto para inspeccionar el estado de disponibilidad de la máquina virtual.

Protocol

Opcional. Especifica el protocolo para inspeccionar el estado de disponibilidad de la máquina virtual.

Los valores posibles son:

  • HTTP

  • TCP

IntervalInSeconds

Opcional. Especifica el intervalo para el sondeo de equilibrador de carga en segundos. El valor mínimo es de 5 segundos. El valor predeterminado es 15 segundos.

TimeoutInSeconds

Opcional. Especifica el tiempo de espera para el sondeo de equilibrador de carga en segundos. El valor mínimo es de 11 segundos. El valor predeterminado es 31 segundos.

Contiene una colección de reglas que controlan el tráfico de red al extremo.

 

Nombre del elemento Descripción

reglas

Requerido. Especifica una colección de reglas de control de acceso. Se permiten 50 reglas, como máximo.

Rule

Requerido. Especifica la definición de una regla de control de acceso.

Pedido

Requerido. Especifica la prioridad de la regla. El valor puede estar comprendido entre 0 y 65535. El número de orden debe ser único para cada regla de la colección. Cuanto menor es el número de orden, mayor es la prioridad de la regla.

Action

Requerido. Especifica si el tráfico que coincide con la regla debe permitirse o denegarse.

Los valores posibles son:

  • permit

  • deny

RemoteSubnet

Requerido. Especifica la subred para la regla. La subred debe estar en la notación de IPV4 Enrutamiento entre dominios sin clase (CIDR) y debe ser una subred válida.

Por ejemplo, 10.0.0.0/24

Descripción

Opcional. Especifica la descripción de la regla. La longitud máxima de la descripción es de 256 caracteres.

Contiene una dirección IP pública que se puede usar además de la dirección IP virtual predeterminada para la máquina virtual.

 

Nombre del elemento Descripción

PublicIP

Requerido. Especifica una dirección IP pública adicional que se puede usar para comunicarse con la máquina virtual.

Nombre

Requerido. Especifica el nombre de la dirección IP pública.

IdleTimeoutInMinutes

Opcional. Especifica el tiempo de espera para la conexión TCP inactiva. El valor se puede establecer entre 4 y 30 minutos. El valor predeterminado es 4 minutos. Este elemento solo se usa cuando el protocolo se establece en TCP.

El elemento IdleTimeoutInMinutes solamente se encuentra disponible si utiliza la versión 01/06/2014 o versiones posteriores.

Contiene una lista de subredes a las que pertenece la máquina virtual.

 

Nombre del elemento Descripción

SubnetName

Requerido. Especifica el nombre de la subred a la que pertenece la máquina virtual.

Contiene los parámetros que se usan para agregar un disco de datos a una máquina virtual.

 

Nombre del elemento Descripción

DataVirtualHardDisk

Requerido. Especifica las propiedades utilizadas para crear un disco de datos.

HostCaching

Opcional. Especifica el comportamiento de almacenamiento en caché del disco de datos para la eficacia de lectura/escritura. Establecer esta propiedad afecta a la coherencia de disco.

Los valores posibles son:

  • None

  • ReadOnly

  • ReadWrite

El valor predeterminado es None.

DiskName

Opcional. Si el disco que se agrega ya se ha registrado en la suscripción, este elemento se usa para identificar el disco que se va a agregar. Si Azure crea un disco nuevo y el VHD asociado, no se usa este elemento y Azure asigna un nombre único que es una combinación del nombre de la implementación, el nombre del rol y el número de identificación.

El nombre del disco debe contener solo caracteres alfanuméricos, caracteres de subrayado, puntos o guiones. El nombre no debe tener más de 256 caracteres. El nombre no debe terminar con punto ni guion.

Lun

Opcional. Especifica el número de unidad lógica (LUN) del disco de datos. Si el disco es el primero que se agrega, este elemento es opcional y se usa el valor predeterminado 0. Si se agrega más de un disco, este elemento es obligatorio.

Puede usar Get Role para encontrar los números LUN que ya están usándose.

Los valores válidos son de LUN son de 0 a 15.

LogicalDiskSizeInGB

Opcional. Especifica el tamaño, en GB, de un disco vacío para adjuntarlo a la máquina virtual. Si el disco que se agrega ya se ha registrado en la suscripción, este elemento se pasa por alto. Si Azure crea el disco y el disco duro virtual a medida que se agrega, este elemento define el tamaño del nuevo disco.

El número de discos que se pueden agregar a una máquina virtual viene limitado por el tamaño de esta. Para obtener más información, vea Tamaños de máquina virtual y servicio en la nube de Azure.

MediaLink

Opcional. Si el disco que se agrega ya se ha registrado en la suscripción o el disco duro virtual del disco ya existe en el almacenamiento de blobs, este elemento se omite. Si no existe ningún archivo VHD en el almacenamiento de blobs, este elemento define la ubicación en que se crea el nuevo VHD cuando se agrega el nuevo disco.

Ejemplo:

http://example.blob.core.windows.net/disks/mydatadisk.vhd

SourceMediaLink

Opcional. Si el disco que se agrega ya se ha registrado en la suscripción o el disco duro virtual del disco no existe en el almacenamiento de blobs, este elemento se omite. Si el archivo VHD existe en el almacenamiento de blobs, este elemento define la ruta de acceso al VHD y se registra un disco a partir de él y se conecta a la máquina virtual.

Contiene los parámetros utilizados para crear el disco del sistema operativo para una máquina virtual.

 

Nombre del elemento Descripción

HostCaching

Opcional. Especifica el modo de almacenamiento en caché del disco del sistema operativo. Esta configuración afecta a la coherencia y rendimiento del disco.

Los valores posibles son:

  • ReadOnly

  • ReadWrite

El valor predeterminado es ReadWrite.

noteNota
Cambiar este valor ocasiona que la máquina virtual se reinicie.

DiskLabel

Opcional. Especifica la descripción del disco.

MediaLink

Opcional. Especifica la ubicación del archivo VHD que se crea cuando SourceImageName especifica una imagen de plataforma.

Ejemplo:

http://contoso.blob.core.windows.net/disks/mydisk.vhd

SourceImageName

Opcional. Especifica el nombre de la imagen utilizada para crear la máquina virtual. Puede especificar una imagen de usuario o una imagen de plataforma. Una imagen siempre se asocia a un VHD, que es un archivo .vhd almacenado como un blob en páginas de una cuenta de almacenamiento en Azure. Si especifica una imagen de plataforma, se crea un VHD asociado y debe usar el elemento MediaLink para especificar la ubicación del almacenamiento donde se encontrará el VHD.

Contiene una colección de extensiones de recursos que se van a instalar en la máquina virtual. Una extensión de recursos es un componente de software que se instala en la máquina virtual. El agente de VM debe instalarse en la máquina virtual para poder instalar extensiones de recursos.

 

Nombre del elemento Descripción

ResourceExtensionReference

Requerido. Especifica las propiedades de una extensión de recursos que se debe instalar en la máquina virtual.

ReferenceName

Requerido. Especifica el nombre de referencia de la extensión de recursos.

Publicador

Requerido. Especifica el nombre del publicador que creó la extensión de recursos. Puede usar List Resource Extensions para buscar el nombre del publicador de una extensión de recursos.

Nombre

Requerido. Especifica el nombre de la extensión de recursos. Puede usar Enumerar extensiones de recursos para buscar los nombres de las extensiones de recursos disponibles.

Versión

Requerido. Especifica la versión de la extensión de recursos. Puede establecer este valor en * para usar la versión más reciente de la extensión. Si la extensión se agregó o actualizó recientemente, debe asegurarse de que el valor de ReplicationCompleted se establezca en true antes de poder usar la versión de la extensión. Puede usar Enumerar versiones de extensiones de recursos para determinar el estado de replicación y las versiones disponibles de la extensión.

ResourceExtensionParameterValues

Opcional. Contiene una colección de parámetros que se pasan a la extensión de recursos cuando se instala.

State

Opcional. Especifica el estado de la extensión de recursos.

Los valores posibles son:

  • enable

  • disable

  • uninstall

El valor predeterminado es enable. Se debe agregar una nueva extensión con el estado enable.

El estado uninstall solamente se encuentra disponible si utiliza la versión 2014-04-01 o posterior.

Certificates

Opcional. Contiene una colección de certificados que se instalan en la máquina virtual y que usa la extensión. Antes de poder incluir los certificados en esta solicitud, deben agregarse al servicio en la nube. Para obtener más información, vea Agregar certificado de servicio.

El elemento Certificates solamente se encuentra disponible si utiliza la versión 01/06/2014 o versiones posteriores.

Contiene una colección de parámetros que se pasan a la extensión de recursos cuando se instala.

 

Nombre del elemento Descripción

ResourceExtensionParameterValue

Requerido. Especifica la clave, el valor y el tipo del parámetro.

Key

Requerido. Especifica la clave del parámetro.

Valor

Requerido. Especifica el valor codificado en base 64 del parámetro. Si el formato de la configuración de la extensión es XML, este valor se valida usando el esquema público o privado. El esquema que se usa depende del valor de Type.

Si el formato de la configuración de la extensión es JSON, este valor debe contener un objeto JSON válido. Los esquemas público o privado no se pueden usar para validar el objeto. Para usar un objeto JSON, la versión debe ser 2014-04-01 o superior.

Tipo

Requerido. Especifica el tipo de la extensión de recursos.

Los valores posibles son:

  • Public

  • Private

Si este valor se establece en Private, Get Deployment no devolverá el parámetro.

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 202 (Aceptado). 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.

También puede usar el cmdlet Update-AzureVM para cambiar la configuración de una máquina virtual.

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft