Obtener implementación

La operación Get Deployment devuelve información de configuración, de estado y de las propiedades del sistema para una implementación.

Request

La solicitud Get Deployment se puede usar para recuperar eventos de implementación para una única ranura de implementación (ensayo o producción) o para un nombre de implementación específico. Si desea recuperar información por nombre de implementación, primero debe obtener el nombre único de la implementación. Este nombre único forma parte de la respuesta cuando se realiza una solicitud para obtener la implementación en una ranura de implementación.

Por ejemplo, si tiene un servicio en la nube implementada en el entorno de producción, puede obtener el nombre único realizando una solicitud a …/deploymentslots/production. La respuesta incluye un elemento Name para el servicio en la nube. Ese valor del elemento Name se puede utilizar para realizar una solicitud a …/deployments/<Name> si desea recuperar información sobre esa implementación concreta.

Para generar la URI de solicitud, reemplace <subscription-id> por el identificador de la suscripción, <cloudservice-name> por el nombre del servicio en la nube, <deployment-slot> por staging o production o <deployment-name> por el nombre de la implementación.

Método URI de solicitud
GET https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>
GET https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud Descripción
x-ms-version Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse 2009-10-01 en o superior.

Cuerpo de la solicitud

Ninguno.

Response

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

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar.

Encabezado de respuesta Descripción
x-ms-request-id Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración.

Cuerpo de la respuesta

En el ejemplo siguiente se muestra el formato del cuerpo de la respuesta:

