Esporta (0) Stampa
Espandi tutto

Ottenere la distribuzione

Aggiornamento: agosto 2014

L'operazione Get Deployment restituisce le informazioni di configurazione, lo stato e le proprietà di sistema per una distribuzione.

La richiesta Get Deployment può essere usata per recuperare le informazioni per una distribuzione specifica o per tutte le distribuzioni negli ambienti di gestione temporanea e di produzione. Se si desidera 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 tutte le distribuzioni in un ambiente.

Ad esempio, se si dispone di un servizio cloud distribuito nell'ambiente di produzione, è possibile ottenere il nome univoco effettuando a una richiesta a …/deploymentslots/production. La risposta include un elenco di tutti i servizi cloud attualmente distribuiti nell'ambiente di produzione e include un elemento Name per ogni 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 della 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>

È necessario verificare che la richiesta effettuata al servizio di gestione sia sicura. Per altri dettagli, vedere Autenticazione di richieste di gestione dei servizi.

Nessuno.

Nella tabella seguente vengono descritte le intestazioni delle richieste.

 

Intestazione della richiesta Descrizione

x-ms-version

Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 01/10/2009 o una versione successiva. Per altre informazioni sulle intestazioni di controllo delle versioni, vedere Controllo delle versioni di gestione del servizio.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK). Per informazioni sui codici di stato, vedere Codici di stato e di errore relativi alla gestione dei servizi.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

x-ms-request-id

Valore che identifica in modo univoco una richiesta effettuata nel servizio di gestione.

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>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        <PublicIP>
      <PublicIPs>
    </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>
        </ConfigurationSet>
      </ConfigurationSets>
    </Role>
    <Role>
      <RoleName>name-of-role</RoleName>
      <OsVersion>operating-system-version</OsVersion>
      <RoleType>PersistentVMRole</RoleType>
      <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>
        </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>
      </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 elemento Descrizione

Nome

Specifica il nome della distribuzione.

DeploymentSlot

Specifica l'ambiente in cui viene distribuito il servizio cloud, staging o production.

PrivateID

Specifica l'identificatore univoco generato internamente da Azure per la 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.

Se ad esempio 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 se si usa la versione 01/06/2011 o una versione 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 se si usa la versione 01/06/2011 o una versione 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 se si usa la versione 01/06/2011 o una versione successiva.

RollbackAllowed

True se nella distribuzione è consentita l'operazione RollbackDeploymentUpdateOrUpgrade; in caso contrario, false.

L'elemento RollbackAllowed è disponibile solo se si usa la versione 01/06/2011 o una versione 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 se si usa la versione 01/03/2012 o una versione successiva.

Dns

Contiene le impostazioni DNS specificate per la distribuzione.

L'elemento Dns è disponibile solo se si usa la versione 01/03/2012 o una versione 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 se si usa la versione 01/05/2014 o una versione 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 se si usa la versione 01/03/2012 o una versione successiva.

VirtualIPs

Specifica gli indirizzi IP virtuali per la distribuzione.

L'elemento VirtualIPs è disponibile solo se si usa la versione 01/03/2012 o una versione 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 tramite Aggiungere un'estensione ed è possibile aggiungere l'estensione alla distribuzione usando Aggiornare la distribuzione o Modificare la configurazione di distribuzione.

L'elemento ExtensionConfiguration è disponibile solo se si usa la versione 01/03/2013 o una versione successiva.

ReservedIPName

Specifica il nome dell'indirizzo IP riservato da assegnare alla distribuzione.

L'elemento ReservedIPName è disponibile solo se si usa la versione 01/05/2014 o una versione 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. Per altre informazioni, vedere la pagina Risoluzione dei nomi.

L'elemento InternalDnsSuffix è disponibile solo se si usa la versione 01/11/2013 o una versione successiva.

Contiene l'elenco delle istanze del ruolo nella distribuzione.

 

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

 

Messaggio di stato Descrizione

Unknown

Indica che lo stato del ruolo è attualmente sconosciuto.

CreatingVM

Indica che le risorse vengono create per una macchina virtuale.

StartingVM

Indica l'avvio di una macchina virtuale.

CreatingRole

Indica che le risorse vengono create per un'istanza del ruolo.

StartingRole

Indica l'avvio di 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 l'arresto di un'istanza del ruolo.

StoppingVM

Indica l'arresto di una macchina virtuale.

DeletingVM

Indica l'eliminazione di 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 l'arresto imprevisto o l'impossibilità di avvio di un'istanza del ruolo. 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 viene continuamente arrestato in modo anomalo dopo essere stato avviato da 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 è 01/02/2014 o inferiore.

