Obtener implementación

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

Solicitud

La Get Deployment solicitud se puede usar para recuperar eventos de implementación para una sola 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 implementado en el entorno de producción, puede obtener el nombre único realizando una solicitud a …/deploymentslots/production. La respuesta incluye un Name elemento para el servicio en la nube. Ese Name valor de elemento se puede usar para realizar una solicitud si …/deployments/<Name> desea recuperar información sobre esa implementación específica.

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

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

Parámetros de URI

Ninguno.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud.

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

Cuerpo de la solicitud

Ninguno.

Respuesta

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 de esta operación incluye los siguientes encabezados. La respuesta también puede incluir encabezados HTTP estándar adicionales.

Encabezado de respuesta	Descripción
x-ms-request-id	Valor que identifica de forma única una solicitud realizada en 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 la respuesta.

Nombre del elemento	Descripción
Nombre	Especifica el nombre de la implementación.
DeploymentSlot	Especifica el entorno en el que se implementa el servicio en la nube, ya sea staging o production.
PrivateID (Identificación privada)	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 utilizar para fines de seguimiento.
URL	Especifica la dirección URL que se utiliza para acceder al servicio en la nube. Por ejemplo, si el nombre del servicio es MyService, puede acceder al acceso al servicio llamando 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 (Estado de actualización)	Contiene la configuración de cómo 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 elemento solo está disponible con la UpgradeDomainCount versión 2011-06-01 o superior.
Lista de roles	Contiene la lista de roles de la implementación.
Versión del SDK	Especifica la versión del SDK que se usó para generar el paquete para la implementación. El elemento solo está disponible con la SdkVersion versión 2011-06-01 o superior.
Bloqueado	True para evitar una nueva operación de escritura en la implementación mientras se está actualizando; de lo contrario false. El elemento solo está disponible con la Locked versión 2011-06-01 o superior.
RollbackAllowed (ReversiónPermitida)	True Si la RollbackDeploymentUpdateOrUpgrade operación está permitida en la implementación; de lo contrario false. El elemento solo está disponible con la RollbackAllowed versión 2011-06-01 o superior.
CreatedTime (Tiempo creado)	Especifica la hora a la que se creó la implementación.
Última Hora de Modificación	Especifica la última vez que se modificó la implementación.
Nombre de la Red Virtual	Especifica el nombre de la red virtual a la que se conecta la máquina virtual. El elemento solo está disponible con la VirtualNetworkName versión 2012-03-01 o superior.
DNS	Contiene la configuración de DNS especificada para la implementación. El elemento solo está disponible con la Dns versión 2012-03-01 o superior.
Balanceadores de carga	Contiene una lista de equilibradores de carga internos que se pueden asignar a los puntos de conexión de entrada. El elemento solo está disponible con la LoadBalancers versión 2014-05-01 o superior.
extendedProperties	Especifica las propiedades que se utilizan para proporcionar más información sobre una implementación.
PersistentVMDowntime	Especifica información sobre cuándo se ha iniciado y detenido la máquina virtual. El elemento solo está disponible con la PersistentVMDowntime versión 2012-03-01 o superior.
IPs virtuales	Especifica las direcciones IP virtuales para la implementación. El elemento solo está disponible con la VirtualIPs versión 2012-03-01 o superior.
ExtensionConfiguration	Especifica una extensión que se agrega al servicio en la nube. En Azure, un proceso se puede ejecutar como una extensión de un servicio en la nube. Puede agregar una extensión a un servicio en la nube mediante Agregar extensión y puede agregar la extensión a la implementación mediante Actualizar implementación o Cambiar configuración de implementación. El elemento solo está disponible con la ExtensionConfiguration versión 2013-03-01 o superior.
ReservadoIPName	Especifica el nombre de una dirección IP reservada que se va a asignar a la implementación. El elemento solo está disponible con la ReservedIPName versión 2014-05-01 o superior.
InternalDnsSuffix	Especifica el sufijo de nombre de dominio para la resolución de nombres interna que Azure asigna automáticamente. A todas las instancias de máquinas virtuales de una implementación se les asigna automáticamente el sufijo de nombre de dominio. A todas las instancias de roles web o roles de trabajo de una implementación se les asigna automáticamente el sufijo de nombre de dominio cuando al menos a un rol se le asigna un nombre de equipo mediante el vmName atributo. A una implementación que se encuentra en una red virtual con un servidor DNS configurado no se le asigna un sufijo de nombre de dominio interno. El elemento solo está disponible con la InternalDnsSuffix versión 2013-11-01 o superior.