<?xml version="1.0" encoding="utf-8"?>  
<Deployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Name>name-of-deployment</Name>  
  <DeploymentSlot>current-deployment-environment</DeploymentSlot>  
  <PrivateID>identifier-of-deployment</PrivateID>  
  <Status>status-of-deployment</Status>  
  <Label>base64-encoded-name-of-deployment</Label>  
  <Url>url-of-deployment</Url>  
  <Configuration>base-64-encoded-configuration-file</Configuration>  
  <RoleInstanceList>  
    <RoleInstance>  
      <RoleName>name-of-role</RoleName>  
      <InstanceName>name-of-role-instance</InstanceName>  
      <InstanceStatus>status-of-role-instance</InstanceStatus>  
      <ExtendedInstanceStatus>additional-status-details</ExtendedInstanceStatus>  
      <InstanceUpgradeDomain>update-domain-of-role-instance</InstanceUpgradeDomain>  
      <InstanceFaultDomain>fault-domain-of-role-instance</InstanceFaultDomain>  
      <InstanceSize>size-of-role-instance</InstanceSize>  
      <InstanceStateDetails>state-of-role-instance</InstanceStateDetails>  
      <InstanceErrorCode>error-code-returned-for-role-instance</InstanceErrorCode>  
      <IpAddress>ip-address-of-role-instance</IpAddress>  
      <InstanceEndpoints>  
        <InstanceEndpoint>  
          <Name>name-of-endpoint</Name>  
          <Vip>virtual-ip-address-of-instance-endpoint</Vip>  
          <PublicPort>public-facing-port-of-instance-endpoint</PublicPort>  
          <LocalPort>internal-facing-port-of-instance-endpoint</LocalPort>  
          <Protocol>protocol-of-instance-endpoint</Protocol>  
        </InstanceEndpoint>  
      </InstanceEndpoints>  
      <PowerState>state-of-role-instance</PowerState>  
      <HostName>dns-name-of-service</HostName>  
      <RemoteAccessCertificateThumbprint>cert-thumbprint-for-remote-access</RemoteAccessCertificateThumbprint>  
      <GuestAgentStatus>  
        <ProtocolVersion>version-of-protocol</ProtocolVersion>  
        <Timestamp>status-report-time</Timestamp>  
        <GuestAgentVersion>version-of-agent</GuestAgentVersion>  
        <Status>status-of-agent</Status>  
        <FormattedMessage>  
          <Language>language-of-message</Language>  
          <Message>agent-message</Message>  
        </FormattedMessage>  
      </GuestAgentStatus>  
      <ResourceExtensionStatusList>  
        <ResourceExtensionStatus>  
          <HandlerName>name-of-extension</HandlerName>  
          <Version>version-of-extension</Version>  
          <Status>status-of-extension</Status>  
          <Code>status-code-of-extension</Code>  
          <FormattedMessage>  
            <Language>language-of-message</Language>  
            <Message>extension-message</Message>  
          </FormattedMessage>  
          <ExtensionSettingStatus>  
            <Timestamp>status-report-time</Timestamp>  
            <Name>name-of-setting</Name>  
            <Operation>operation-performed</Operation>  
            <Status>status-of-setting</Status>  
            <Code>status-code</Code>  
            <FormattedMessage>  
              <Language>language-of-status-message</Language>  
              <Message>status-message</Message>  
            </FormattedMessage>  
            <SubStatusList>  
              <SubStatus>  
                <Name>name-of-substatus-object</Name>  
                <Status>status-of-object</Status>  
                <FormattedMessage>  
                  <Language>language-of-message</Language>  
                  <Message>status-message</Message>  
                </FormattedMessage>  
              </SubStatus>                     
            </SubStatusList>  
          </ExtensionSettingStatus>  
        </ResourceExtensionStatus>  
      </ResourceExtensionStatusList>  
      <PublicIPs>  
        <PublicIP>  
          <Name>name-of-public-ip</Name>  
          <Address>ip-address</Address>  
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>  
          <DomainNameLabel>domain-label</DomainNameLabel>  
          <Fqdns>  
            <Fqdn>fqdn</Fqdn>  
          </Fqdns>  
        <PublicIP>  
      <PublicIPs>  
      <NetworkInterfaces>  
        <NetworkInterface>  
          <Name>interface-name</Name>  
          <MacAddress>mac-address</MacAddress>  
          <IPConfigurations>  
            <IPConfiguration>  
              <SubnetName>subnet-name</SubnetName>  
              <Address>ip-address</Address>  
            </IPConfiguration>  
          <IPConfigurations>  
        </NetworkInterface>  
      </NetworkInterfaces>  
    </RoleInstance>  
  </RoleInstanceList>  
  <UpgradeStatus>  
    <UpgradeType>type-of-upgrade</UpgradeType>  
    <CurrentUpgradeDomainState>current-status-of-upgrade</CurrentUpgradeDomainState>  
    <CurrentUpgradeDomain>n</CurrentUpgradeDomain>  
  </UpgradeStatus>  
  <UpgradeDomainCount>number-of-upgrade-domains-in-deployment</UpgradeDomainCount>  
  <RoleList>  
    <Role>  
      <RoleName>name-of-role</RoleName>  
      <OsVersion>operating-system-version</OsVersion>  
      <ConfigurationSets>  
        <ConfigurationSet>  
          <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>  
          <InputEndpoints>  
            <InputEndpoint>  
              <Port>port-number-of-input-endpoint-in-network</Port>  
              <Protocol>protocol-of-input-endpoint-in-network</Protocol>  
              <Vip>virtual-ip-address-of-input-endpoint-in-network</Vip>  
            </InputEndpoint>  
          </InputEndpoints>  
          <PublicIPs>  
            <PublicIP>  
              <Name>PublicIPName</Name>  
              <StaticVirtualNetworkIPAddress></StaticVirtualNetworkIPAddress>  
              <IdleTimeoutInMinutes></IdleTimeoutInMinutes>  
              <DomainNameLabel>domain-name</DomainNameLabel>  
            </PublicIP>  
          </PublicIPs>  
          <NetworkInterfaces>  
            <NetworkInterface>  
              <Name>interface-name</Name>  
              <IPConfigurations>  
                <IPConfiguration>  
                  <SubnetName>subnet-name</SubnetName>  
                  <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>  
                </IPConfiguration>  
              </IPConfigurations>  
            </NetworkInterface>  
          <NetworkInterfaces>  
        </ConfigurationSet>  
      </ConfigurationSets>  
    </Role>  
    <Role>  
      <RoleName>name-of-role</RoleName>  
      <OsVersion>operating-system-version</OsVersion>  
      <RoleType>PersistentVMRole</RoleType>  
      <LicenseType>type-of-license</LicenseType>  
      <ConfigurationSets>  
        <ConfigurationSet>  
          <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>  
          <InputEndpoints>  
            <InputEndpoint>  
              <LoadBalancedEndpointSetName>name-of-load-balanced-endpoint-set</LoadBalancedEndpointSetName>  
              <LocalPort>internal-facing-port-of-input-endpoint</LocalPort>  
              <Name>name-of-input-endpoint</Name>  
              <Port>external-facing-port-of-input-endpoint</Port>  
              <LoadBalancerProbe>  
                <Path>path-of-probe</Path>  
                <Port>port-assigned-to-probe</Port>  
                <Protocol>protocol-of-probe-port</Protocol>  
              </LoadBalancerProbe>  
              <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>  
              <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>  
              <Protocol>protocol-of-input-endpoint</Protocol>  
              <Vip>virtual-ip-address-of-input-endpoint</Vip>  
            </InputEndpoint>  
          <InputEndpoints>  
          <SubnetNames>  
            <SubnetName>name-of-subnet</SubnetName>  
          </SubnetNames>  
          <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>  
        </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>  
        </ResourceExtensionReference>  
      </ResourceExtensionReferences>  
      <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>  
      <DataVirtualHardDisks>  
        <DataVirtualHardDisk>  
          <HostCaching>host-caching-mode-of-data-disk</HostCaching>  
          <DiskName>name-of-data-disk</DiskName>  
          <Lun>logical-unit-number-of-data-disk</Lun>  
          <LogicalDiskSizeInGB>size-of-data-disk</LogicalDiskSizeInGB>  
          <MediaLink>path-to-vhd</MediaLink>  
          <IOType>IO-Type<IOType>  
        </DataVirtualHardDisk>  
      </DataVirtualHardDisks>  
      <OSVirtualHardDisk>  
        <HostCaching>host-caching-mode-of-os-disk</HostCaching>  
        <DiskName>name-of-os-disk</DiskName>  
        <MediaLink>path-to-vhd</MediaLink>  
        <SourceImageName>image-used-to-create-os-disk</SourceImageName>  
        <OS>operating-system-on-os-disk</OS>  
        <RemoteSourceImageLink>path-to-source-image</RemoteSourceImageLink>  
         <IOType>IO-Type<IOType>  
      </OSVirtualHardDisk>  
      <RoleSize>size-of-instance</RoleSize>  
      <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>  
    </Role>  
  </RoleList>  
  <SdkVersion>sdk-version-used-to-create-package</SdkVersion>  
  <Locked>status-of-deployment-write-allowed</Locked>  
  <RollbackAllowed>rollback-operation-allowed</RollbackAllowed>  
  <VirtualNetworkName>name-of-virtual-network</VirtualNetworkName>  
  <Dns>  
    <DnsServers>  
      <DnsServer>  
        <Name>name-of-dns-server</Name>  
        <Address>address-of-dns-server</Address>  
      </DnsServer>  
    </DnsServers>  
  </Dns>  
  <LoadBalancers>  
    <LoadBalancer>  
      <Name>name-of-internal-load-balancer</Name>  
      <FrontendIpConfiguration>  
        <Type>type-of-ip-address</Type>  
        <SubnetName>name-of-subnet</SubnetName>  
        <StaticVirtualNetworkIPAddress>static-ip-address</StaticVirtualNetworkIPAddress>  
      </FrontendIpConfiguration>  
    </LoadBalancer>  
  </LoadBalancers>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <PersistentVMDowntime>  
    <StartTime>start-of-downtime</StartTime>  
    <EndTime>end-of-downtime</EndTime>  
    <Status>status-of-downtime</Status>  
  </PersistentVMDowntime>  
  <VirtualIPs>  
    <VirtualIP>  
      <Address>virtual-ip-address-of-deployment</Address>  
      <IsReserved>indicator-of-ip-reservation</IsReserved>  
      <ReservedIPName>name-of-reserved-ip</ReservedIpName>  
      <Type>type-of-ip</Type>  
    </VirtualIP>  
  </VirtualIPs>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <SequenceNumber>configuration-sequence</SequenceNumber>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <SequenceNumber>configuration-sequence</SequenceNumber>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
  <ReservedIPName>name-of-reserved-ip</ReservedIpName>  
  <InternalDnsSuffix>dns-suffix</InternalDnsSuffix>  