FailedStartingRole

Non è stato possibile avviare il ruolo. 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 non è stato possibile avviare una macchina virtuale. Questo stato viene generato da Azure e non indica un errore con il ruolo. Può essere generato dopo lo stato StartingRole.

UnresponsiveRole

Indica che si è verificato il timeout di un'istanza del ruolo prima della ricezione di un messaggio di stato e pertanto non è possibile rispondere alle richieste.

StoppedDeallocated

Indica che un'istanza del ruolo è stata arrestata 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 è in corso la copia del blob dalla posizione di origine remota. 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 usa la versione 01/05/2015 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 se si usa la versione 01/06/2011 o una versione 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 se si usa la versione 01/06/2011 o una versione successiva.

InstanceSize

Specifica la dimensione dell'istanza del ruolo.

L'elemento InstanceSize è disponibile solo se si usa la versione 01/06/2011 o una versione successiva.

InstanceStateDetails

Fornisce uno snapshot dello stato dell'istanza del ruolo al momento della chiamata dell'operazione.

L'elemento InstanceStateDetails è disponibile solo se si usa la versione 01/10/2011 o una versione successiva.

InstanceErrorCode

Codice di errore dell'ultimo avvio del ruolo.

I codice di errore per le macchine virtuali sono:

  • WaitTimeout: nessuna comunicazione da parte dell'istanza del ruolo in 25 minuti. Questo codice di errore indica in genere che non è stato eseguito l'avvio o che l'agente guest non è installato.

  • VhdTooLarge: l'immagine VHD selezionata è troppo grande per l'istanza del ruolo.

  • AzureInternalError: si è verificato un errore interno che ha impedito 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 di 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 usa la versione 01/10/2011 o una versione successiva.

IpAddress

Specifica l'indirizzo IP dell'istanza del ruolo (DIP).

L'elemento IpAddress è disponibile solo se si usa la versione 01/03/2012 o una versione 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 digitale del certificato del server RDP (in Windows) o del certificato del server SSH (in Linux). L'identificazione digitale viene usata solo per le macchine virtuali create da un'immagine.

L'elemento RemoteAccessCertificateThumbprint è disponibile solo se si usa la versione 01/08/2012 o una versione successiva.

GuestAgentStatus

Specifica informazioni sull'agente installato in un'istanza.

L'elemento GuestAgentStatus è disponibile solo se si usa la versione 01/04/2014 o una versione successiva.

ResourceExtensionStatusList

Specifica informazioni sulle estensioni installate in un'istanza.

L'elemento ResourceExtensionStatusList è disponibile solo se si usa la versione 01/04/2014 o una versione successiva.

PublicIPs

Facoltativo. Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale.

L'elemento PublicIPs è disponibile solo se si usa la versione 01/05/2014 o una versione successiva.

Contiene l'elenco di endpoint dell'istanza per il ruolo.

 

Nome elemento Descrizione

Nome

Specifica il nome dell'endpoint.

Vip

Specifica l'indirizzo IP virtuale dell'endpoint.

L'elemento Vip è disponibile solo se si usa la versione 01/06/2011 o una versione successiva.

PublicPort

Specifica la porta esterna usata dall'endpoint.

LocalPort

Specifica la porta interna usata dall'endpoint.

Protocollo

Specifica il protocollo di traffico nell'endpoint.

Specifica le informazioni su un aggiornamento che si verifica nella distribuzione.

 

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

Contiene l'elenco dei ruoli nella distribuzione.

 

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

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

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

Facoltativo. Contiene una raccolta di estensioni di risorsa da installare nella macchina virtuale. Questo elemento viene usato se ProvisionGuestAgent è impostato su true.

Contiene una raccolta di oggetti che forniscono i dati dell'applicazione o di sistema.

 

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

StaticVirtualNetworkIPAddress

Specifica l'indirizzo IP interno della macchina virtuale in una rete virtuale. Se questo elemento è specificato, nell'elemento SubnetNames sarà contenuta una sola subnet. L'indirizzo IP specificato nell'elemento appartiene alla subnet definita in SubnetNames.

L'elemento StaticVirtualNetworkIPAddress è disponibile solo se si usa la versione 01/11/2013 o una versione successiva.

Contiene una raccolta di endpoint esterni per una macchina virtuale.

 

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

LocalPort

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

Facoltativo. Specifica il nome del dispositivo di bilanciamento del carico interno associato all'endpoint. Il nome del dispositivo di bilanciamento del carico interno è specificato in LoadBalancers.