RoleInstanceList

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

Nombre del elemento	Descripción
NombreDelRol	Especifica el nombre del rol.
NombreDeInstancia	Especifica el nombre de una instancia de rol específica, si se está ejecutando una instancia del 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 una instancia de rol se ha iniciado y está lista para ser utilizada. BusyRole: - Indica que una instancia de rol no está disponible para las solicitudes. Normalmente, este estado se genera mientras se crea o se detiene 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. Este es el estado final del proceso de apagado y no se deben recibir otros mensajes de estado después StoppedVMde . 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á causando que se bloquee o impidiendo que se inicie, y debe corregirse antes de que se pueda iniciar la instancia de rol. Los InstanceStateDetails campos y InstanceErrorCode pueden contener información sobre el error de rol que causó 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 puede generarse después de que se reciban los StartingRole estados pares ReadyRole . El problema en el rol debe encontrarse y corregirse antes de que se pueda iniciar el rol. Los InstanceStateDetails campos y InstanceErrorCode pueden contener información sobre el error de rol que causó este estado, lo que puede ser útil para identificar y depurar el problema. El CyclingRole elemento solo se devuelve si la versión es 2014-02-01 o inferior. FailedStartingRole: - El rol ha fallado continuamente. Este estado indica que hay un problema con la instancia de rol que impide que se inicie y puede generarse después de que el proceso devuelva StartingRole. El problema en el rol debe encontrarse y corregirse antes de que se pueda iniciar el rol. Los InstanceStateDetails campos y InstanceErrorCode pueden contener información sobre el error de rol que causó este estado, lo que puede ser útil para identificar y depurar el problema. FailedStartingVM: - Indica que una máquina virtual ha fallado continuamente al iniciarse. Este estado lo genera Azure y no indica un error con el rol. Puede generarse después del StartingRole estado. UnresponsiveRole: - Indica que se ha agotado el tiempo de espera de una instancia de rol antes de recibir un mensaje de estado y no responde a las solicitudes. StoppedDeallocated: - Indica que se ha detenido una instancia de rol y que se han liberado todos los recursos asignados. Esto detiene la facturación de la instancia de rol. Las instancias de rol que tienen un estado de solo se devuelven en la lista de instancias de StoppedDeallocated rol si la versión es 2013-06-01 o superior. Si todas las instancias de rol de la implementación tienen un estado de StoppedDeallocated, la implementación no se devuelve si la versión es inferior a 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 2014-05-01 o superior.
ExtendedInstanceStatus	Especifica detalles de estado adicionales si están disponibles para la implementación. Si se copia un blob 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 elemento solo está disponible con la ExtendedInstanceStatus versión 2015-05-01 o superior.
InstanceUpgradeDomain	Especifica el dominio de actualización al que pertenece la instancia de rol. Durante una implementación de actualización, todos los roles del mismo dominio de actualización se actualizan al mismo tiempo. El elemento solo está disponible con la InstanceUpgradeDomain versión 2011-06-01 o superior.
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 vulnerables a la falla de una sola pieza de hardware. El elemento solo está disponible con la InstanceFaultDomain versión 2011-06-01 o superior.
Tamaño de instancia	Especifica el tamaño de la instancia de rol. El elemento solo está disponible con la InstanceSize versión 2011-06-01 o superior.
InstanceStateDetails	Proporciona una instantánea del estado de la instancia de rol en el momento en que se llamó a la operación. El elemento solo está disponible con la InstanceStateDetails versión 2011-10-01 o superior.
InstanceErrorCode	El código de error del último inicio de rol. En el caso de las máquinas virtuales, los códigos de error son: - WaitTimeout: la instancia de rol no se comunicó en 25 minutos. Normalmente, esto indica 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 asistencia para obtener asistencia adicional. En el caso de 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 a resolver errores. Normalmente, este campo estará vacío. El elemento solo está disponible con la InstanceErrorCode versión 2011-10-01 o superior.
Dirección IP	Especifica la dirección IP de la instancia de rol (DIP). El elemento solo está disponible con la IpAddress versión 2012-03-01 o superior.
InstanceEndpoints	Contiene la lista de puntos de conexión de instancia para el rol.
Estado de energía	Estado de ejecución de la máquina virtual. Los valores posibles son: - Starting - Started - Stopping - Stopped - Unknown
Nombre del host	Especifica el nombre de host DNS del servicio en la nube en el que se ejecuta la instancia de rol. Este elemento solo se muestra para las implementaciones de máquinas virtuales.
RemoteAccessCertificateThumbprint	Especifica la huella digital del certificado de servidor RDP (en Windows) o del certificado de servidor SSH (en Linux). La huella digital solo se usa para las máquinas virtuales que se han creado a partir de una imagen. El elemento solo está disponible con la RemoteAccessCertificateThumbprint versión 2012-08-01 o superior.
GuestAgentStatus	Especifica información sobre el agente que está instalado en una instancia. El elemento solo está disponible con la GuestAgentStatus versión 2014-04-01 o superior.
ResourceExtensionStatusList	Especifica información sobre las extensiones que se instalan en una instancia. El elemento solo está disponible con la ResourceExtensionStatusList versión 2014-04-01 o superior.
IPs públicas	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 solo está disponible con la PublicIPs versión 2014-05-01 o superior.
Interfaces de red	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 solo está disponible con la versión 2014-08-01 o posterior.