</Deployment>  

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

Nombre del elemento Descripción
Nombre Especifica el nombre de la implementación.
DeploymentSlot Especifica el entorno en el que implementa el servicio en la nube, staging o production.
PrivateID Especifica un identificador único generado internamente para esta implementación.
Estado Especifica el estado de la implementación.

Los valores posibles son:

- Running

- Suspended

- RunningTransitioning

- SuspendedTransitioning

- Starting

- Suspending

- Deploying

- Deleting
Etiqueta Especifica un identificador codificado en base 64 de la implementación. Este identificador se puede usar con fines de seguimiento.
Url Especifica la dirección URL que se usa para el acceso al servicio en la nube.

Por ejemplo, si el nombre del servicio es MyService, puede acceder al servicio mediante una llamada a: http:// MyService.cloudapp.net
Configuración Especifica el archivo de configuración codificado en base 64 de la implementación.
RoleInstanceList Contiene la lista de instancias de rol en la implementación.
UpgradeStatus Contiene la configuración del modo en que se actualiza la implementación.
UpgradeDomainCount Contiene un entero que representa el número total de dominios de actualización para la implementación.

El UpgradeDomainCount elemento solo está disponible con la versión 2011-06-01 o posterior.
RoleList Contiene la lista de roles en la implementación.
SdkVersion Especifica la versión del SDK utilizada para generar el paquete de la implementación.

El SdkVersion elemento solo está disponible con la versión 2011-06-01 o posterior.
Bloqueado True para evitar una nueva operación de escritura en la implementación mientras se actualiza; si no false.

El Locked elemento solo está disponible con la versión 2011-06-01 o posterior.
RollbackAllowed True si la operación RollbackDeploymentUpdateOrUpgrade se permite en la implementación; si no false.

El RollbackAllowed elemento solo está disponible con la versión 2011-06-01 o posterior.
CreatedTime Especifica la hora de creación de la implementación.
LastModifiedTime Especifica la última vez que se modificó la implementación.
VirtualNetworkName Especifica el nombre de red virtual a la que la máquina virtual se conecta.

El VirtualNetworkName elemento solo está disponible con la versión 2012-03-01 o posterior.
Dns Contiene la configuración DNS que se especifica para la implementación.

El Dns elemento solo está disponible con la versión 2012-03-01 o posterior.
LoadBalancers Contiene una lista de equilibradores de carga internos que se pueden asignar a extremos de entrada.

El LoadBalancers elemento solo está disponible con la versión 2014-05-01 o posterior.
ExtendedProperties Especifica las propiedades utilizadas para proporcionar más información sobre una implementación.
PersistentVMDowntime Especifica información sobre cuando se ha activado y se ha detenido la máquina virtual.

El PersistentVMDowntime elemento solo está disponible con la versión 2012-03-01 o posterior.
VirtualIPs Especifica las direcciones IP virtuales que se especifican para la implementación.

El VirtualIPs elemento solo está disponible con la versión 2012-03-01 o posterior.
ExtensionConfiguration Especifica una extensión que se agrega al servicio en la nube. En Azure, un proceso puede ejecutarse como una extensión de un servicio en la nube. Puede agregar una extensión a un servicio en la nube mediante Add Extension (Agregar extensión ) y puede agregar la extensión a la implementación mediante Upgrade Deployment (Implementación de actualización ) o Change Deployment Configuration (Cambiar configuración de implementación).

