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 Private en , 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.