Esporta (0) Stampa
Espandi tutto

Modificare la configurazione di distribuzione

Aggiornamento: aprile 2014

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

L'operazione Change Deployment Configuration è un'operazione asincrona. Per determinare se il servizio di gestione ha terminato l'elaborazione della richiesta, chiamare Ottenere lo stato delle operazioni. Per ulteriori informazioni sulle operazioni asincrone, vedere Rilevamento delle richieste asincrone di gestione del servizio.

La richiesta di Change Deployment Configuration può essere specificata come indicato di seguito. Si noti che è possibile modificare la configurazione di una distribuzione specificando l'ambiente di distribuzione (gestione temporanea o produzione) oppure specificando il nome univoco della distribuzione.

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 e <deployment-name> con il nome univoco della distribuzione.

 

Metodo URI della richiesta Versione HTTP

POST

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

HTTP/1.1

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

HTTP/1.1

 

Parametro URI Descrizione

comp=config

Obbligatorio. Specifica che una modifica deve essere apportata alla configurazione della distribuzione.

Nella tabella seguente vengono descritte le intestazioni delle richieste.

 

Intestazione della richiesta Descrizione

Content-Type

Obbligatoria. Impostare questa intestazione su application/xml.

x-ms-version

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

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>
      </Extension>
      ...
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
          </Extension>
          ...
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
</ChangeConfiguration>

ImportantImportante
L'ordine degli elementi nel corpo della richiesta è significativo. Se un elemento è necessario, deve essere visualizzato nel contenuto XML nell'ordine sopra indicato.

Nella tabella seguente vengono descritti gli elementi chiave nel corpo della richiesta:

 

Nome elemento Descrizione

Configurazione

Obbligatorio. Specifica il file di configurazione del servizio con codifica Base 64 per la distribuzione.

TreatWarningsAsError

Facoltativo. 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 se si utilizza la versione del 01/04/2011 o una versione successiva.

Mode

Facoltativo. I valori possibili sono:

  • Auto

  • Manual

  • Simultaneous

Se non viene specificato, il valore predefinito è Auto. Se è impostato su Manual, è necessario chiamare WalkUpgradeDomain 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 se si utilizza la versione 2011-08-01 o una versione successiva.

L'impostazione Simultaneous è disponibile solo se si utilizza la versione 2012-12-01 o una versione successiva.

Name

Facoltativo. 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 utilizzare 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 se si utilizza la versione 2012-03-01 o una versione successiva.

Valore

Facoltativo. 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 se si utilizza la versione 2012-03-01 o una versione successiva.

ExtensionConfiguration

Facoltativo. Rappresenta un'estensione aggiunta al servizio cloud. In Windows Azure un processo può essere eseguito come estensione di un servizio cloud. Ad esempio, Accesso desktop remoto o l'agente Diagnostica Windows Azure possono essere eseguiti come estensioni del servizio cloud. È necessario aggiungere un'estensione al servizio cloud utilizzando Aggiungere un'estensione prima di poterla aggiungere alla distribuzione durante una modifica della configurazione.

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

Rappresenta un'estensione aggiunta al servizio cloud.

 

Nome elemento Descrizione

AllRoles

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

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

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

 

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

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

 

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

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 Ottenere lo stato delle operazioni per determinare se l'operazione è completata, non riuscita o in corso.

Poiché Change Deployment Configuration è un'operazione asincrona, restituisce sempre il codice di stato 202 (Accettato). Per determinare il codice di stato per l'operazione dopo che è stata completata, chiamare Ottenere lo stato delle operazioni. Il codice di stato è incorporato nella risposta per questa operazione; se ha esito positivo, sarà 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. Per un'operazione asincrona, è possibile chiamare lo stato di operazione get con il valore dell'intestazione per determinare se l'operazione è completata, non riuscita o in corso. Per ulteriori informazioni, vedere Rilevamento delle richieste asincrone di gestione del servizio.

Per eseguire l'autenticazione di questa operazione, è possibile utilizzare un qualsiasi certificato di gestione associato alla sottoscrizione specificata da <subscription-id>. Per ulteriori dettagli, vedere Autenticazione di richieste di gestione dei servizi.

Nessuno.

Mostra:
© 2014 Microsoft