El ExtensionConfiguration elemento solo está disponible con la versión 2013-03-01 o posterior.
ReservedIPName Especifica el nombre de una dirección IP reservada que se asignará a la implementación.

El ReservedIPName elemento solo está disponible con la versión 2014-05-01 o posterior.
InternalDnsSuffix Especifica el sufijo del nombre de dominio para la resolución de nombres interna que Azure asigna automáticamente. A todas las instancias de máquinas virtuales en una implementación se les asigna automáticamente el sufijo del nombre de dominio. A todas las instancias de roles web o roles de trabajo en una implementación se les asigna el sufijo del nombre de dominio cuando se usa el atributo vmName para asignar un nombre de equipo a por lo menos un rol. A una implementación que esté en una VNET con un servidor DNS configurado no se le asigna un sufijo interno de nombre de dominio.

El InternalDnsSuffix elemento solo está disponible con la versión 2013-11-01 o posterior.

RoleInstanceList

Contiene la lista de instancias de rol en la implementación.

Nombre del elemento Descripción
RoleName Especifica el nombre del rol.
InstanceName Especifica el nombre de una instancia de rol específica, si se está ejecutando una instancia de rol.
InstanceStatus Especifica el estado actual de una instancia de rol.

Unknown :

: indica que el estado del rol es actualmente desconocido.

CreatingVM :

: indica que se están creando recursos para una máquina virtual.

StartingVM :

: indica que se está iniciando una máquina virtual.

CreatingRole :

: indica que se están creando recursos para una instancia de rol.

StartingRole :

: indica que se está iniciando una instancia de rol.

ReadyRole :

: indica que se ha iniciado una instancia de rol y está lista para usarse.

BusyRole :

: indica que una instancia de rol no está disponible para las solicitudes. Este estado se genera normalmente mientras se está creando o deteniendo la instancia de rol.

StoppingRole :

: indica que una instancia de rol se está deteniendo.

StoppingVM :

: indica que una máquina virtual se está deteniendo.

DeletingVM :

: indica que se está eliminando una máquina virtual.

StoppedVM :

: indica que una máquina virtual no se está ejecutando. Es el estado final del proceso de cierre, y no se deberían recibir otros mensajes de estado después de StoppedVM.

RestartingRole :

: indica que una instancia de rol se ha detenido inesperadamente o no se ha podido iniciar. Este estado indica que hay un problema con la instancia de rol que está bloqueándola o impide que se inicie, y debe corregirse antes de que la instancia de rol se pueda iniciar. Los campos InstanceStateDetails e InstanceErrorCode pueden contener información acerca del error del rol que ocasionó este estado.

CyclingRole :

: indica que un rol se ha bloqueado continuamente después de que Azure lo inicie. Este estado indica que hay un problema con el rol que impide que se inicie, y se puede generar después de que se reciban los estados StartingRole incluso ReadyRole. Se debe encontrar el problema en el rol y corregirlo antes de que el rol pueda iniciarse. Los campos InstanceStateDetails y InstanceErrorCode pueden contener información sobre el error de rol que dio lugar a este estado, que puede ser útil para identificar y depurar el problema. El elemento CyclingRole se devuelve únicamente si la versión es 2014-02-01 o inferior.

FailedStartingRole :

- El rol no se ha podido iniciar continuamente. Este estado indica que hay un problema con la instancia de rol que impide que se inicie y se puede generar después de que el proceso devuelva StartingRole. Se debe encontrar el problema en el rol y corregirlo antes de que el rol pueda iniciarse. Los campos InstanceStateDetails y InstanceErrorCode pueden contener información sobre el error de rol que dio lugar a este estado, que puede ser útil para identificar y depurar el problema.

FailedStartingVM :

: indica que una máquina virtual no se pudo iniciar continuamente. Este estado lo genera Azure genera, y no indica un error con el rol. Se puede generar después del estado StartingRole.

UnresponsiveRole :

: indica que una instancia de rol ha agotado el tiempo de espera antes de recibir un mensaje de estado y no responde a las solicitudes.

StoppedDeallocated :

: indica que se ha detenido una instancia de rol y se han liberado todos los recursos asignados. De esta forma se deja de facturar por la instancia de rol. Las instancias de rol que tienen el estado StoppedDeallocated solo se devuelven en la lista de instancias de rol si la versión es la 2013-06-01 o una posterior. Si todas las instancias de rol de la implementación tienen el estado StoppedDeallocated, no se devuelve la implementación si la versión es menor que 2013-06-01.

Preparing :

: indica que el blob se está copiando desde la ubicación de origen remota. Este estado solo se devuelve si la versión es 01-05-2014 o posterior.
ExtendedInstanceStatus Especifica detalles de estado adicionales si están disponibles para la implementación. Si un blob se está copiando desde una ubicación de origen remota a una cuenta de almacenamiento, el valor de este elemento contiene el porcentaje del blob que se ha copiado.

El ExtendedInstanceStatus elemento solo está disponible con la versión 2015-05-01 o posterior.
InstanceUpgradeDomain Especifica el dominio de actualización al que pertenece la instancia de rol. Durante una implementación de actualización, todos los roles en el mismo dominio de actualización se actualizan al mismo tiempo.

