Ricreare l'immagine dell'istanza del ruolo

Tramite l'operazione asincrona Reimage Role Instance il sistema operativo viene reinstallato nelle istanze dei ruoli Web o di lavoro.

Richiesta

La richiesta di Reimage Role Instance 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 della distribuzione. Sostituire <role-instance-name> con il nome dell'istanza del ruolo.

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

Parametri dell'URI

Parametro URI Descrizione
comp=reimage Obbligatorio. Specifica che per un'istanza di un ruolo deve essere ricreata l'immagine.

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. Il valore di questa intestazione deve essere impostato su 2010-10-28 o superiore.
ContentLength Obbligatorio. Deve essere 0.

Corpo della richiesta

Nessuno.

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

Quando viene ricreata l'immagine dell'istanza del ruolo, l'istanza viene portata offline e viene applicata un'immagine aggiornata del sistema operativo guest. L'istanza del ruolo viene quindi riportata online. Viene effettuato un tentativo di mantenere i dati in tutte le risorse di archiviazione locale quando viene ricreata l'immagine del ruolo. Tuttavia, in caso di errore hardware temporaneo, la risorsa di archiviazione locale potrebbe andare persa. Se l'applicazione richiede che i dati vengano resi persistenti, è consigliabile scriverli su un'origine dati durevole, ad esempio un'unità Azure. Tutti i dati scritti in una directory locale diversa da quella definita dalla risorsa di archiviazione locale andranno persi quando viene ricreata l'immagine de ruolo.