Esporta (0) Stampa
Espandi tutto

Aggiornare il ruolo

Aggiornamento: aprile 2015

Tramite l'operazione Update Role viene aggiornata la configurazione della macchina virtuale specificata.

La richiesta di Update Role può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud, <deployment-name> con il nome della distribuzione e <role-name> con il nome della macchina virtuale.

 

Metodo URI richiesta

PUT

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roles/<role-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 2012-03-01 o una versione successiva. Per altre informazioni sulle intestazioni di controllo delle versioni, vedere Controllo delle versioni relativo alla gestione dei servizi.

Il formato del corpo della richiesta è il seguente:

    
<PersistentVMRole xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ConfigurationSets>
    <ConfigurationSet>
      <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>
      <InputEndpoints>
        <InputEndpoint>
          <LoadBalancedEndpointSetName>name-of-loadbalanced-set</LoadBalancedEndpointSetName>
          <LocalPort>local-port-number</LocalPort>
          <Name>name-of-endpoint</Name>
          <Port>external-port-number</Port>
          <LoadBalancerProbe>
            <Path>path-of-probe</Path>
            <Port>port-assigned-to-probe</Port>
            <Protocol>probe-protocol</Protocol>
          </LoadBalancerProbe>     
          <Protocol>endpoint-protocol</Protocol>
          <EnableDirectServerReturn>enable-direct-server-return</EnableDirectServerReturn>
          <EndpointAcl>
            <Rules>
              <Rule>
                <Order>priority-of-the-rule</Order>
                <Action>permit-rule</Action>
                <RemoteSubnet>subnet-of-the-rule</RemoteSubnet>
                <Description>description-of-the-rule</Description>
              </Rule>
            </Rules>
          </EndpointAcl>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <NetworkSecurityGroup>network-security-group</NetworkSecurityGroup>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
        <PublicIP>
      <PublicIPs>
    <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>
      <Certificates>
        <Certificate>
          <Thumbprint>certificate-thumbprint</Thumbprint>
          <ThumbprintAlgorithm>certificate-algorithm</ThumbprintAlgorithm>
        </Certificate>
      </Certificates>
    </ResourceExtensionReference>
    </ForceUpdate>force-update</ForceUpdate>
  </ResourceExtensionReferences>
  <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
  <DataVirtualHardDisks>
    <DataVirtualHardDisk>
      <HostCaching>caching-mode</HostCaching>
      <DiskName>name-of-disk</DiskName>
      <Lun>logical-unit-number</Lun>
      <LogicalDiskSizeInGB>size-in-gb-of-data-disk</LogicalDiskSizeInGB>
      <MediaLink>path-to-vhd</MediaLink>
    </DataVirtualHardDisk>
  </DataVirtualHardDisks>
  <OSVirtualHardDisk>
    <HostCaching>caching-mode</HostCaching>
    <DiskLabel>label-of-operating-system-disk</DiskLabel>
    <MediaLink>path-to-vhd</MediaLink>
    <SourceImageName>name-of-source-image</SourceImageName>
  </OSVirtualHardDisk>
  <RoleSize>size-of-virtual-machine</RoleSize>
  <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>   
</PersistentVMRole>

Nella tabella indicata di seguito vengono descritti gli elementi del corpo della richiesta.

 

Nome elemento Descrizione

ConfigurationSets

Facoltativo. Contiene una raccolta di set di configurazione tramite cui vengono definite le impostazioni di configurazione dell'applicazione e di sistema.

ResourceExtensionReferences

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

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

AvailabilitySetName

Facoltativo. Specifica il nome di una raccolta di macchine virtuali. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità.

DataVirtualHardDisks

Facoltativo. Contiene i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi dati, vedere Gestisci dischi e immagini.

OSVirtualHardDisk

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

RoleSize

Facoltativo. Specifica la dimensione della macchina virtuale. La dimensione predefinita è Piccola. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere la pagina relativa alle dimensioni delle macchine virtuali e dei servizi cloud per Azure.

ProvisionGuestAgent

Facoltativo. Indica se nella macchina virtuale è installato l'agente VM. Per eseguire un'estensione di risorsa in una macchina virtuale, è necessario che questo agente sia installato.