El InstanceUpgradeDomain elemento solo está disponible con la versión 2011-06-01 o posterior.
InstanceFaultDomain Especifica el dominio de error al que pertenece la instancia de rol. Las instancias de rol en el mismo dominio de error pueden ser vulnerable a a un error de un único fragmento de hardware.

El InstanceFaultDomain elemento solo está disponible con la versión 2011-06-01 o posterior.
InstanceSize Especifica el tamaño de la instancia de rol.

El InstanceSize elemento solo está disponible con la versión 2011-06-01 o posterior.
InstanceStateDetails Proporciona una instantánea del estado de la instancia de rol en el momento en que se llamó a la operación.

El InstanceStateDetails elemento solo está disponible con la versión 2011-10-01 o posterior.
InstanceErrorCode Código de error del último inicio del rol.

Los códigos de error para las máquinas virtuales son:

- WaitTimeout: la instancia de rol no se ha comunicado en un plazo de 25 minutos. Esto suele indicar que no se inició o que el agente invitado no está instalado.

- VhdTooLarge: la imagen VHD seleccionada era demasiado grande para la instancia de rol.

- AzureInternalError: se ha producido un error interno que ha provocado que la instancia de rol no se inicie. Póngase en contacto con el servicio de soporte técnico para obtener ayuda adicional.

Para los roles web y de trabajo este campo devuelve un código de error que se puede proporcionar al soporte técnico de Azure para ayudar en la resolución de errores. Este campo suele estar vacío.

El InstanceErrorCode elemento solo está disponible con la versión 2011-10-01 o posterior.
IpAddress Especifica la dirección IP de la instancia de rol (DIP).

El IpAddress elemento solo está disponible con la versión 2012-03-01 o posterior.
InstanceEndpoints Contiene la lista de extremos de instancias para el rol.
PowerState Estado de ejecución de la máquina virtual.

Estos son los valores posibles:

- Starting

- Started

- Stopping

- Stopped

- Unknown
HostName Especifica el nombre del host DNS del servicio en la nube en el que la instancia de rol se está ejecutando. Este elemento se muestran únicamente para las implementaciones de máquina virtual.
RemoteAccessCertificateThumbprint Especifica la huella digital del certificado del servidor RDP (en Windows) o del certificado del servidor SSH (en Linux). La huella digital solo se utiliza para las Virtual Machines que se han creado desde una imagen.

El RemoteAccessCertificateThumbprint elemento solo está disponible con la versión 2012-08-01 o posterior.
GuestAgentStatus Especifica la información sobre el agente que está instalado en una instancia.

El GuestAgentStatus elemento solo está disponible con la versión 2014-04-01 o posterior.
ResourceExtensionStatusList Especifica la información sobre las extensiones que están instaladas en una instancia.

El ResourceExtensionStatusList elemento solo está disponible con la versión 2014-04-01 o posterior.
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 PublicIPs elemento solo está disponible con la versión 2014-05-01 o posterior.
NetworkInterfaces Opcional, un conjunto de interfaces de red secundarias. El número de interfaces de red secundarias permitidas depende del tamaño de la máquina virtual.

El elemento NetworkInterfaces solamente se encuentra disponible si usa la versión 01-08-2014 o versiones posteriores.

InstanceEndpoints

Contiene la lista de extremos de instancias para el rol.

Nombre del elemento Descripción
Nombre Especifica el nombre del extremo.
Vip Especifica la dirección IP virtual del extremo.

El Vip elemento solo está disponible con la versión 2011-06-01 o posterior.
PublicPort Especifica el puerto externo que usa el extremo.
LocalPort Especifica el puerto interno que usa el extremo.
Protocolo Especifica el protocolo del tráfico en el extremo.

UpgradeStatus

Especifica información sobre una actualización que tiene lugar en la implementación.

Nombre del elemento Descripción
UpgradeType Especifica el tipo de la actualización.

Los valores posibles son:

- Auto

- Manual

- Simultaneous
CurrentUpgradeDomainState Especifica el estado actual de la actualización. Los valores posibles son Before y During.
CurrentUpgradeDomain Contiene un valor entero que identifica el dominio de actualización actual. Los dominios de actualización se identifican mediante un índice basado en cero: el primer dominio de actualización tiene un identificador 0, el segundo tiene un identificador 1, y así sucesivamente.

RoleList

Contiene la lista de roles en la implementación.

Nombre del elemento Descripción
RoleName Especifica el nombre del rol.
OsVersion Especifica la versión del sistema operativo en la que se ejecutan las instancias de rol.
RoleType Especifica el tipo del rol. Este elemento se muestran únicamente para las implementaciones de máquina virtual y de forma predeterminada es PersistentVMRole.
LicenseType Especifica que la imagen o el disco que se usa se licenciaron en el entorno local. Este elemento solo se usa para imágenes que contienen el sistema operativo Windows Server.

Los valores posibles son:

- Windows_Client

- Windows_Server
ConfigurationSets Contiene una colección de valores que representa los valores del sistema o de la configuración de la aplicación.
AvailabilitySetName Especifica el nombre de una colección de máquinas virtuales.
DataVirtualHardDisks Contiene los parámetros que se usan para agregar un disco de datos a una máquina virtual.
OSVirtualHardDisk Contiene los parámetros utilizados para crear el disco del sistema operativo para una máquina virtual.
RoleSize Especifica el tamaño de la instancia de rol.
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 servicio debe estar instalado.

