ResetDisk - - Centro de documentación de Alibaba Cloud

Restaura un disco a partir de una instantánea del mismo.

Descripción

Al llamar a esta operación, tenga en cuenta los puntos a continuación:

El disco debe estar en estado In Use (In_Use) o Unattached (Available).
La instancia de Elastic Compute Service (ECS) a la que está conectado el disco debe estar en estado Stopped (Stopped). Llame a la operación StopInstances para detener una instancia.
La instantánea especificada por el parámetro SnapshotId debe haberse creado a partir del disco indicado por el parámetro DiskId.
Si al llamar a la operación DescribeInstances para consultar información de instancias, la respuesta contiene {"OperationLocks": {"LockReason" : "security"}} para una instancia, dicha instancia está bloqueada por motivos de seguridad y no se pueden realizar operaciones sobre ella.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ResetDisk	La operación que desea ejecutar. Establezca el valor en ResetDisk.
DiskId	String	Sí	d-bp199lyny9b3****	El ID del disco que desea restaurar.
SnapshotId	String	Sí	s-bp199lyny9b3****	El ID de la instantánea que desea usar para restaurar el disco.
DryRun	Boolean	No	false	Especifica si se debe comprobar la validez de la solicitud sin ejecutarla realmente. Valores válidos: true: Se comprueba la validez de la solicitud, pero no se ejecuta. Las comprobaciones incluyen los parámetros obligatorios, el formato de la solicitud y los límites de estado de los recursos. Si la comprobación falla, se devuelve el mensaje de error correspondiente. Si la comprobación es correcta, se devuelve el código de error `DryRunOperation`. false: Se comprueba la validez de la solicitud. Si la comprobación es correcta, se ejecuta la solicitud. Valor predeterminado: false.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	F3CD6886-D8D0-4FEE-B93E-1B732396****	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=ResetDisk
&DiskId=d-bp199lyny9b3****
&SnapshotId=s-bp199lyny9b3****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ResetDiskResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B732396****</RequestId>
</ResetDiskResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	Mensaje de error devuelto porque la categoría del disco especificado no admite esta operación.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid	Mensaje de error devuelto porque el parámetro RegionId especificado no es válido.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Mensaje de error devuelto porque la solicitud se determinó como válida cuando el parámetro DryRun se estableció en true.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Mensaje de error devuelto porque la operación no es compatible mientras el disco se encuentra en su estado actual. Asegúrese de que el disco esté utilizable y de que no tenga pagos pendientes asociados a él.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensaje de error devuelto porque la operación no es compatible mientras el recurso se encuentra en su estado actual.
403	InstanceLockedForSecurity	The instance is locked due to security.	Mensaje de error devuelto porque la operación no es compatible mientras la instancia está bloqueada por motivos de seguridad.
403	InvalidParameter.Mismatch	The specified snapshot is not created from the specified disk.	Mensaje de error devuelto porque no se puede usar una instantánea cifrada para restaurar un disco no cifrado.
403	InvalidSnapshot.TooOld	The snapshotId is created before 2013-07-15, it cannot be restored since the first time the disk detached.	Mensaje de error devuelto porque las instantáneas creadas antes del 15 de julio de 2013 no admiten esta operación.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Mensaje de error devuelto porque la instancia de suscripción ha caducado. Renueve la instancia e inténtelo de nuevo.
403	OperationDenied	The specified snapshot dees not support ResetDisk.	Mensaje de error devuelto porque la instantánea especificada no admite esta operación.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.	Mensaje de error devuelto porque la instantánea especificada aún se está creando.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Mensaje de error devuelto porque el saldo de su cuenta es insuficiente. Agregue fondos a su cuenta e inténtelo de nuevo.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Mensaje de error devuelto porque la operación no es compatible mientras el servicio de instantáneas no esté activado.
403	Operation.Conflict	The operation may conflicts with others.	Mensaje de error devuelto porque la operación entra en conflicto con otras operaciones.
403	UserNotInTheWhiteList	The user is not in disk white list.	Mensaje de error devuelto porque no tiene autorización para gestionar el disco. Inténtelo nuevamente cuando cuente con la autorización correspondiente.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Mensaje de error devuelto porque la clave maestra del cliente (CMK) no está habilitada cuando se especifica un ID de clave de Key Management Service (KMS) para el disco. Llame a la operación DescribeKey de KMS para consultar información sobre la CMK especificada.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Mensaje de error devuelto porque ECS no tiene autorización para acceder a sus recursos de KMS.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	Mensaje de error devuelto porque el ID de clave de KMS especificado no existe.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Mensaje de error devuelto porque el parámetro DiskId especificado no existe. Compruebe si el ID del disco es correcto.
404	Disk.NotFound	The specified disk does not exist.	Mensaje de error devuelto porque el parámetro DiskId especificado no existe. Compruebe si el ID del disco es correcto.
404	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.	Mensaje de error devuelto porque el parámetro SnapshotId especificado no existe.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el ID de la instancia es correcto.
500	InternalError	The request processing has failed due to some unknown error.	Mensaje de error devuelto porque se ha producido un error interno. Inténtelo de nuevo más tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Mensaje de error devuelto porque se ha producido 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.