I valori possibili sono:

  • true

  • false

Se l'agente VM è stato già installato in una macchina virtuale, il valore non può essere false.

Contiene una raccolta di set di configurazione tramite cui vengono definite le impostazioni di configurazione dell'applicazione e di sistema.

 

Nome elemento Descrizione

ConfigurationSetType

Obbligatorio. È possibile aggiornare solo le impostazioni nel set di NetworkConfiguration.

InputEndpoints

Facoltativo. Contiene una raccolta di endpoint esterni per la macchina virtuale.

SubnetNames

Elenco di nomi di subnet della rete virtuale cui appartiene la distribuzione.

Nota: non è consentito eseguire l'aggiornamento a un elenco vuoto.

Se questo elemento viene usato con l'elemento StaticVirtualNetworkIPAddress, gli aggiornamenti non sono consentiti per questo parametro.

StaticVirtualNetworkIPAddress

Facoltativo. Specifica l'indirizzo IP interno della macchina virtuale in una rete virtuale. Se si specifica questo elemento, è necessario specificare anche l'elemento SubnetNames con una sola subnet definita. L'indirizzo IP specificato in questo elemento deve appartenere alla subnet definita in SubnetNames e non deve essere tra i primi quattro indirizzi IP né l'ultimo indirizzo IP nella subnet.

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

NetworkSecurityGroup

Facoltativo. Rappresenta il nome del gruppo di sicurezza di rete che verrà associato alla macchina virtuale. Il gruppo di sicurezza di rete deve esistere nel contesto della sottoscrizione e deve essere stato creato nella stessa area in cui verrà distribuita la macchina virtuale.

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

Contiene una raccolta di endpoint esterni per la macchina virtuale.

 

Nome elemento Descrizione

InputEndpoint

Obbligatorio. Specifica le proprietà mediante le quali viene definito un endpoint esterno per la macchina virtuale.

LoadBalancedEndpointSetName

Facoltativo. Specifica il nome di un set di endpoint con carico bilanciato. Se specificato per un endpoint, questo elemento viene aggiunto al set

Non impostare questa proprietà se si aggiunge l'endpoint per la connessione alla macchina virtuale tramite il desktop remoto.

noteNota
Il nome dell'endpoint deve essere univoco nell'ambito della macchina virtuale.

LocalPort

Obbligatorio. Specifica la porta interna su cui la macchina virtuale è in ascolto.

Nome

Obbligatorio. Specifica il nome dell'endpoint esterno.

Porta

Obbligatorio. Specifica la porta esterna da usare per l'endpoint.

LoadBalancerProbe

Facoltativo. Contiene le proprietà mediante le quali vengono definite le impostazioni dell'endpoint usate dal dispositivo di bilanciamento del carico per monitorare la disponibilità della macchina virtuale prima di inoltrarvi il traffico.

Protocollo

Obbligatorio. Specifica il protocollo di trasporto per l'endpoint.

I valori possibili sono:

  • TCP

  • UDP

Il valore predefinito è false.

EnableDirectServerReturn

Facoltativo. Specifica se Direct Server Return viene usato dall'endpoint. L'elemento EnableDirectServerReturn non è supportato per gli endpoint RDP, SSH o WinRM né quando la porta pubblica e quella locale di un endpoint sono diverse. Non è possibile disabilitare EnableDirectServerReturn in un endpoint. Se si imposta EnableDirectServerReturn su true, non è possibile aggiornare il valore di Protocol. È consigliabile usare questo elemento solo quando si installano le macchine virtuali per SQL Server e i gruppi di disponibilità AlwaysOn. Per altre informazioni, vedere Disponibilità elevata e ripristino di emergenza di SQL Server in Macchine virtuali di Azure.

I valori possibili sono:

  • true

  • false

Il valore predefinito è false.

EndpointAcl

Facoltativo. Contiene una raccolta di regole mediante le quali viene controllato il traffico di rete all'endpoint.

L'elemento EndpointAcl è disponibile solo se si usa la versione 2013-06-01 o una versione successiva.

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 2014-05-01 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 2014-06-01 o una versione successiva.