Los valores posibles son:

- true

- false
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.

ConfigurationSets

Contiene una colección de objetos que proporcionan el sistema o datos de la aplicación.

Nombre del elemento Descripción
ConfigurationSetType Especifica el tipo de configuración para el conjunto de configuración. Esto está siempre establecido actualmente en NetworkConfiguration.
InputEndpoints Contiene una colección de extremos externos para una máquina virtual.
SubnetNames Contiene una lista de nombres de subred de red virtual a la que pertenece la implementación.
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 PublicIPs elemento solo está disponible con la versión 2014-05-01 o posterior.
NetworkInterfaces Opcional, un conjunto de interfaces de red secundarias. El número de interfaces de red secundarias permitidas depende del tamaño de la máquina virtual.

El elemento NetworkInterfaces solamente se encuentra disponible si usa la versión 01-08-2014 o versiones posteriores.
StaticVirtualNetworkIPAddress Especifica la dirección IP interna para la máquina virtual en una red virtual. Si se especifica este elemento, el elemento SubnetNames contendrá solo una subred. La dirección IP especificada en este elemento pertenece a la subred definida en SubnetNames.

El StaticVirtualNetworkIPAddress elemento solo está disponible con la versión 2013-11-01 o posterior.

InputEndpoints

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

Nombre del elemento Descripción
LoadBalancedEndpointSetName Especifica un nombre para un conjunto de extremos de carga equilibrada. Este elemento se muestran únicamente para las implementaciones de máquina virtual.
LocalPort Especifica el puerto interno en el que la máquina virtual escucha para servir al extremo. Este elemento se muestran únicamente para las implementaciones de máquina virtual.
Nombre Especifica el nombre para el extremo externo. Este elemento se muestran únicamente para las implementaciones de máquina virtual.
Port Especifica el puerto externo para el extremo.
LoadBalancerProbe Contiene la configuración del extremo que el equilibrador de carga de Azure utiliza para supervisar la disponibilidad de una máquina virtual antes de reenviar el tráfico al extremo.
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 LoadBalancerName elemento solo está disponible con la versión 2014-05-01 o posterior.
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 IdleTimeoutInMinutes elemento solo está disponible con la versión 2014-06-01 o posterior.
Protocolo Especifica el protocolo de transporte para el extremo externo.

Los valores posibles son:

- TCP

- UDP
Vip Especifica la dirección IP virtual del extremo.

LoadBalancerProbe

Contiene la configuración del extremo que el equilibrador de carga de Azure utiliza para supervisar la disponibilidad de una máquina virtual antes de reenviar el tráfico al extremo.

Nombre del elemento Descripción
Path Especifica el nombre de ruta relativa para inspeccionar a fin de determinar el estado de disponibilidad. Si el protocolo está establecido en TCP, este valor debe ser NULL.

Ejemplo:

path

El sondeo usará https://example.com/path para realizar el sondeo.
Port Especifica el puerto que usar para inspeccionar el estado de disponibilidad.
Protocolo Especifica el protocolo que usar para inspeccionar el estado de disponibilidad.

Los valores posibles son:

- HTTP

- TCP

Dns

Especifica la configuración personalizada de DNS para la implementación.

Nombre del elemento Descripción
Nombre Especifica el nombre del servidor DNS.
Dirección Especifica la dirección IP del servidor DNS.

ExtendedProperties

Especifica las propiedades utilizadas para proporcionar más información sobre una implementación.

Nombre del elemento Descripción
Nombre Especifica el nombre de una propiedad asociada a la implementación.
Value Especifica el valor de una propiedad asociada a la implementación.

PersistentVMDowntime

Especifica información sobre cuando se ha activado y se ha detenido la máquina virtual.

Nombre del elemento Descripción
StartTime Especifica la hora a la que la máquina virtual se inició.
EndTime Especifica la hora a la que la máquina virtual se detuvo.
Estado Especifica el estado de la máquina virtual.

VirtualIPs

Contiene las direcciones IP virtuales que se especifican para la implementación.

Nombre del elemento Descripción
Dirección Especifica la dirección IP virtual de la implementación.
IsReserved Indica si la dirección IP virtual está reservada.

Los valores posibles son:

- true

- false
ReservedIPName Especifica el nombre de una dirección IP reservada que se asignó a la implementación.
Tipo Especifica un valor de Private si la dirección IP virtual está asociada a un equilibrador de carga interno.

SubnetNames

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

Nombre del elemento Descripción
SubnetName Necesario. Especifica el nombre de la subred a la que pertenece la máquina virtual.

DataVirtualHardDisks

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

Nombre del elemento Descripción
HostCaching Especifica el comportamiento de la plataforma de almacenamiento en caché del blob del disco de datos para la eficacia de lectura/escritura.

Los valores posibles son:

- None

- ReadOnly

- ReadWrite

El almacén predeterminado es ReadOnly.
DiskName Especifica el nombre del VHD que se va a utilizar para crear el disco de datos para la máquina virtual.
Lun Especifica el número de unidad lógica (LUN) del disco de datos. El LUN especifica la zona en la que la unidad de datos aparece cuando se monta para su uso por la máquina virtual. Este elemento se muestra únicamente cuando más de un disco de datos se adjunta a una máquina virtual.