InstanceEndpoints

Contiene la lista de puntos de conexión de instancia para el rol.

Nombre del elemento	Descripción
Nombre	Especifica el nombre del punto de conexión.
Vip	Especifica la dirección IP virtual del punto de conexión. El elemento solo está disponible con la Vip versión 2011-06-01 o superior.
Puerto Público	Especifica el puerto externo que utiliza el punto de conexión.
Puerto local	Especifica el puerto interno que utiliza el punto de conexión.
Protocolo	Especifica el protocolo de tráfico en el punto de conexión.

UpgradeStatus (Estado de actualización)

Especifica información sobre una actualización que se produce en la implementación.

Nombre del elemento	Descripción
Tipo de actualización	Especifica el tipo de 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 con un índice de base cero: el primer dominio de actualización tiene un ID de 0, el segundo tiene un ID de 1, y así sucesivamente.

Lista de roles

Contiene la lista de roles de la implementación.

Nombre del elemento	Descripción
NombreDelRol	Especifica el nombre del rol.
OsVersion	Especifica la versión del sistema operativo en el que se ejecutan las instancias de rol.
Tipo de Rol	Especifica el tipo de rol. Este elemento solo se muestra para las implementaciones de máquinas virtuales y, de forma predeterminada, es PersistentVMRole.
Tipo de licencia	Especifica que la imagen o el disco que se usa tenían licencias locales. 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 representan los valores de configuración del sistema o de la aplicación.
AvailabilitySetName	Especifica el nombre de una colección de máquinas virtuales.
DatosVirtualDiscos Duros	Contiene los parámetros que se usan para agregar un disco de datos a una máquina virtual.
OSVirtualHardDisk	Contiene los parámetros que se utilizan para crear el disco del sistema operativo para una máquina virtual.
RoleSize (Tamaño de rol)	Especifica el tamaño de la instancia de rol.
ProvisionGuestAgent	Opcional. Indica si el agente de máquina virtual 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 datos del sistema o de la aplicación.

Nombre del elemento	Descripción
ConfigurationSetType	Especifica el tipo de configuración para el conjunto de configuraciones. Actualmente, siempre se establece en NetworkConfiguration.
PuntosDeEntrada	Contiene una colección de puntos de conexión externos para una máquina virtual.
Nombres de subred	Contiene una lista de nombres de subred de red virtual a los que pertenece la implementación.
IPs públicas	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 solo está disponible con la PublicIPs versión 2014-05-01 o superior.
Interfaces de red	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 solo está disponible con la versión 2014-08-01 o posterior.
StaticVirtualNetworkIPAddress	Especifica la dirección IP interna de la máquina virtual de 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 elemento solo está disponible con la StaticVirtualNetworkIPAddress versión 2013-11-01 o superior.

InputEndpoints

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