Contiene le proprietà mediante le quali vengono definite le impostazioni dell'endpoint usate dal dispositivo di bilanciamento del carico per monitorare la disponibilità della macchina virtuale prima di inoltrarvi il traffico.

 

Nome elemento Descrizione

Percorso

Facoltativo. Specifica il percorso relativo da verificare per determinare lo stato di disponibilità della macchina virtuale. Se il protocollo è impostato su TCP, questo valore deve essere NULL.

Esempio:

path

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

Porta

Facoltativo. Specifica la porta da usare per verificare lo stato di disponibilità della macchina virtuale.

Protocollo

Facoltativo. Specifica il protocollo da usare per verificare lo stato di disponibilità della macchina virtuale.

I valori possibili sono:

  • HTTP

  • TCP

IntervalInSeconds

Facoltativo. Specifica l'intervallo del probe di bilanciamento del carico in secondi. Il valore minimo è 5 secondi. Il valore predefinito è 15 secondi.

TimeoutInSeconds

Facoltativo. Specifica il timeout del probe di bilanciamento del carico in secondi. Il valore minimo è 11 secondi. Il valore predefinito è 31 secondi.

Contiene una raccolta di regole mediante le quali viene controllato il traffico di rete all'endpoint.

 

Nome elemento Descrizione

Regole

Obbligatorio. Specifica una raccolta di regole di controllo di accesso. Sono consentite fino a 50 regole.

Rule

Obbligatorio. Specifica la definizione di una regola di controllo di accesso.

Order

Obbligatorio. Specifica la priorità della regola. Il valore può essere compreso tra 0 e 65535. Il numero di ordine deve essere univoco per ciascuna regola della raccolta. Più basso è il numero di ordine, più elevata è la priorità della regola.

Azione

Obbligatorio. Specifica se il traffico che corrisponde alla regola deve essere consentito o negato.

I valori possibili sono:

  • permit

  • deny

RemoteSubnet

Obbligatorio. Specifica la subnet per la regola. La subnet deve essere nella notazione CIDR (Classless Inter-Domain Routing) IPV4 ed essere valida,

ad esempio, 10.0.0.0/24.

Descrizione

Facoltativo. Specifica una descrizione per la regola. La lunghezza massima della descrizione è pari a 256 caratteri.

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 2014-06-01 o una versione successiva.

Contiene un elenco di subnet a cui appartiene 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

DataVirtualHardDisk

Obbligatorio. Specifica le proprietà usate per creare un disco dati.

HostCaching

Facoltativo. Specifica il comportamento di memorizzazione nella cache del disco dati per l'efficienza di lettura/scrittura. L'impostazione di questa proprietà influisce sulla coerenza del disco.

I valori possibili sono:

  • None

  • ReadOnly

  • ReadWrite

Il valore predefinito è None.

DiskName

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione, questo elemento viene usato per identificare il disco da aggiungere. Se vengono creati da Azure un nuovo disco e il VHD associato, questo elemento non viene usato e tramite Azure viene assegnato un nome univoco costituito da una combinazione di nome della distribuzione, nome del ruolo e numero di identificazione.

Il nome del disco può contenere unicamente caratteri alfanumerici, caratteri di sottolineatura, punti o trattini. La lunghezza del nome non deve superare i 256 caratteri. Il nome non deve terminare con un punto o un trattino.

Lun

Facoltativo. Specifica il numero di unità logica (LUN) per il disco dati. Se quello aggiunto è il primo disco, questo elemento è facoltativo e viene usato il valore predefinito 0. Se vengono aggiunti più dischi, questo elemento è obbligatorio.

È possibile ottenere il ruolo per trovare i numeri LUN già usati.

I valori LUN validi sono compresi tra 0 e 31.

LogicalDiskSizeInGB

Facoltativo. Specifica le dimensioni, in GB, di un disco vuoto da collegare alla macchina virtuale. Se il disco che viene aggiunto è già registrato nella sottoscrizione, questo elemento viene ignorato. Se il disco e il VHD vengono creati da Azure quando vengono aggiunti, tramite questo elemento vengono definite le dimensioni del nuovo disco.

