Ottenere la distribuzione
L'operazione Get Deployment
restituisce le informazioni di configurazione, lo stato e le proprietà di sistema per una distribuzione.
Richiesta
È possibile usare la richiesta Get Deployment
per recuperare gli eventi di distribuzione per uno slot di distribuzione singolo (gestione temporanea o produzione) o per un nome di distribuzione specifico. Per recuperare le informazioni su una distribuzione specifica, è innanzitutto necessario ottenere il nome univoco per la distribuzione. Questo nome univoco fa parte della risposta quando si effettua una richiesta per ottenere la distribuzione in uno slot di distribuzione.
Ad esempio, se è presente un servizio cloud distribuito nell'ambiente di produzione, è possibile ottenere il nome univoco effettuando a una richiesta a …/deploymentslots/production
. La risposta include un elemento Name
per il servizio cloud. Il valore dell'elemento Name
può essere usato per effettuare una richiesta a …/deployments/<Name>
se si desidera recuperare le informazioni su tale distribuzione specifica.
Per generare l'URI della richiesta, sostituire <subscription-id>
con l'ID sottoscrizione, <cloudservice-name>
con il nome del servizio cloud, <deployment-slot>
con staging
o production
o <deployment-name>
con il nome della distribuzione.
Metodo | URI richiesta |
---|---|
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> |
Parametri dell'URI
Nessuno.
Intestazioni richiesta
La tabella seguente descrive le intestazioni della richiesta.
Intestazione della richiesta | Descrizione |
---|---|
x-ms-version |
Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2009-10-01 o versione successiva. |
Corpo della richiesta
Nessuno.
Risposta
Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.
Codice di stato
Un'operazione completata correttamente restituisce 200 (OK).
Intestazioni della risposta
Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive.
Intestazione di risposta | Descrizione |
---|---|
x-ms-request-id |
Valore che identifica in modo univoco una richiesta eseguita nel servizio di gestione. |
Corpo della risposta
Nell'esempio seguente viene illustrato il formato del corpo della risposta:
<?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>
Nella tabella seguente vengono descritti gli elementi nel corpo della risposta.
Nome dell'elemento | Descrizione |
---|---|
Nome | Specifica il nome della distribuzione. |
DeploymentSlot | Specifica l'ambiente in cui viene distribuito il servizio cloud, staging o production . |
PrivateID | Specifica un identificatore univoco generato internamente per questa distribuzione. |
Stato | Specifica lo stato della distribuzione. I valori possibili sono: - Running - Suspended - RunningTransitioning - SuspendedTransitioning - Starting - Suspending - Deploying - Deleting |
Etichetta | Specifica un identificatore con codifica Base 64 della distribuzione. Questo identificatore può essere usato per motivi di rilevamento. |
URL | Specifica l'URL usato per accedere al servizio cloud. Ad esempio, se il nome del servizio è MyService, è possibile accedere al servizio chiamando: http:// MyService.cloudapp.net |
Configurazione | Specifica il file di configurazione con codifica Base 64 della distribuzione. |
RoleInstanceList | Contiene l'elenco delle istanze del ruolo nella distribuzione. |
UpgradeStatus | Contiene le impostazioni per la modalità di aggiornamento della distribuzione. |
UpgradeDomainCount | Contiene un valore intero che rappresenta il numero totale di domini di aggiornamento per la distribuzione. L'elemento UpgradeDomainCount è disponibile solo con la versione 2011-06-01 o successiva. |
RoleList | Contiene l'elenco dei ruoli nella distribuzione. |
SdkVersion | Specifica la versione dell'SDK usata per generare il pacchetto per la distribuzione. L'elemento SdkVersion è disponibile solo con la versione 2011-06-01 o successiva. |
Bloccato | True per impedire una nuova operazione di scrittura per la distribuzione durante l'aggiornamento; in caso contrario, false .L'elemento Locked è disponibile solo con la versione 2011-06-01 o successiva. |
RollbackAllowed | True se nella distribuzione è consentita l'operazione RollbackDeploymentUpdateOrUpgrade ; in caso contrario, false .L'elemento RollbackAllowed è disponibile solo con la versione 2011-06-01 o successiva. |
CreatedTime | Specifica l'ora di creazione della distribuzione. |
LastModifiedTime | Specifica l'ora dell'ultima modifica della distribuzione. |
VirtualNetworkName | Specifica il nome della rete virtuale a cui si connette la macchina virtuale. L'elemento VirtualNetworkName è disponibile solo con la versione 2012-03-01 o successiva. |
Dns | Contiene le impostazioni DNS specificate per la distribuzione. L'elemento Dns è disponibile solo con la versione 2012-03-01 o successiva. |
LoadBalancers | Contiene un elenco dei dispositivi di bilanciamento del carico interni che possono essere assegnati a endpoint di input. L'elemento LoadBalancers è disponibile solo con la versione 2014-05-01 o successiva. |
ExtendedProperties | Specifica le proprietà usate per fornire altre informazioni su una distribuzione. |
PersistentVMDowntime | Specifica le informazioni relative al momento in cui la macchina virtuale è stata avviata e arrestata. L'elemento PersistentVMDowntime è disponibile solo con la versione 2012-03-01 o successiva. |
VirtualIPs | Specifica gli indirizzi IP virtuali per la distribuzione. L'elemento VirtualIPs è disponibile solo con la versione 2012-03-01 o successiva. |
ExtensionConfiguration | Specifica un'estensione aggiunta al servizio cloud. In Azure un processo può essere eseguito come estensione di un servizio cloud. È possibile aggiungere un'estensione a un servizio cloud usando Aggiungi estensione e è possibile aggiungere l'estensione alla distribuzione usando La distribuzione di aggiornamenti o Modifica configurazione distribuzione. L'elemento ExtensionConfiguration è disponibile solo se si utilizza la versione 01.03.13 o una versione successiva. |
ReservedIPName | Specifica il nome dell'indirizzo IP riservato da assegnare alla distribuzione. L'elemento ReservedIPName è disponibile solo usando la versione 2014-05-01 o successiva. |
InternalDnsSuffix | Specifica il suffisso del nome di dominio per la risoluzione dei nomi interni assegnato automaticamente da Azure. A tutte le istanze di macchine virtuali di una distribuzione viene assegnato automaticamente il suffisso del nome di dominio. A tutte le istanze di ruoli Web o di lavoro di una distribuzione viene assegnato automaticamente il suffisso del nome di dominio se ad almeno un ruolo viene assegnato un nome di computer usando l'attributo vmName . A una distribuzione presente in una rete virtuale con un server DNS configurato non viene assegnato un suffisso di nome di dominio interno.L'elemento InternalDnsSuffix è disponibile solo se si utilizza la versione 01.11.13 o una versione successiva. |
RoleInstanceList
Contiene l'elenco delle istanze del ruolo nella distribuzione.
Nome dell'elemento | Descrizione |
---|---|
RoleName | Specifica il nome del ruolo. |
InstanceName | Specifica il nome di una determinata istanza del ruolo, se è in esecuzione un'istanza di questo tipo. |
InstanceStatus | Specifica lo stato corrente di un'istanza del ruolo.Unknown :- Indica che lo stato del ruolo è attualmente sconosciuto. CreatingVM :- Indica che le risorse vengono create per una macchina virtuale. StartingVM :- Indica che viene avviata una macchina virtuale. CreatingRole :- Indica che le risorse vengono create per un'istanza del ruolo. StartingRole :- Indica che viene avviata un'istanza del ruolo. ReadyRole :- Indica che un'istanza del ruolo è stata avviata ed è pronta per essere usata. BusyRole :- Indica che un'istanza del ruolo non è disponibile per le richieste. Questo stato viene normalmente generato durante la creazione o l'arresto dell'istanza del ruolo. StoppingRole :- Indica che un'istanza del ruolo viene arrestata. StoppingVM :- Indica che una macchina virtuale viene arrestata. DeletingVM :- Indica che viene eliminata una macchina virtuale. StoppedVM :- Indica che una macchina virtuale non è in esecuzione. Si tratta dello stato finale del processo di arresto e dopo StoppedVM non verranno ricevuti altri messaggi di stato.RestartingRole :- Indica che un'istanza del ruolo è stata arrestata in modo imprevisto o non è riuscita ad avviare. Questo stato indica la presenza di un problema con l'istanza del ruolo che ne causa l'arresto anomalo o ne impedisce l'avvio. Per poter avviare l'istanza del ruolo, è necessario correggere prima il problema. Nei campi InstanceStateDetails e InstanceErrorCode possono essere incluse informazioni sull'errore del ruolo che ha causato questo stato.CyclingRole :- Indica che un ruolo si è bloccato continuamente dopo l'avvio di Azure. Questo stato indica che è presente un problema con il ruolo che ne impedisce l'avvio e può essere generato dopo la ricezione degli stati StartingRole e ReadyRole . Per poter avviare il ruolo, è necessario individuare e correggere prima il problema nel ruolo. I campi InstanceStateDetails e InstanceErrorCode possono contenere informazioni sull'errore del ruolo che ha causato questo stato, le quali possono essere utili per identificare ed eseguire il debug del problema. L'elemento CyclingRole viene restituito solo se la versione è 2014-02-01 o inferiore.FailedStartingRole :- Il ruolo non è riuscito continuamente ad avviare. Questo stato indica che è presente un problema con l'istanza del ruolo che ne impedisce l'avvio e può essere generato dopo la restituzione di StartingRole da parte del processo. Per poter avviare il ruolo, è necessario individuare e correggere prima il problema nel ruolo. I campi InstanceStateDetails e InstanceErrorCode possono contenere informazioni sull'errore del ruolo che ha causato questo stato, le quali possono essere utili per identificare ed eseguire il debug del problema.FailedStartingVM :- Indica che una macchina virtuale non è stata avviata continuamente. Questo stato viene generato da Azure e non indica un errore con il ruolo. Può essere generato dopo lo stato StartingRole .UnresponsiveRole :- Indica che un'istanza del ruolo è scaduta prima di ricevere un messaggio di stato e non risponde alle richieste. StoppedDeallocated :- Indica che è stata arrestata un'istanza del ruolo e tutte le risorse allocate sono state rilasciate. pertanto viene arrestata la fatturazione per l'istanza del ruolo. Vengono restituite solo le istanze del ruolo con stato StoppedDeallocated nell'elenco di istanze del ruolo se la versione è 2013-06-01 o successiva. Se lo stato di tutte le istanze del ruolo nella distribuzione è StoppedDeallocated , la distribuzione non viene restituita qualora la versione sia meno recente di 2013-06-01.Preparing :- Indica che il BLOB viene copiato dal percorso di origine remoto. Questo stato viene restituito solo per la versione 2014-05-01 o successiva. |
ExtendedInstanceStatus | Specifica dettagli aggiuntivi sullo stato, se disponibili per la distribuzione. Se è in corso la copia di un blob da una posizione di origine remota a un account di archiviazione, il valore di questo elemento contiene la percentuale del blob che è stata copiata. L'elemento ExtendedInstanceStatus è disponibile solo se si utilizza la versione 01.05.15 o una versione successiva. |
InstanceUpgradeDomain | Specifica il dominio di aggiornamento a cui appartiene l'istanza del ruolo. Durante la distribuzione di un aggiornamento, tutti i ruoli presenti nello stesso dominio di aggiornamento vengono aggiornati contemporaneamente. L'elemento InstanceUpgradeDomain è disponibile solo usando la versione 2011-06-01 o successiva. |
InstanceFaultDomain | Specifica il dominio di errore a cui appartiene l'istanza del ruolo. Le istanze del ruolo nello stesso dominio di errore possono essere soggette agli errori di un singolo componente hardware. L'elemento InstanceFaultDomain è disponibile solo usando la versione 2011-06-01 o successiva. |
InstanceSize | Specifica la dimensione dell'istanza del ruolo. L'elemento InstanceSize è disponibile solo usando la versione 2011-06-01 o successiva. |
InstanceStateDetails | Fornisce uno snapshot dello stato dell'istanza del ruolo al momento della chiamata dell'operazione. L'elemento InstanceStateDetails è disponibile solo se si utilizza la versione 01.10.11 o una versione successiva. |
InstanceErrorCode | Codice di errore dell'ultimo avvio del ruolo. I codice errore per le macchine virtuali sono: - WaitTimeout: l'istanza del ruolo non comunica entro 25 minuti. Questo codice errore indica in genere che non è stato eseguito l'avvio o che l'agente guest non è installato. - VhdTooLarge: l'immagine del disco rigido virtuale selezionata è troppo grande per l'istanza del ruolo. - AzureInternalError: si è verificato un errore interno che ha causato l'avvio dell'istanza del ruolo. Per assistenza aggiuntiva, rivolgersi al supporto tecnico. Per i ruoli Web e di lavoro questo campo restituisce un codice errore che può essere fornito al supporto di Azure per consentire la risoluzione degli errori. In genere, questo campo sarà vuoto. L'elemento InstanceErrorCode è disponibile solo se si utilizza la versione 01.10.11 o una versione successiva. |
IpAddress | Specifica l'indirizzo IP dell'istanza del ruolo (DIP). L'elemento IpAddress è disponibile solo usando la versione 2012-03-01 o successiva. |
InstanceEndpoints | Contiene l'elenco di endpoint dell'istanza per il ruolo. |
PowerState | Stato di esecuzione della macchina virtuale. Di seguito sono indicati i valori possibili: - Starting - Started - Stopping - Stopped - Unknown |
HostName | Specifica il nome host DNS del servizio cloud in cui è in esecuzione l'istanza del ruolo. Questo elemento viene elencato solo per le distribuzioni di macchine virtuali. |
RemoteAccessCertificateThumbprint | Specifica l'identificazione personale del certificato del server RDP (in Windows) o del certificato del server SSH (in Linux). L'identificazione personale viene usata solo per le macchine virtuali create da un'immagine. L'elemento RemoteAccessCertificateThumbprint è disponibile solo se si utilizza la versione 01.08.12 o una versione successiva. |
GuestAgentStatus | Specifica informazioni sull'agente installato in un'istanza. L'elemento GuestAgentStatus è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva. |
ResourceExtensionStatusList | Specifica informazioni sulle estensioni installate in un'istanza. L'elemento ResourceExtensionStatusList è disponibile solo se si utilizza la versione 01.04.14 o una versione successiva. |
PublicIPs | Facoltativa. Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale. L'elemento PublicIPs è disponibile solo con la versione 2014-05-01 o successiva. |
NetworkInterfaces | Facoltativo. Un set di interfacce di rete secondarie. Il numero di interfacce di rete secondarie consentite dipende dalle dimensioni della macchina virtuale. L'elemento NetworkInterfaces è disponibile solo se si usa la versione 2014-08-01 o una versione successiva. |
InstanceEndpoints
Contiene l'elenco di endpoint dell'istanza per il ruolo.
Nome dell'elemento | Descrizione |
---|---|
Nome | Specifica il nome dell'endpoint. |
Vip | Specifica l'indirizzo IP virtuale dell'endpoint. L'elemento Vip è disponibile solo con la versione 2011-06-01 o successiva. |
PublicPort | Specifica la porta esterna usata dall'endpoint. |
Porta locale | Specifica la porta interna usata dall'endpoint. |
Protocollo | Specifica il protocollo di traffico nell'endpoint. |
UpgradeStatus
Specifica le informazioni su un aggiornamento che si verifica nella distribuzione.
Nome dell'elemento | Descrizione |
---|---|
UpgradeType | Specifica il tipo dell'aggiornamento. I valori possibili sono: - Auto - Manual - Simultaneous |
CurrentUpgradeDomainState | Specifica lo stato corrente dell'aggiornamento. I valori possibili sono Before e During . |
CurrentUpgradeDomain | Contiene un valore intero tramite cui viene identificato il dominio di aggiornamento corrente. I domini di aggiornamento vengono identificati con un indice in base zero: l'ID del primo dominio di aggiornamento è 0, l'ID del secondo dominio di aggiornamento è 1 e così via. |
RoleList
Contiene l'elenco dei ruoli nella distribuzione.
Nome dell'elemento | Descrizione |
---|---|
RoleName | Specifica il nome del ruolo. |
OsVersion | Specifica la versione del sistema operativo in cui vengono eseguite le istanze del ruolo. |
RoleType | Specifica il tipo del ruolo. Questo elemento viene elencato solo per le distribuzioni di macchine virtuali e per impostazione predefinita è PersistentVMRole . |
LicenseType | Specifica che l'immagine o il disco usato è stato concesso in licenza in locale. Questo elemento viene usato solo per le immagini che contengono il sistema operativo Windows Server. I valori possibili sono: - Windows_Client - Windows_Server |
ConfigurationSets | Contiene una raccolta di valori che rappresenta le impostazioni di configurazione dell'applicazione o di sistema. |
AvailabilitySetName | Specifica il nome di una raccolta di macchine virtuali. |
DataVirtualHardDisks | Contiene i parametri usati per aggiungere un disco dati a una macchina virtuale. |
OSVirtualHardDisk | Contiene i parametri usati per creare il disco del sistema operativo per una macchina virtuale. |
RoleSize | Specifica la dimensione dell'istanza del ruolo. |
ProvisionGuestAgent | Facoltativa. Indica se nella macchina virtuale è installato l'agente VM. Per eseguire un'estensione di risorsa in una macchina virtuale, questo servizio deve essere installato. I valori possibili sono: - true - false |
ResourceExtensionReferences | Facoltativa. Contiene una raccolta di estensioni di risorsa da installare nella macchina virtuale. Questo elemento viene usato se ProvisionGuestAgent è impostato su true . |
ConfigurationSets
Contiene una raccolta di oggetti che forniscono i dati dell'applicazione o di sistema.
Nome dell'elemento | Descrizione |
---|---|
ConfigurationSetType | Specifica il tipo di configurazione per il set di configurazione. Attualmente è sempre impostato su NetworkConfiguration. |
InputEndpoints | Contiene una raccolta di endpoint esterni per una macchina virtuale. |
SubnetNames | Contiene un elenco di nomi di subnet della rete virtuale a cui appartiene la distribuzione. |
PublicIPs | Facoltativa. Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale. L'elemento PublicIPs è disponibile solo con la versione 2014-05-01 o successiva. |
NetworkInterfaces | Facoltativo. Un set di interfacce di rete secondarie. Il numero di interfacce di rete secondarie consentite dipende dalle dimensioni della macchina virtuale. L'elemento NetworkInterfaces è disponibile solo se si usa la versione 2014-08-01 o una versione successiva. |
StaticVirtualNetworkIPAddress | Specifica l'indirizzo IP interno della macchina virtuale in una rete virtuale. Se questo elemento viene specificato, l'elemento SubnetNames conterrà una sola subnet. L'indirizzo IP specificato in questo elemento appartiene alla subnet definita in SubnetNames. L'elemento StaticVirtualNetworkIPAddress è disponibile solo se si utilizza la versione 01.11.13 o una versione successiva. |
InputEndpoints
Contiene una raccolta di endpoint esterni per una macchina virtuale.
Nome dell'elemento | Descrizione |
---|---|
LoadBalancedEndpointSetName | Specifica un nome di un set di endpoint con carico bilanciato. Questo elemento viene elencato solo per le distribuzioni di macchine virtuali. |
Porta locale | Specifica la porta interna su cui la macchina virtuale è in ascolto per servire l'endpoint. Questo elemento viene elencato solo per le distribuzioni di macchine virtuali. |
Nome | Specifica il nome dell'endpoint esterno. Questo elemento viene elencato solo per le distribuzioni di macchine virtuali. |
Porta | Specifica la porta esterna da usare per l'endpoint. |
LoadBalancerProbe | Contiene le impostazioni di endpoint usate dal servizio di bilanciamento del carico di Azure per monitorare la disponibilità di una macchina virtuale prima di inoltrare il traffico all'endpoint. |
LoadBalancerName | Facoltativa. Specifica il nome del dispositivo di bilanciamento del carico interno associato all'endpoint. Il nome del servizio di bilanciamento del carico interno viene specificato in LoadBalancers. L'elemento LoadBalancerName è disponibile solo usando la versione 2014-05-01 o successiva. |
IdleTimeoutInMinutes | Facoltativa. Specifica il timeout per la connessione TCP inattiva. Il valore può essere compreso tra 4 e 30 minuti. Il valore predefinito è 4 minuti. Questo valore viene usato soltanto quando il protocollo è impostato su TCP. L'elemento IdleTimeoutInMinutes è disponibile solo usando la versione 2014-06-01 o successiva. |
Protocollo | Specifica il protocollo di trasporto per l'endpoint. I valori possibili sono: - TCP - UDP |
Vip | Specifica l'indirizzo IP virtuale dell'endpoint. |
LoadBalancerProbe
Contiene le impostazioni di endpoint usate dal servizio di bilanciamento del carico di Azure per monitorare la disponibilità di una macchina virtuale prima di inoltrare il traffico all'endpoint.
Nome dell'elemento | Descrizione |
---|---|
Percorso | Specifica il nome del percorso relativo da verificare per determinare lo stato di disponibilità. Se il protocollo è impostato su TCP, questo valore deve essere NULL. Esempio: path Il probe userà https://example.com/path per eseguire il probe. |
Porta | Specifica la porta da usare per verificare lo stato di disponibilità. |
Protocollo | Specifica il protocollo da usare per verificare lo stato di disponibilità. I valori possibili sono: - HTTP - TCP |
DNS
Specifica le impostazioni DNS personalizzate fornite per la distribuzione.
Nome dell'elemento | Descrizione |
---|---|
Nome | Specifica il nome del server DNS. |
Indirizzo | Specifica l'indirizzo IP del server DNS. |
ExtendedProperties
Specifica le proprietà usate per fornire altre informazioni su una distribuzione.
Nome dell'elemento | Descrizione |
---|---|
Nome | Specifica il nome di una proprietà associata alla distribuzione. |
Valore | Specifica il valore di una proprietà associata alla distribuzione. |
PersistentVMDowntime
Specifica le informazioni relative al momento in cui la macchina virtuale è stata avviata e arrestata.
Nome dell'elemento | Descrizione |
---|---|
StartTime | Specifica l'ora di avvio della macchina virtuale. |
EndTime | Specifica l'ora di arresto della macchina virtuale. |
Stato | Specifica lo stato della macchina virtuale. |
VirtualIPs
Contiene gli indirizzi IP virtuali specificati per la distribuzione.
Nome dell'elemento | Descrizione |
---|---|
Indirizzo | Specifica l'indirizzo IP virtuale della distribuzione. |
IsReserved | Indica se l'indirizzo IP virtuale è riservato. I valori possibili sono: - true - false |
ReservedIPName | Specifica il nome dell'indirizzo IP riservato assegnato alla distribuzione. |
Tipo | Specifica il valore di Private se l'indirizzo IP virtuale è associato a un dispositivo di bilanciamento del carico interno. |
SubnetNames
Contiene un elenco di subnet a cui apparterrà la macchina virtuale.
Nome dell'elemento | Descrizione |
---|---|
SubnetName | Obbligatorio. Specifica il nome di una subnet a cui appartiene la macchina virtuale. |
DataVirtualHardDisks
Contiene i parametri usati per aggiungere un disco dati a una macchina virtuale.
Nome dell'elemento | Descrizione |
---|---|
HostCaching | Specifica il comportamento di memorizzazione nella cache della piattaforma del BLOB di un disco dati per l'efficienza di lettura/scrittura. I valori possibili sono: - None - ReadOnly - ReadWrite L'insieme di credenziali predefinito è ReadOnly . |
DiskName | Specifica il nome del VHD da usare per la creazione del disco dati per la macchina virtuale. |
Lun | Specifica il numero di unità logica (LUN) per il disco dati. Tramite il LUN viene specificato lo slot in cui viene visualizzata l'unità dati una volta montata per l'utilizzo da parte della macchina virtuale. Questo elemento viene elencato solo quando più dischi dati sono collegati a una macchina virtuale. I valori validi sono compresi tra 0 e 31. |
LogicalDiskSizeInGB | Specifica le dimensioni, in GB, del disco da collegare alla macchina virtuale. |
MediaLink | Specifica il percorso nel servizio di archiviazione di Azure del VHD associato al disco. Esempio: http://example.blob.core.windows.net/disks/mydatadisk.vhd| |
IOType | Questa proprietà identifica il tipo dell'account di archiviazione per il disco VHD di supporto. Se il disco rigido virtuale di backup si trova in un account di archiviazione con provisioning, viene restituito "Provisioned" in caso contrario viene restituito "Standard". Nota: questo valore viene popolato dalla piattaforma Azure quando il disco viene creato, non dall'utente. Questa proprietà viene restituita solo con un'intestazione di versione 2014-10-01 o versione successiva. |
OSVirtualHardDisk
Contiene i parametri usati per creare il disco del sistema operativo per una macchina virtuale.
Nome dell'elemento | Descrizione |
---|---|
HostCaching | Specifica il comportamento di memorizzazione nella cache della piattaforma del BLOB di un disco del sistema operativo per l'efficienza di lettura/scrittura. I valori possibili sono: - ReadOnly - ReadWrite |
DiskName | Specifica il nome di un'immagine del sistema operativo nell'archivio immagini. |
MediaLink | Specifica il percorso nel servizio di archiviazione di Azure del VHD associato al disco del sistema operativo. |
SourceImageName | Specifica il nome dell'immagine di origine usata per creare il disco del sistema operativo. |
Sistema operativo | Specifica il sistema operativo che è in esecuzione nella macchina virtuale. I valori possibili sono: - Windows - Linux |
RemoteSourceImageLink | Specifica l'URI della posizione in cui viene archiviata un'immagine del sistema operativo usata per creare la macchina virtuale. Può trattarsi di una posizione diversa dai repository dell'utente o della piattaforma presenti in Azure. Un'immagine è sempre associata a un VHD, vale a dire un file con estensione vhd archiviato come blob di pagine in un account di archiviazione. Se si specifica il percorso di un'immagine con questo elemento, viene creato un VHD associato e sarà necessario usare l'elemento MediaLink per indicare la posizione della risorsa di archiviazione in cui verrà inserito il VHD. Se si usa questo elemento, SourceImageName non viene usato. L'elemento RemoteSourceImageLink è disponibile solo con la versione 2014-05-01 o successiva. |
IOType | Questa proprietà identifica il tipo dell'account di archiviazione per il disco VHD di supporto. Se il disco VHD si trova in un account di archiviazione sottoposto a provisioning, viene restituito "Provisioned", in caso contrario viene restituito "Standard". Nota: questo valore viene popolato dalla piattaforma Azure quando il disco viene creato, non dall'utente. Questa proprietà viene restituita solo con un'intestazione di versione 2014-10-01 o versione successiva. |
ResourceExtensionReferences
Contiene una raccolta di estensioni di risorsa da installare nella macchina virtuale. Un'estensione di risorsa è un componente software installato nella macchina virtuale. Per installare le estensioni di risorsa, deve essere installato l'agente VM nella macchina virtuale.
Nome dell'elemento | Descrizione |
---|---|
ResourceExtensionReference | Obbligatorio. Specifica le proprietà di un'estensione di risorsa che devono essere installate nella macchina virtuale. |
ReferenceName | Obbligatorio. Specifica il nome di riferimento dell'estensione di risorsa. |
Publisher | Obbligatorio. Specifica il nome dell'editore che ha creato l'estensione di risorsa. È possibile usare List Resource Extensions per trovare il nome dell'editore di un'estensione di risorsa. |
Nome | Obbligatorio. Specifica il nome dell'estensione di risorsa. È possibile usare List Resource Extensions per trovare i nomi delle estensioni delle risorse disponibili. |
Versione | Obbligatorio. Specifica la versione dell'estensione di risorsa. È possibile usare List Resource Extension Versions per trovare la versione dell'estensione della risorsa. |
ResourceExtensionParameterValues | Facoltativa. Contiene una raccolta di parametri passati all'estensione di risorsa quando viene installata. |
State | Facoltativa. Specifica lo stato dell'estensione di risorsa. I valori possibili sono: - Enable - Disable Il valore predefinito è Enable . |
ResourceExtensionParameterValues
Contiene una raccolta di parametri passati all'estensione di risorsa quando viene installata.
Nome dell'elemento | Descrizione |
---|---|
ResourceExtensionParameterValue | Obbligatorio. Specifica la chiave, il valore e il tipo del parametro. |
Chiave | Obbligatorio. Specifica la chiave del parametro. |
Valore | Obbligatorio. Specifica il valore con codifica Base 64 del parametro. |
Tipo | Obbligatorio. Specifica il tipo dell'estensione di risorsa. I valori possibili sono: - Public - Private Se questo valore è impostato su Private , il parametro non verrà restituito da Get Deployment. È possibile specificare solo un parametro pubblico e uno privato per un massimo di due parametri. |
ExtensionConfiguration
Contiene le estensioni aggiunte al servizio cloud.
Nome dell'elemento | Descrizione |
---|---|
AllRoles | Specifica un elenco di estensioni applicate a tutti i ruoli in una distribuzione. |
Estensione | Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud. |
NamedRoles | Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione. |
Estensione
Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.
Nome dell'elemento | Descrizione |
---|---|
ID | Specifica l'identificatore dell'estensione. L'identificatore viene creato quando l'estensione viene aggiunta al servizio cloud. È possibile trovare l'ID di un'estensione aggiunta a un servizio cloud usando Estensioni elenco. |
SequenceNumber | Specifica il numero dell'ultima configurazione applicata per l'estensione. Questo numero è assegnato da Azure e viene incrementato ad ogni modifica della configurazione. L'elemento SequenceNumber è disponibile solo usando la versione 2014-06-01 o successiva. |
State | Facoltativa. Specifica lo stato dell'estensione. Questo elemento si applica a estensioni configurate JSON. I valori possibili sono: - Enable - Disable - Uninstall Il valore predefinito è Enable .L'elemento State è disponibile solo usando la versione 2014-06-01 o successiva. |
NamedRoles
Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.
Nome dell'elemento | Descrizione |
---|---|
Ruolo | Specifica un determinato ruolo a cui viene aggiunta l'estensione. |
RoleName | Specifica il nome del ruolo. |
Estensione | Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud. |
GuestAgentStatus
Specifica informazioni sull'agente installato in un'istanza.
Nome dell'elemento | Descrizione |
---|---|
ProtocolVersion | Specifica la versione del protocollo usato dall'agente per i report sullo stato. |
Timestamp | Specifica l'ora UTC in cui è stato creato il report sullo stato. |
GuestAgentVersion | Specifica la versione dell'agente installata nell'istanza. |
Stato | Specifica lo stato dell'agente. I valori possibili sono: - Ready - NotReady |
FormattedMessage | Specifica un messaggio di stato localizzato. |
FormattedMessage
Specifica un messaggio di stato localizzato.
Nome dell'elemento | Descrizione |
---|---|
Linguaggio | Specifica la lingua del messaggio. |
Message | Specifica il messaggio. |
ResourceExtensionStatusList
Specifica informazioni sulle estensioni installate in un'istanza.
Nome dell'elemento | Descrizione |
---|---|
ResourceExtensionStatus | Specifica informazioni su una particolare estensione. |
ResourceExtensionStatus
Specifica informazioni su una particolare estensione.
Nome dell'elemento | Descrizione |
---|---|
HandlerName | Specifica il nome dell'estensione. |
Versione | Specifica la versione dell'estensione. |
Stato | Specifica lo stato dell'estensione. I valori possibili sono: - Installing - Ready - NotReady - Unresponsive |
Codice | Specifica il codice di stato restituito dall'estensione. |
FormattedMessage | Specifica un messaggio di stato localizzato. |
ExtensionSettingStatus | Specifica informazioni sullo stato riguardo alle impostazioni passate all'estensione. |
PublicIPs
Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale.
Nome dell'elemento | Descrizione |
---|---|
IP pubblico | Obbligatorio. Specifica un indirizzo IP pubblico aggiuntivo che può essere usato per comunicare con la macchina virtuale. |
Nome | Obbligatorio. Specifica il nome dell'indirizzo IP pubblico. |
Indirizzo | Obbligatorio. Specifica l'indirizzo IP per l'INDIRIZZO IP pubblico. |
IdleTimeoutInMinutes | Facoltativa. Specifica il timeout per la connessione TCP inattiva. Il valore può essere compreso tra 4 e 30 minuti. Il valore predefinito è 4 minuti. Questo valore viene usato soltanto quando il protocollo è impostato su TCP. L'elemento IdleTimeoutInMinutes è disponibile solo usando la versione 2014-06-01 o successiva. |
DomainNameLabel | Facoltativa. Specifica l'etichetta del nome di dominio per l'indirizzo IP pubblico. L'elemento DomainNameLabel è disponibile solo usando la versione 2015-03-01 o successiva. |
Fqdn | Facoltativa. Specifica un nome di dominio completo registrato per questo indirizzo IP pubblico. |
NetworkInterfaces
Contiene un set di interfacce di rete secondarie.
Nome dell'elemento | Descrizione |
---|---|
NetworkInterface | Obbligatorio. Specifica un'interfaccia di rete secondaria. |
Nome | Obbligatorio. Specifica il nome dell'interfaccia di rete secondaria. |
Configurazioni IP | Obbligatorio. Specifica un set di configurazioni di indirizzo IP per un'interfaccia di rete secondaria. |
IPConfigurations
Specifica un set di configurazioni di indirizzo IP per un'interfaccia di rete secondaria.
Nome dell'elemento | Descrizione |
---|---|
IPConfiguration | Obbligatorio. Specifica una configurazione di indirizzo IP per un'interfaccia di rete secondaria. Attualmente è supportata solo una configurazione di indirizzo IP per un'interfaccia di rete secondaria. |
SubnetName | Obbligatorio. Specifica il nome della subnet della rete virtuale a cui appartiene questa configurazione di indirizzo IP. |
Indirizzo | Obbligatorio. Specifica l'indirizzo IP interno configurato per un'interfaccia di rete secondaria. |
LoadBalancers
Contiene un elenco dei dispositivi di bilanciamento del carico interni che possono essere assegnati a endpoint di input.
Nome dell'elemento | Descrizione |
---|---|
LoadBalancer | Obbligatorio. Specifica gli attributi di un dispositivo di bilanciamento del carico interno. |
Nome | Obbligatorio. Specifica il nome di un dispositivo di bilanciamento del carico interno. |
FrontendIpConfiguration | Obbligatorio. Specifica la configurazione per l'indirizzo IP virtuale fornito dal dispositivo di bilanciamento del carico. |
Tipo | Obbligatorio. Specifica il tipo di indirizzo IP virtuale fornito dal dispositivo di bilanciamento del carico. L'unico valore consentito è Private . |
SubnetName | Obbligatorio se la distribuzione è presente in una rete virtuale e se viene assegnato un elemento StaticVirtualNetworkIPAddress. Specifica la subnet della rete virtuale usata dal dispositivo di bilanciamento del carico. L'indirizzo IP virtuale gestito dal dispositivo di bilanciamento del carico è contenuto in questa subnet. |
StaticVirtualNetworkIPAddress | Facoltativa. Specifica un indirizzo IP virtuale usato dal dispositivo di bilanciamento del carico nella subnet della rete virtuale. |
ExtensionSettingStatus
Specifica informazioni sullo stato riguardo alle impostazioni passate all'estensione.
Nome dell'elemento | Descrizione |
---|---|
Timestamp | Specifica l'ora UTC in cui è stato creato il report sullo stato. |
Nome | Specifica il nome dell'impostazione passata all'estensione. |
Operazione | Specifica l'operazione eseguita dall'estensione mediante l'impostazione. |
Stato | Specifica lo stato dell'operazione. I valori possibili sono: - transitioning - error - success - warning |
Codice | Specifica il codice di stato dell'operazione. |
FormattedMessage | Specifica un messaggio di stato localizzato. |
SubStatusList | Contiene un elenco di informazioni aggiuntive sullo stato, se disponibili. |
SubStatusList
Contiene un elenco di informazioni aggiuntive sullo stato, se disponibili.
Nome dell'elemento | Descrizione |
---|---|
SubStatus | Contiene informazioni su messaggi di stato aggiuntivi restituiti dall'estensione. |
Nome | Specifica l'identificatore dello stato. |
Stato | Specifica lo stato dell'operazione. I valori possibili sono: - transitioning - error - success - warning |
FormattedMessage | Specifica un messaggio di stato localizzato. |
Commenti
Per ottenere i nomi dei servizi cloud nella sottoscrizione, è possibile usare List Servizi cloud.