Nombre del elemento	Descripción
LoadBalancedEndpointSetName	Especifica el nombre de un conjunto de extremos con equilibrio de carga. Este elemento solo se muestra para las implementaciones de máquinas virtuales.
Puerto local	Especifica el puerto interno en el que la máquina virtual está escuchando para servir al punto de conexión. Este elemento solo se muestra para las implementaciones de máquinas virtuales.
Nombre	Especifica el nombre del punto de conexión externo. Este elemento solo se muestra para las implementaciones de máquinas virtuales.
Puerto	Especifica el puerto externo para usar para el punto de conexión.
LoadBalancerProbe	Contiene la configuración del punto de conexión que el equilibrador de carga de Azure usa para supervisar la disponibilidad de una máquina virtual antes de reenviar el tráfico al punto de conexión.
LoadBalancerName	Opcional. Especifica el nombre del equilibrador de carga interno asociado a este punto de conexión. El nombre del equilibrador de carga interno se especifica en LoadBalancers. El elemento solo está disponible con la LoadBalancerName versión 2014-05-01 o superior.
IdleTimeoutInMinutes	Opcional. Especifica el tiempo de espera para la conexión inactiva TCP. 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 solo está disponible con la IdleTimeoutInMinutes versión 2014-06-01 o superior.
Protocolo	Especifica el protocolo de transporte del punto de conexión. Los valores posibles son: - TCP - UDP
Vip	Especifica la dirección IP virtual del punto de conexión.

LoadBalancerProbe

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

Nombre del elemento	Descripción
Ruta	Especifica el nombre de ruta de acceso relativo que se va a inspeccionar para determinar el estado de disponibilidad. Si Protocol se establece en TCP, este valor debe ser NULL. Ejemplo: camino La sonda se utilizará https://example.com/path para realizar la sonda.
Puerto	Especifica el puerto que se va a utilizar para inspeccionar el estado de disponibilidad.
Protocolo	Especifica el protocolo que se va a utilizar para inspeccionar el estado de disponibilidad. Los valores posibles son: - HTTP - TCP

DNS

Especifica la configuración de DNS personalizada que se especifica 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 que se utilizan 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.
Importancia	Especifica el valor de una propiedad asociada a la implementación.

PersistentVMDowntime

Especifica información sobre cuándo se ha iniciado y detenido la máquina virtual.

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

IPs virtuales

Contiene las direcciones IP virtuales especificadas 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
ReservadoIPName	Especifica el nombre de una dirección IP reservada que se asignó a la implementación.
Tipo	Especifica un valor de si la dirección IP virtual está asociada a un equilibrador de Private carga interno.

Nombres de subred

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

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

DatosVirtualDiscos Duros

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 almacenamiento en caché de la plataforma del blob en disco de datos para la eficiencia de lectura y escritura. Los valores posibles son: - None - ReadOnly - ReadWrite El almacén predeterminado es ReadOnly.
NombreDelDisco	Especifica el nombre del disco duro virtual que se va a utilizar para crear el disco de datos de la máquina virtual.
Lun	Especifica el número de unidad lógica (LUN) para el disco de datos. El LUN especifica la ranura en la que aparece la unidad de datos cuando se monta para su uso por parte de la máquina virtual. Este elemento solo se muestra cuando hay más de un disco de datos conectado a una máquina virtual. Los valores válidos son de 0 a 31.
LogicalDiskSizeInGB	Especifica el tamaño, en GB, del disco que se va a conectar a la máquina virtual.
Enlace de medios	Especifica la ubicación en el almacenamiento de Azure del disco duro virtual asociado al disco. Ejemplo: http://example.blob.core.windows.net/disks/mydatadisk.vhd|
IOType	Esta propiedad identifica el tipo de cuenta de almacenamiento para el disco duro virtual de respaldo. Si el disco duro virtual de respaldo está en una cuenta de almacenamiento aprovisionado, se devuelve "Aprovisionado", de lo contrario, se devuelve "Estándar". Nota: Este valor se rellena mediante la plataforma Azure 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 posterior.

OSVirtualHardDisk

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