Il numero di dischi che si possono aggiungere a una macchina virtuale viene limitato dalla dimensione della macchina. Per altre informazioni, vedere la pagina relativa alle dimensioni delle macchine virtuali e dei servizi cloud per Azure.

MediaLink

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione oppure il VHD per il disco già esiste nell'archiviazione BLOB, questo elemento viene ignorato. Se un file VHD non esiste nell'archiviazione BLOB, tramite questo elemento viene definito il percorso del nuovo VHD creato al momento dell'aggiunta del nuovo disco.

Esempio:

http://example.blob.core.windows.net/disks/mydatadisk.vhd

SourceMediaLink

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione oppure il VHD per il disco non esiste nell'archiviazione BLOB, questo elemento viene ignorato. Se il file VHD esiste nell'archiviazione BLOB, tramite questo elemento viene definito il percorso del VHD e da quest'ultimo viene registrato un disco e collegato alla macchina virtuale.

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

 

Nome elemento Descrizione

HostCaching

Facoltativo. Specifica la modalità di memorizzazione nella cache del disco del sistema operativo. Questa impostazione influisce sulla coerenza e sulle prestazioni del disco.

I valori possibili sono:

  • ReadOnly

  • ReadWrite

Il valore predefinito è ReadWrite.

noteNota
La modifica di questo valore comporta il riavvio della macchina virtuale.

DiskLabel

Facoltativo. Specifica la descrizione del disco.

MediaLink

Facoltativo. Specifica il percorso del file VHD creato quando viene specificata un'immagine della piattaforma da SourceImageName.

Esempio:

http://contoso.blob.core.windows.net/disks/mydisk.vhd

SourceImageName

Facoltativo. Specifica il nome dell'immagine da usare per la creazione della macchina virtuale. È possibile specificare un'immagine utente o un'immagine della piattaforma. 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 in Azure. Se si specifica un'immagine della piattaforma, viene creato un VHD associato e sarà necessario usare l'elemento MediaLink per specificare il percorso nella risorsa di archiviazione in cui verrà posizionato il VHD.

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.

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 Elencare le estensioni delle risorse per trovare i nomi di estensioni di risorsa disponibili.

Version

Obbligatorio. Specifica la versione dell'estensione di risorsa. È possibile impostare questo valore su * per usare l'ultima versione dell'estensione. Se l'estensione è stata aggiunta o aggiornata recentemente, è necessario verificare che il valore di ReplicationCompleted sia impostato su true per poter usare la versione dell'estensione. Per determinare lo stato della replica e le versioni disponibili dell'estensione, è possibile usare Elencare le versioni dell'estensione di una 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

  • uninstall

Il valore predefinito è enable. È necessario aggiungere una nuova estensione con stato enable.

Lo stato uninstall è disponibile solo se si usa la versione 2014-04-01 o successiva.

Certificates

Facoltativo. Contiene una raccolta di certificati installati nella machina virtuale e usati dall'estensione. Per poter essere inclusi in questa richiesta, i certificati devono essere aggiunti al servizio cloud. Per altre informazioni, vedere Aggiungere un certificato di servizio.

L'elemento Certificates è disponibile solo se si usa la versione 2014-06-01 o una versione successiva.

ForceUpdate

Facoltativo.

Valore booleano. Impostato su "true" se si vuole riapplicare una configurazione a un'estensione quando la configurazione non è stata aggiornata.

L'elemento ForceUpdate è disponibile solo se si usa la versione 2014-10-01 o una versione successiva.

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. Se la configurazione dell'estensione è in formato XML, questo valore viene convalidato usando lo schema pubblico o privato. Lo schema usato dipende dal valore di Type.

Se invece la configurazione dell'estensione è in formato JSON, questo valore deve includere un oggetto JSON valido. Non è possibile usare gli schemi pubblici o privati per convalidare l'oggetto. Per usare un oggetto JSON, il numero di versione deve essere 2014-04-01 o successivo.

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.

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 202 (Accettato). 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.

Per modificare la configurazione di una macchina virtuale è inoltre possibile usare il cmdlet Update-AzureVM.

Mostra:
© 2015 Microsoft