DetachDisk - - Centro de documentación de Alibaba Cloud

Desmonta un disco de datos pay-as-you-go o un disco del sistema de una instancia de Elastic Compute Service (ECS).

Descripción

Al llamar a esta operación, tenga en cuenta los siguientes límites:

El disco debe estar montado en una instancia de ECS y en estado In Use (In_Use).
La instancia de la que desea desmontar el disco de datos debe estar en estado Running (Running) o Stopped (Stopped).
La instancia de la que desea desmontar el disco del sistema debe estar en estado Stopped (Stopped).
Si OperationLocks en la respuesta contiene "LockReason" : "security" al consultar la información de una instancia, significa que la instancia está bloqueada por motivos de seguridad y ninguna operación tendrá efecto sobre ella.
DetachDisk es una operación asíncrona. El disco tarda aproximadamente 1 minuto en desmontarse de la instancia después de invocar la operación.

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 el 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í	DetachDisk	La operación que desea ejecutar. Establezca el valor en DetachDisk.
DiskId	String	Sí	d-bp67acfmxazb4p****	El ID del disco que se va a desmontar.
InstanceId	String	Sí	i-bp67acfmxazb4p****	El ID de la instancia de ECS de la que se va a desmontar el disco.
DeleteWithInstance	Boolean	No	false	Especifica si se debe liberar automáticamente el disco del sistema cuando se libera la instancia de la que se va a desmontar dicho disco. Valores válidos: true: El disco del sistema se libera cuando se libera la instancia. false: El disco del sistema no se libera cuando se libera la instancia. El disco del sistema se conserva como un disco de datos pay-as-you-go. Valor predeterminado: true. Tenga en cuenta los siguientes puntos: Este parámetro no se puede configurar para discos que tienen habilitada la función de montaje múltiple. Si se va a desmontar un disco de datos, el valor predeterminado es `false`.

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=DetachDisk
&DiskId=d-bp67acfmxazb4p****
&InstanceId=i-bp67acfmxazb4p****
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<DetachDiskResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDiskResponse>

Formato JSON

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	El mensaje de error devuelto porque no se estableció un parámetro obligatorio.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid	El mensaje de error devuelto porque el parámetro RegionId especificado no es válido.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot detach disk.	El mensaje de error devuelto porque la instancia a la que está montado el disco no admite el intercambio de discos en caliente.
403	IncorrectDiskStatus	The current disk status does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con el estado actual del disco. Asegúrese de que el disco esté utilizable y de que no tenga pagos pendientes asociados a él.
403	DiskNotPortable	The specified disk is not a portable disk.	El mensaje de error devuelto porque el disco especificado no es extraíble.
403	InstanceLockedForSecurity	The instance is locked due to security.	El mensaje de error devuelto porque la operación no es compatible mientras la instancia está bloqueada por motivos de seguridad.
403	DependencyViolation	The specified disk has not been attached on the specified instance.	El mensaje de error devuelto porque la operación no es compatible mientras el recurso tiene otras dependencias. Por ejemplo, el disco especificado no está montado en la instancia indicada, o el security group especificado no se puede eliminar mientras contiene instancias. Elimine las dependencias e inténtelo de nuevo.
403	DiskTypeViolation	The specified disk is a system disk and cannot support the operation.	El mensaje de error devuelto porque el disco especificado es el disco del sistema y no se puede desmontar de la instancia a la que está conectado.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con el estado actual del recurso.
403	UserNotInTheWhiteList	The user is not in disk white list.	El mensaje de error devuelto porque no tiene autorización para gestionar el disco. Inténtelo de nuevo cuando cuente con los permisos necesarios.
403	InvalidInstance.ImageCategory	The image category of the specified instance does not support detaching system disk.	El mensaje de error devuelto porque el disco del sistema especificado no se puede desmontar de la instancia indicada debido al estado actual de la imagen de dicha instancia. Causa posible: se eliminó la imagen utilizada para crear la instancia.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	El mensaje de error devuelto porque el atributo DeleteWithInstance no es válido para discos que tienen habilitada la función de montaje múltiple.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	El mensaje de error devuelto porque el parámetro InstanceId especificado no es válido.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El mensaje de error devuelto porque el disco especificado no existe. Compruebe si el ID del disco es correcto.
404	InvalidDisk.AlreadyDetached	The specified disk has been detached.	El mensaje de error devuelto porque el disco especificado ya se desmontó de la instancia.
500	InternalError	The request processing has failed due to some unknown error.	El mensaje de error devuelto porque ocurrió 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.	El mensaje de error devuelto porque 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.