Nombre del elemento	Descripción
HostCaching	Especifica el comportamiento de almacenamiento en caché de la plataforma del blob en disco del sistema operativo para la eficacia de lectura y escritura. Los valores posibles son: - ReadOnly - ReadWrite
NombreDelDisco	Especifica el nombre de una imagen del sistema operativo en el repositorio de imágenes.
Enlace de medios	Especifica la ubicación en el almacenamiento de Azure del disco duro virtual asociado al disco del sistema operativo.
SourceImageName (Nombre de la imagen)	Especifica el nombre de la imagen de origen que se utilizó para crear el disco del sistema operativo.
Sistema operativo	Especifica el sistema operativo que se está ejecutando en la máquina virtual. Los valores posibles son: - Windows - Linux
RemoteSourceImageLink	Especifica un URI en la ubicación donde se almacena una imagen del sistema operativo que se usó para crear la máquina virtual. Esta ubicación puede ser una ubicación diferente a la de los repositorios de usuario o plataforma en Azure. Una imagen siempre está asociada a un disco duro virtual, que es un archivo .vhd almacenado como un blob en páginas en una cuenta de almacenamiento. Si especifica la ruta de acceso a una imagen con este elemento, se crea un disco duro virtual asociado y debe usar el elemento MediaLink para especificar la ubicación en el almacenamiento donde se ubicará el disco duro virtual. Si se usa este elemento, no se usa SourceImageName. El elemento solo está disponible con la RemoteSourceImageLink versión 2014-05-01 o superior.
IOType	Esta propiedad identifica el tipo de cuenta de almacenamiento para el disco duro virtual de respaldo. Si el disco duro virtual de respaldo está en una cuenta de almacenamiento aprovisionado, se devuelve "Aprovisionado", de lo contrario, se devuelve "Estándar". Nota: Este valor se rellena mediante la plataforma Azure 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 posterior

ResourceExtensionReferences

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

Nombre del elemento	Descripción
ResourceExtensionReference	Obligatorio. Especifica las propiedades de una extensión de recursos que se debe instalar en la máquina virtual.
Nombre de referencia	Obligatorio. Especifica el nombre de referencia de la extensión de recurso.
Publicador	Obligatorio. Especifica el nombre del publicador que creó la extensión de recurso. Puede usar Extensiones de recursos de lista para buscar el nombre del editor de una extensión de recurso.
Nombre	Obligatorio. Especifica el nombre de la extensión de recurso. Puede usar Extensiones de recursos de lista para buscar los nombres de las extensiones de recursos disponibles.
Versión	Obligatorio. Especifica la versión de la extensión de recurso. Puede usar Lista de versiones de extensión de recursos para buscar la versión de la extensión de recurso.
ResourceExtensionParameterValues	Opcional. Contiene una colección de parámetros que se pasan a la extensión de recursos cuando se instala.
Estado	Opcional. Especifica el estado de la extensión de recurso. 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	Obligatorio. Especifica la clave, el valor y el tipo del parámetro.
Clave	Obligatorio. Especifica la clave del parámetro.
Importancia	Obligatorio. Especifica el valor codificado en base 64 del parámetro.
Tipo	Obligatorio. Especifica el tipo de la extensión de recurso. Los valores posibles son: - Public - Private Si este valor se establece en Private, 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 extensiones que se agregan al servicio en la nube.

Nombre del elemento	Descripción
Todos los roles	Especifica una lista de extensiones que se aplican a todos los roles de una implementación.
Extensión	Especifica una extensión que se va a implementar en un rol de un servicio en la nube.
Roles con nombre	Especifica una lista de extensiones que se aplican a roles específicos de una implementación.

Extensión

Especifica una extensión que se va a implementar en un rol de un servicio en la nube.

Nombre del elemento	Descripción
Identificación	Especifica el identificador de la extensión. El identificador se crea 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.
Número de secuencia	Especifica el número de la última configuración aplicada a la extensión. Azure asigna este número y se incrementa con cada cambio de configuración. El elemento solo está disponible con la SequenceNumber versión 2014-06-01 o superior.
Estado	Opcional. Especifica el estado de la extensión. Este elemento solo se aplica a las extensiones configuradas en JSON. Los valores posibles son: - Enable - Disable - Uninstall El valor predeterminado es Enable. El elemento solo está disponible con la State versión 2014-06-01 o superior.

Roles con nombre

Especifica una lista de extensiones que se aplican a roles específicos de una implementación.

Nombre del elemento	Descripción
Rol	Especifica un rol específico al que se agrega la extensión.
NombreDelRol	Especifica el nombre del rol.
Extensión	Especifica una extensión que se va a implementar en un rol de un servicio en la nube.