Los valores válidos son 0 – 31.
LogicalDiskSizeInGB Especifica el tamaño, en GB, del disco para adjuntarlo a la máquina virtual.
MediaLink Especifica la ubicación en el almacén de Azure del VHD asociado al disco.

Ejemplo:

http://example.blob.core.windows.net/disks/mydatadisk.vhd|
IOType Esta propiedad identifica el tipo de la cuenta de almacenamiento para el VHD de copia.

Si el disco duro virtual de respaldo está en una cuenta de almacenamiento aprovisionada, se devuelve "Aprovisionado" en caso contrario, se devuelve "Standard". Nota: Esta plataforma de Azure rellena este valor cuando se crea el disco, no por el usuario.

Esta propiedad solo se devuelve con un encabezado de versión de 2014-10-01 o más reciente.

OSVirtualHardDisk

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

Nombre del elemento Descripción
HostCaching Especifica el comportamiento de la plataforma de almacenamiento en caché del blob del disco del sistema operativo para la eficacia de lectura/escritura.

Los valores posibles son:

- ReadOnly

- ReadWrite
DiskName Especifica el nombre de una imagen del sistema operativo en el repositorio de imágenes.
MediaLink Especifica la ubicación en el almacén de Azure del VHD asociado al disco del sistema operativo.
SourceImageName Especifica el nombre de la imagen de origen que se utilizó para crear el disco del sistema operativo.
SO Especifica el sistema operativo que se está ejecutando en la máquina virtual.

Los valores posibles son:

- Windows

- Linux
RemoteSourceImageLink Especifica un URI de la ubicación donde se almacena una imagen de SO que se usó para crear la máquina virtual. Esta ubicación puede ser una ubicación distinta que los repositorios de usuario o plataforma en Azure. 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. Si especificas una ruta de acceso a una imagen con este elemento, se crea un VHD asociado y debes usar el elemento MediaLink para especificar la ubicación del almacenamiento donde se encontrará el VHD. Si se usa este elemento, no se usa SourceImageName.

El RemoteSourceImageLink elemento solo está disponible con la versión 2014-05-01 o posterior.
IOType Esta propiedad identifica el tipo de la cuenta de almacenamiento para el VHD de copia.

Si el VHD de copia está en una cuenta de almacenamiento aprovisionado, se devuelve "Aprovisionado" y en caso contrario se devuelve "Estándar".

Nota: Esta plataforma de Azure rellena este valor cuando se crea el disco, no por el usuario.

Esta propiedad solo se devuelve con un encabezado de versión de 2014-10-01 o más reciente.

ResourceExtensionReferences

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 Necesario. Especifica las propiedades de una extensión de recursos que se debe instalar en la máquina virtual.
ReferenceName Necesario. Especifica el nombre de referencia de la extensión de recursos.
Publicador Necesario. Especifica el nombre del publicador que creó la extensión de recursos. Puede usar Enumerar extensiones de recursos para buscar el nombre del publicador de una extensión de recursos.
Nombre Necesario. Especifica el nombre de la extensión de recursos. Puede usar List Resource Extensions (Enumerar extensiones de recursos ) para buscar los nombres de las extensiones de recursos disponibles.
Versión Necesario. Especifica la versión de la extensión de recursos. Puede usar List Resource Extension Versions (Enumerar versiones de extensión de recursos ) para buscar la versión de la extensión de recursos.
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

El valor predeterminado es Enable.

ResourceExtensionParameterValues

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 Necesario. Especifica la clave, el valor y el tipo del parámetro.
Clave Necesario. Especifica la clave del parámetro.
Value Necesario. Especifica el valor codificado en base 64 del parámetro.
Tipo Necesario. Especifica el tipo de la extensión de recursos.

Los valores posibles son:

- Public

- Private

Si este valor se establece Privateen , Get Deployment no devolverá el parámetro . Solo puede especificar un parámetro público y un parámetro privado para un máximo de dos parámetros.

ExtensionConfiguration

Contiene las extensiones que se agregaron al servicio en la nube.

Nombre del elemento Descripción
AllRoles Especifica una lista de extensiones que se aplican a todos los roles en una implementación.
Extensión Especifica una extensión que debe implementarse en un rol en un servicio en la nube.
NamedRoles Especifica una lista de extensiones que se aplican a todos los roles especificados en una implementación.

Extensión

Especifica una extensión que debe implementarse en un rol en un servicio en la nube.

Nombre del elemento Descripción
Identificador Especifica el identificador de la extensión. Se crea el identificador cuando la extensión se agrega al servicio en la nube. Puede encontrar el identificador de una extensión que se agregó a un servicio en la nube mediante extensiones de lista.
SequenceNumber Especifica el número de la última configuración aplicada a la extensión. Azure asigna este número, que aumenta con cada cambio de configuración.

El SequenceNumber elemento solo está disponible con la versión 2014-06-01 o posterior.
State Opcional. Especifica el estado de la extensión. Este elemento se aplica solo a extensiones configuradas con JSON.

Los valores posibles son:

- Enable

- Disable

- Uninstall

El valor predeterminado es Enable.

El State elemento solo está disponible con la versión 2014-06-01 o posterior.

NamedRoles

Especifica una lista de extensiones que se aplican a todos los roles especificados en una implementación.

