Todos los productos
Search
Centro de documentos

:ReInitDisk

Última actualización: Sep 02, 2026

Esta operación permite reinicializar un disco para restaurarlo al estado que tenía en el momento de su creación.

Descripción

Tenga en cuenta los puntos a continuación al ejecutar esta operación:

  • El disco que se va a reinicializar debe estar en estado In Use (In_use) y la instancia a la que está conectado debe encontrarse en estado Stopped (Stopped).

  • Si una instancia nunca se ha iniciado desde su creación, no es posible reinicializar los discos conectados a ella.

  • No se puede reinicializar un disco si ya se creó una instantánea local para él.

  • Al reinicializar un disco del sistema, este se restaura al estado de la imagen con la que se creó. Si la imagen de origen se eliminó, no es posible reinicializar el disco del sistema.

  • Cuando se reinicializa un disco de datos creado de forma independiente, este queda como un disco de datos vacío.

  • Si un disco de datos se creó a partir de una instantánea, al reinicializarlo se restaura al estado de dicha instantánea de origen.

Nota

Si la instantánea de origen se eliminó, no se puede reinicializar el disco y se devuelve un error.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda ejecutar esta operación en OpenAPI Explorer. Esta herramienta también genera de forma automática el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíReInitDisk

La operación que desea ejecutar. Establezca el valor en ReInitDisk.

DiskIdStringSíd-bp67acfmxazb4ph****

El ID del disco.

PasswordStringNoEcsV587!

Indica si se debe restablecer la contraseña de la instancia al reinicializar su disco del sistema. La contraseña debe tener entre 8 y 30 caracteres e incluir como mínimo tres de los siguientes tipos: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Los caracteres especiales incluyen:

( ) ` ~ ! @ # $ % ^ & * - _ + = | { } [ ] : ; ' < > , . ? /
                                

En instancias Windows, la contraseña no puede comenzar con una barra diagonal (/).

Nota Si se especifica el parámetro Password, se recomienda enviar las solicitudes mediante HTTPS para proteger la contraseña.
KeyPairNameStringNotestKeyPairName

El nombre del key pair.

Nota Este parámetro solo aplica a instancias Linux. Es posible vincular un key pair SSH a la instancia como credencial de inicio de sesión al reinicializar su disco del sistema. Una vez vinculado el key pair SSH, se deshabilita el método de inicio de sesión con usuario y contraseña para dicha instancia.
AutoStartInstanceBooleanNotrue

Indica si la instancia se inicia automáticamente después de reinicializar el disco.

Valor predeterminado: false.

SecurityEnhancementStrategyStringNoActive

Indica si se utiliza Security Center de forma gratuita tras reinicializar el disco del sistema. Valores válidos:

  • Active: Security Center se usa sin costo adicional después de reemplazar el disco del sistema. Este valor solo aplica a imágenes públicas.
  • Deactive: Security Center no se usa de forma gratuita después de reemplazar el disco del sistema. Este valor aplica a todas las imágenes.

Valor predeterminado: Deactive.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=ReInitDisk
&DiskId=d-bp67acfmxazb4ph****
&KeyPairName=testKeyPairName
&AutoStartInstance=true
&SecurityEnhancementStrategy=Active
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<ReInitDiskResponse>
      <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReInitDiskResponse>

Formato JSON

{
    "RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

404

InvalidDiskId.NotFound

The specified disk does not exist.

El mensaje de error indica que el parámetro DiskId especificado no existe. Compruebe si el ID del disco es correcto.

403

IncorrectDiskStatus

The current disk status does not support this operation.

El mensaje de error indica que la operación no es compatible con el estado actual del disco. Asegúrese de que el disco esté disponible y de que su cuenta no tenga pagos pendientes asociados a él.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

El mensaje de error indica que la operación no es compatible con el estado actual del recurso.

403

InstanceLockedForSecurity

The instance is locked due to security.

El mensaje de error indica que la operación no es compatible porque la instancia está bloqueada por motivos de seguridad.

403

InvalidSnapshot.TooOld

The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time.

El mensaje de error indica que las instantáneas creadas antes del 15 de julio de 2013 no admiten esta operación.

403

OperationDenied

The snapshot which is used to create the specified disk has been deleted.

El mensaje de error indica que la instantánea utilizada para crear el disco especificado no existe.

403

InstanceExpiredOrInArrears

The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).

El mensaje de error indica que la instancia de suscripción ha caducado. Renueve la instancia primero.

403

DiskCreatingSnapshot

The operation is denied due to a snapshot of the specified disk is not completed yet.

El mensaje de error indica que se está creando una instantánea del disco especificado.

403

InvalidSourceSnapshot

The snapshot which is used to create the specified disk has been deleted.

El mensaje de error indica que la instantánea utilizada para crear el disco especificado se eliminó.

404

InvalidImageId.NotFound

The specified ImageId does not exist.

El mensaje de error indica que la imagen especificada no existe en esta cuenta. Compruebe si el ID de la imagen es correcto.

403

SharedImageDeleted

The specified image by others shared is deleted.

El mensaje de error indica que la imagen compartida especificada se eliminó.

400

InvalidPassword.Malformed

The specified parameter "Password" is not valid.

El mensaje de error indica que el parámetro Password especificado no es válido.

400

DiskCategory.OperationNotSupported

The operation is not supported to the specified disk due to its disk category

El mensaje de error indica que la categoría del disco especificado no admite la operación.

400

InvalidKeyPairName.NotFound

The specified KeyPairName does not exist.

El mensaje de error indica que el parámetro KeyPairName especificado no existe.

400

DependencyViolation.IoOptimize

The specified parameter InstanceId is not valid.

El mensaje de error indica que la optimización de E/S de la instancia no es válida.

403

UserNotInTheWhiteList

The user is not in volume white list.

El mensaje de error indica que usted no se encuentra en la lista blanca de Shared Block Storage. Envíe un ticket para solicitar el permiso correspondiente.

400

InvalidRegionId.MalFormed

The specified RegionId is not valid

El mensaje de error indica que el parámetro RegionId especificado no es válido.

404

InvalidDiskId.OperationNotSupported

The operation is not supported due to image not exist.

El mensaje de error indica que la imagen especificada no existe.

403

InvalidParameter.KMSKeyId.KMSUnauthorized

ECS service have no right to access your KMS.

El mensaje de error indica que ECS no tiene autorización para acceder a sus recursos de KMS.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

El mensaje de error indica que ocurrió un error interno. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, visite el Centro de errores de API.