GuestAgentStatus

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

Nombre del elemento	Descripción
VersiónDelProtocolo	Especifica la versión del protocolo que utiliza el agente para los informes de estado.
Marca de tiempo	Especifica la hora UTC en la que se notificó el estado.
GuestAgentVersion	Especifica la versión del agente que está instalada en la instancia.
Estado	Especifica el estado del agente. Los valores posibles son: - Ready - NotReady
Mensaje Formateado	Especifica un mensaje de estado localizado.

Mensaje Formateado

Especifica un mensaje de estado localizado.

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

ResourceExtensionStatusList

Especifica información sobre las extensiones que se instalan en una instancia.

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

ResourceExtensionStatus

Especifica 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 devuelto por la extensión.
Mensaje Formateado	Especifica un mensaje de estado localizado.
ExtensionSettingStatus	Especifica información de estado sobre la configuración que se pasó a la extensión.

IPs públicas

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
IP Pública	Obligatorio. Especifica una dirección IP pública adicional que se puede usar para comunicarse con la máquina virtual.
Nombre	Obligatorio. Especifica el nombre de la dirección IP pública.
Dirección	Obligatorio. Especifica la dirección IP de la dirección IP pública.
IdleTimeoutInMinutes	Opcional. Especifica el tiempo de espera para la conexión inactiva TCP. 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 solo está disponible con la IdleTimeoutInMinutes versión 2014-06-01 o superior.
Etiqueta de nombre de dominio	Opcional. Especifica la etiqueta de nombre de dominio para la dirección IP pública. El elemento solo está disponible con la DomainNameLabel versión 2015-03-01 o superior.
Nombre de dominio completo	Opcional. Especifica un FQDN registrado para esta dirección IP pública.

Interfaces de Red

Contiene un conjunto de interfaces de red secundarias.

Nombre del elemento	Descripción
Interfaz de red	Obligatorio. Especifica una interfaz de red secundaria.
Nombre	Obligatorio, especifica el nombre de la interfaz de red secundaria.
Figuras de la CIP	Obligatorio. Especifica un conjunto de configuraciones de direcciones IP para una interfaz de red secundaria.

Figuras de la CIP

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

Nombre del elemento	Descripción
Figuración de la CIP	Obligatorio. Especifica una configuración de dirección IP para una interfaz de red secundaria. Actualmente, solo se admite una configuración de dirección IP para una interfaz de red secundaria.
Nombre de subred	Obligatorio. Especifica el nombre de la subred de red virtual a la que pertenece esta configuración de dirección IP.
Dirección	Obligatorio, especifica la dirección IP interna configurada para una interfaz de red secundaria.

Balanceadores de carga

Contiene una lista de equilibradores de carga internos que se pueden asignar a los puntos de conexión de entrada.

Nombre del elemento	Descripción
Balanceador de Carga	Obligatorio. Especifica los atributos de un equilibrador de carga interno.
Nombre	Obligatorio. Especifica el nombre del equilibrador de carga interno.
FrontendIpConfiguration	Obligatorio. Especifica la configuración de la dirección IP virtual que proporciona el equilibrador de carga.
Tipo	Obligatorio. Especifica el tipo de dirección IP virtual que proporciona el equilibrador de carga. El único valor permitido es Private.
Nombre de subred	Necesario si la implementación existe en una red virtual y se asigna una dirección 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 se encuentra en esta subred.
StaticVirtualNetworkIPAddress	Opcional. Especifica una dirección IP virtual específica que el equilibrador de carga usa desde la subred de la red virtual.

ExtensionSettingStatus

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

Nombre del elemento	Descripción
Marca de tiempo	Especifica la hora UTC en la que se notificó el estado.
Nombre	Especifica el nombre de la configuración que se pasó a la extensión.
Operación	Especifica la operación realizada por la extensión mediante 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.
Mensaje Formateado	Especifica un mensaje de estado localizado.
SubStatusList	Contiene una lista de información de estado adicional, si existe.

SubStatusList

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

Nombre del elemento	Descripción
Subestado	Contiene información sobre los mensajes de estado adicionales 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
Mensaje Formateado	Especifica un mensaje de estado localizado.

Observaciones

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