L'elemento LoadBalancerName è disponibile solo se si usa la versione 01/05/2014 o una versione successiva.

IdleTimeoutInMinutes

Facoltativo. 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 se si usa la versione 01/06/2014 o una versione successiva.

Protocollo

Specifica il protocollo di trasporto per l'endpoint.

I valori possibili sono:

  • TCP

  • UDP

Vip

Specifica l'indirizzo IP virtuale dell'endpoint.

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 elemento Descrizione

Path

Specifica il nome del percorso relativo da verificare per determinare lo stato di disponibilità. Se Protocol è impostato su TCP, questo valore deve essere NULL.

Esempio:

path

Per eseguire il probe, verrà usato https://example.com/path.

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

Specifica le impostazioni DNS personalizzate fornite per la distribuzione.

 

Nome elemento Descrizione

Nome

Specifica il nome del server DNS.

Address

Specifica l'indirizzo IP del server DNS.

Specifica le proprietà usate per fornire altre informazioni su una distribuzione.

 

Nome elemento Descrizione

Nome

Specifica il nome di una proprietà associata alla distribuzione.

Valore

Specifica il valore di una proprietà associata alla distribuzione.

Specifica le informazioni relative al momento in cui la macchina virtuale è stata avviata e arrestata.

 

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

Contiene gli indirizzi IP virtuali specificati per la distribuzione.

 

Nome elemento Descrizione

Address

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.

Contiene un elenco di subnet a cui apparterrà la macchina virtuale.

 

Nome elemento Descrizione

SubnetName

Obbligatorio. Specifica il nome di una subnet a cui appartiene la macchina virtuale.

Contiene i parametri usati per aggiungere un disco dati a una macchina virtuale.

 

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

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

Contiene i parametri usati per creare il disco del sistema operativo per una macchina virtuale.

 

Nome 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 se si usa la versione 01/05/2014 o una versione successiva.

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

Editore

Obbligatorio. Specifica il nome dell'editore che ha creato l'estensione di risorsa. È possibile usare Elencare le estensioni delle risorse per trovare il nome dell'editore di un'estensione di risorsa.

Nome

Obbligatorio. Specifica il nome dell'estensione di risorsa. È possibile usare Elencare le estensioni delle risorse per trovare i nomi di estensioni di risorsa disponibili.

Versione

Obbligatorio. Specifica la versione dell'estensione di risorsa. È possibile usare Elencare le versioni dell'estensione di una risorsa per trovare la versione dell'estensione di risorsa.

ResourceExtensionParameterValues

Facoltativo. Contiene una raccolta di parametri passati all'estensione di risorsa quando viene installata.

Stato

Facoltativo. Specifica lo stato dell'estensione di risorsa.

I valori possibili sono:

  • Enable

  • Disable

Il valore predefinito è Enable.

Contiene una raccolta di parametri passati all'estensione di risorsa quando viene installata.

 

Nome 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 dall'operazione Get Deployment. È possibile specificare solo un parametro pubblico e uno privato per un massimo di due parametri.

Contiene le estensioni aggiunte al servizio cloud.

 

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

Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.

 

Nome 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 creato usando Elencare le estensioni.

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 se si usa la versione 01/06/2014 o una versione successiva.

Stato

Facoltativo. 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 se si usa la versione 01/06/2014 o una versione successiva.

Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.

 

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

Specifica informazioni sull'agente installato in un'istanza.

 

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

Specifica un messaggio di stato localizzato.

 

Nome elemento Descrizione

Lingua

Specifica la lingua del messaggio.

Messaggio

Specifica il messaggio.

Specifica informazioni sulle estensioni installate in un'istanza.

 

Nome elemento Descrizione

ResourceExtensionStatus

Specifica informazioni su una particolare estensione.

Specifica informazioni su una particolare estensione.

 

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

Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale.

 

Nome elemento Descrizione

PublicIP

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.

IdleTimeoutInMinutes

Facoltativo. 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 se si usa la versione 01/06/2014 o una versione successiva.

Contiene un elenco dei dispositivi di bilanciamento del carico interni che possono essere assegnati a endpoint di input.

 

Nome 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

Facoltativo. Specifica un indirizzo IP virtuale usato dal dispositivo di bilanciamento del carico nella subnet della rete virtuale.

Specifica informazioni sullo stato riguardo alle impostazioni passate all'estensione.

 

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

Contiene un elenco di informazioni aggiuntive sullo stato, se disponibili.

 

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

Per ottenere i nomi dei servizi cloud nella sottoscrizione, è possibile elencare i servizi cloud.

Mostra:
© 2014 Microsoft