Modificare la configurazione di distribuzione

  • Articolo

L'operazione asincrona Change Deployment Configuration avvia una modifica della configurazione della distribuzione.

Richiesta

La richiesta di Change Deployment Configuration può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud, <deployment-slot> con staging o production e <deployment-name> con il nome univoco della distribuzione.

Metodo URI richiesta
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

Parametri dell'URI

Parametro URI Descrizione
comp=config Obbligatorio. Specifica che una modifica deve essere apportata alla configurazione della distribuzione.

Intestazioni richiesta

La tabella seguente descrive le intestazioni della richiesta.

Intestazione della richiesta Descrizione
Content-Type Obbligatorio. Impostare questa intestazione su application/xml.
x-ms-version Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2009-10-01 o superiore.

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

  
<?xml version="1.0" encoding="utf-8"?>  
<ChangeConfiguration xmlns="http://schemas.microsoft.com/windowsazure">  
  <Configuration>base-64-encoded-configuration-file</Configuration>  
  <TreatWarningsAsError>warnings-as-errors</TreatWarningsAsError>  
  <Mode>type-of-change</Mode>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</ChangeConfiguration>

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

Nome dell'elemento Descrizione
Configurazione Obbligatorio. Specifica il file di configurazione del servizio con codifica Base 64 per la distribuzione.
TreatWarningsAsError Facoltativa. Indica se considerare gli avvisi come errori.

I valori possibili sono:

- true
- false

Se non è specificato, il valore predefinito è false. Se è impostato su true, l'aggiornamento verrà bloccato se vengono rilevati avvisi.

L'elemento TreatWarningsAsError è disponibile solo usando la versione 2011-04-01 o successiva.
Mode Facoltativa. I valori possibili sono:

- Auto
- Manual
- Simultaneous

Se non viene specificato, il valore predefinito è Auto. Se impostato su Manual, WalkUpgradeDomain deve essere chiamato per applicare l'aggiornamento. Se è impostato su Auto, l'aggiornamento viene applicato automaticamente a ogni dominio di aggiornamento del servizio.

L'elemento Mode è disponibile solo usando la versione 2011-08-01 o successiva.

L'impostazione Simultaneous è disponibile solo usando la versione 2013-03-01 o successiva.
Nome Facoltativa. Rappresenta il nome di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 25 coppie nome/valore per le proprietà estese.

La lunghezza massima dell'elemento Name è di 64 caratteri. Nel nome sono validi solo i caratteri alfanumerici e i caratteri di sottolineatura. Il nome deve iniziare con una lettera. Se si tenta di usare altri caratteri, di immettere un elemento che inizia con un carattere diverso da una lettera o di specificare un nome identico a quello di un'altra proprietà estesa appartenente allo stesso servizio cloud, si verificherà un errore con codice di stato 400 (Richiesta non valida).

L'elemento Name è disponibile solo usando la versione 2012-03-01 o successiva.
Valore Facoltativa. Rappresenta il valore di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 25 coppie nome/valore per le proprietà estese e il valore di ciascuna proprietà contiene un massimo di 255 caratteri.

È possibile eliminare una proprietà estesa impostando il valore su NULL.

L'elemento Value è disponibile solo usando la versione 2012-03-01 o successiva.
ExtensionConfiguration Facoltativa. Rappresenta un'estensione aggiunta al servizio cloud. In Azure un processo può essere eseguito come estensione di un servizio cloud. È necessario aggiungere un'estensione al servizio cloud usando Aggiungi estensione prima di poter essere aggiunta alla distribuzione durante una modifica della configurazione.

L'elemento ExtensionConfiguration è disponibile solo se si utilizza la versione 01.03.13 o una versione successiva.

ExtensionConfiguration

Rappresenta un'estensione aggiunta al servizio cloud.

Nome dell'elemento Descrizione
AllRoles Facoltativa. Specifica un elenco di estensioni applicate a tutti i ruoli in una distribuzione.
Estensione Obbligatorio. Rappresenta un'estensione che deve essere distribuita a un ruolo in un servizio cloud.
NamedRoles Facoltativa. Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.

Estensione

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

Nome dell'elemento Descrizione
ID Obbligatorio. 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.
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 Obbligatorio. Rappresenta un ruolo specifico a cui viene aggiunta l'estensione.
RoleName Obbligatorio. Specifica il nome del ruolo.
Estensione Obbligatorio. Rappresenta un'estensione che deve essere distribuita a un ruolo in un servizio cloud.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Poiché Change Deployment Configuration è un'operazione asincrona, è necessario chiamare Recupera stato operazione per determinare se l'operazione è completata, ha avuto esito negativo o è ancora in corso.

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. Per un'operazione asincrona, è possibile chiamare Recupera stato operazione con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Corpo della risposta

Nessuno.