Scambiare la distribuzione

L'operazione asincrona Swap Deployment avvia uno scambio di indirizzi IP virtuali tra gli ambienti di distribuzione di gestione temporanea e di produzione per un servizio. Se il servizio è in esecuzione nell'ambiente di gestione temporanea, viene trasferito all'ambiente di produzione. Se in esecuzione nell'ambiente di produzione, viene trasferito all'ambiente di gestione temporanea.

Richiesta

La richiesta di Swap Deployment può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione e <cloudservice-name> con il nome del servizio cloud.

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

Parametri dell'URI

Nessuno.

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

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

  
<?xml version="1.0" encoding="utf-8"?>  
<Swap xmlns="http://schemas.microsoft.com/windowsazure">  
  <Production>production-deployment-name</Production>  
  <SourceDeployment>deployment-name-to-be-swapped-with-production</SourceDeployment>  
</Swap>  

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

Nome dell'elemento	Descrizione
Produzione	Obbligatorio. Nome della distribuzione in produzione.
SourceDeployment	Obbligatorio. Nome della distribuzione di origine.

Risposta

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

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 Get Operation Status con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Corpo della risposta

No.

Osservazioni

Se l'operazione Swap Deployment viene specificata con nomi di distribuzione che non corrispondono a quelli attualmente in produzione e gestione temporanea, viene restituito il codice di stato 409 (Conflitto).

È possibile sostituire gli indirizzi VIP solo se il numero degli endpoint specificati dalla definizione del servizio è identico per entrambe le distribuzioni. Ad esempio, se si aggiunge un endpoint HTTPS a un ruolo Web che ha esposto un solo endpoint HTTP, non è possibile aggiornare il servizio scambiando gli indirizzi VIP; è necessario eliminare la distribuzione di produzione e ridistribuire. È possibile ottenere informazioni sugli endpoint usati tramite l'operazione Get Deployment .