Restablecer la imagen inicial de la instancia de rol

La operación asincrónica Reimage Role Instance reinstala el sistema operativo en instancias de roles web o de roles de trabajo.

Request

La solicitud Reimage Role Instance se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción, <cloudservice-name> por el nombre del servicio en la nube, <deployment-slot> por staging o production, o <deployment-name> por el nombre de la implementación. Reemplace <role-instance-name> por el nombre de la instancia de rol.

Método	URI de solicitud
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>

Parámetros de identificador URI

Parámetro del URI	Descripción
comp=reimage	Necesario. Especifica que se debe restablecer la imagen inicial de una instancia de un rol.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
Content-Type	Necesario. Establezca este encabezado en application/xml.
x-ms-version	Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. El valor de este encabezado debe establecerse 2010-10-28 en o superior.
ContentLength	Necesario. Se debe establecer en 0.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar.

Encabezado de respuesta	Descripción
x-ms-request-id	Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración. Para una operación asincrónica, puede llamar a Get Operation Status con el valor del encabezado para determinar si la operación se ha completado, ha producido un error o sigue en curso.

Cuerpo de la respuesta

Ninguno.

Comentarios

Cuando se restablece la imagen inicial de una instancia de rol, se pone la instancia sin conexión y se aplica una nueva imagen del sistema operativo invitado. Después se vuelve a poner en línea la instancia de rol. Se intenta mantener los datos en cualquier recurso de almacenamiento local cuando se está restableciendo la imagen inicial del rol; sin embargo, en caso de un error de hardware transitorio, se perderá el recurso de almacenamiento local. Si la aplicación necesita que se almacenen estos datos, se recomienda que los escriba en un origen de datos duradero, como una unidad de Azure. Los datos que se escriban en un directorio local distinto del definido por el recurso de almacenamiento local se perderán cuando se restablezca la imagen inicial del rol.