Modificare la configurazione di distribuzione

Articolo
07/19/2023

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.

Condividi tramite