Volver a generar una instancia de rol
La operación asincrónica Rebuild Role Instance reinstala el sistema operativo en instancias de roles web o en roles de trabajo, e inicializa los recursos de almacenamiento que emplean aquellas. Si no desea inicializar los recursos de almacenamiento, puede usar la instancia de rol Reimage.
Request
La solicitud Rebuild 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=rebuild |
Necesario. Especifica que se deben volver a generar una instancia de rol y sus recursos. |
resources=<resources> |
Necesario. Especifica los recursos que se deben volver a generar. Actualmente, el único valor admitido es allLocalDrives. |
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 2013-06-01 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 vuelve a generar la instancia de rol, se desconecta la instancia, se aplica una imagen nueva del sistema operativo invitado y se inicializan las unidades de datos que están conectadas a la instancia. Después se vuelve a poner en línea la instancia de rol.