Nombre del elemento Descripción
Role Especifica un rol específico al que se agrega la extensión.
RoleName Especifica el nombre del rol.
Extensión Especifica una extensión que debe implementarse en un rol en un servicio en la nube.

GuestAgentStatus

Especifica la información sobre el agente que está instalado en una instancia.

Nombre del elemento Descripción
ProtocolVersion Especifica la versión del protocolo que usa el agente para informar del estado.
Timestamp Especifica la hora UTC cuando se informó del estado.
GuestAgentVersion Especifica la versión del agente instalado en la instancia.
Estado Especifica el estado del agente.

Los valores posibles son:

- Ready

- NotReady
FormattedMessage Especifica un mensaje de estado localizado.

FormattedMessage

Especifica un mensaje de estado localizado.

Nombre del elemento Descripción
Idioma Especifica el idioma del mensaje.
Mensaje Especifica el mensaje.

ResourceExtensionStatusList

Especifica la información sobre las extensiones que están instaladas en una instancia.

Nombre del elemento Descripción
ResourceExtensionStatus Especifica la información sobre una extensión específica.

ResourceExtensionStatus

Especifica la información sobre una extensión específica.

Nombre del elemento Descripción
HandlerName Especifica el nombre de la extensión.
Versión Especifica la versión de la extensión.
Estado Especifica el estado de la extensión.

Los valores posibles son:

- Installing

- Ready

- NotReady

- Unresponsive
Código Especifica el código de estado que devuelve la extensión.
FormattedMessage Especifica un mensaje de estado localizado.
ExtensionSettingStatus Especifica la información de estado sobre la configuración que se pasó a la extensión.

PublicIPs

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 Necesario. Especifica una dirección IP pública adicional que se puede usar para comunicarse con la máquina virtual.
Nombre Necesario. Especifica el nombre de la dirección IP pública.
Dirección Necesario. Especifica la dirección IP 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 IdleTimeoutInMinutes elemento solo está disponible con la versión 2014-06-01 o posterior.
DomainNameLabel Opcional. Especifica la etiqueta de nombre de dominio para la dirección IP pública.

El DomainNameLabel elemento solo está disponible con la versión 2015-03-01 o posterior.
Fqdn Opcional. Especifica un FQDN registrado para esta dirección IP pública.

NetworkInterfaces

Contiene un conjunto de interfaces de red secundarias.

Nombre del elemento Descripción
NetworkInterface Necesario. Especifica una interfaz de red secundaria.
Nombre Requerido, especifica el nombre de la interfaz de red secundaria.
IPConfigurations Necesario. Especifica un conjunto de configuraciones de direcciones IP para una interfaz de red secundaria.

IPConfigurations

Especifica un conjunto de configuraciones de direcciones IP para una interfaz de red secundaria.

Nombre del elemento Descripción
IPConfiguration Necesario. Especifica una configuración de dirección IP para una interfaz de red secundaria.

Actualmente solo una configuración de dirección IP es compatible con una interfaz de red secundaria.
SubnetName Necesario. Especifica el nombre de la subred de red virtual a la que pertenece esta configuración de dirección IP.
Dirección Requerido, especifica la dirección IP interna que se configura para una interfaz de red secundaria.

LoadBalancers

Contiene una lista de equilibradores de carga internos que se pueden asignar a extremos de entrada.

Nombre del elemento Descripción
LoadBalancer Necesario. Especifica los atributos de un equilibrador de carga interno.
Nombre Necesario. Especifica el nombre del equilibrador de carga interno.
FrontendIpConfiguration Necesario. Especifica la configuración de la dirección IP virtual proporcionada por el equilibrador de carga.
Tipo Necesario. Especifica el tipo de dirección IP virtual proporcionada por el equilibrador de carga. El único valor admitido es Private.
SubnetName Es obligatorio si la implementación existe en una red virtual y se asigna StaticVirtualNetworkIPAddress. Especifica la subred de la red virtual que usa el equilibrador de carga. La dirección IP virtual administrada por el equilibrador de carga está contenida en esta subred.
StaticVirtualNetworkIPAddress Opcional. Especifica una dirección IP virtual que el equilibrador de carga usa de la subred en la máquina virtual.

ExtensionSettingStatus

Especifica la información de estado sobre la configuración que se pasó a la extensión.

Nombre del elemento Descripción
Timestamp Especifica la hora UTC cuando se informó del estado.
Nombre Especifica el nombre de la configuración que se pasó a la extensión.
Operación Especifica la operación que realizó la extensión con la configuración.
Estado Especifica el estado de la operación.

Los valores posibles son:

- transitioning

- error

- success

- warning
Código Especifica el código de estado de la operación.
FormattedMessage Especifica un mensaje de estado localizado.
SubStatusList Contiene una lista de información adicional del estado, si existe.

SubStatusList

Contiene una lista de información adicional del estado, si existe.

Nombre del elemento Descripción
SubStatus Contiene información sobre mensajes adicionales de estado devueltos por la extensión.
Nombre Especifica el identificador de estado.
Estado Especifica el estado de la operación.

Los valores posibles son:

- transitioning

- error

- success

- warning
FormattedMessage Especifica un mensaje de estado localizado.

Comentarios

Para obtener los nombres de los servicios en la nube de la suscripción, puede usar List Cloud Services.