Condividi tramite


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.