AttachDisk - - Centro de documentación de Alibaba Cloud

Vincula un disco de datos pay-as-you-go o un disco del sistema a una instancia. La instancia y el disco deben residir en la misma zona.

Descripción

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

El disco debe estar en estado Unattached (Available).
Cuando el disco se vincula como disco de datos, considere lo siguiente:
- La instancia debe estar en estado Running (Running) o Stopped (Stopped).
- Si el disco se adquirió por separado, su método de facturación debe ser pay-as-you-go.
- Si el disco es un disco del sistema desvinculado de una instancia, no se aplica ninguna restricción al método de facturación del disco.
Cuando el disco se vincula como disco del sistema, considere lo siguiente:
- La instancia debe ser la instancia original de la que se desvinculó el disco del sistema.
- La instancia debe estar en estado Stopped (Stopped).
- Las credenciales de inicio de sesión deben estar configuradas.
Si al consultar la información de la instancia las respuestas contienen {"OperationLocks": {"LockReason" : "security"}}, la instancia está bloqueada por motivos de seguridad y ninguna operación surtirá efecto 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 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í	AttachDisk	La operación que desea ejecutar. Establezca el valor en AttachDisk.
DiskId	String	Sí	d-bp1j4l5axzdy6ftk****	El ID del disco que se va a vincular. El disco especificado por el parámetro `DiskId` y la instancia especificada por el parámetro `InstanceId` deben residir en la misma zona. Nota Para obtener más información sobre los límites al vincular un disco de datos y un disco del sistema, consulte la sección "Descripción".
InstanceId	String	Sí	i-bp1dq5lozx5f4pmd****	El ID de la instancia a la que se vinculará el disco.
Device	String	No	testDeviceName	El nombre del disco. Nota Este parámetro se eliminará en el futuro. Le recomendamos usar otros parámetros para garantizar la compatibilidad futura.
DeleteWithInstance	Boolean	No	false	Especifica si se debe liberar el disco junto con la instancia. Valores válidos: true: El disco se libera junto con la instancia. false: El disco no se libera junto con la instancia. Se conserva como un disco de datos pay-as-you-go. Valor predeterminado: false. Al especificar este parámetro, tenga en cuenta lo siguiente: Si `OperationLocks` de una instancia contiene `"LockReason" : "security"`, la instancia está bloqueada por motivos de seguridad. Aunque `DeleteWithInstance` de los discos vinculados esté establecido en `false`, el parámetro DeleteWithInstance se ignora y los discos se liberan junto con la instancia. Este parámetro no está disponible para discos con la función multi-attach habilitada.
Bootable	Boolean	No	false	Especifica si se debe vincular el disco como disco del sistema. Valor predeterminado: false. Nota Si el parámetro `Bootable` se establece en true, la instancia debe estar en estado No System Disk.
Password	String	No	EcsV587!	La contraseña establecida al vincular el disco del sistema. La contraseña solo aplica a los usuarios administrador y root. 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. Se pueden usar los siguientes caracteres especiales: ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ En instancias Windows, la contraseña no puede comenzar con una barra diagonal (/). Nota* Si se especifica el parámetro `Password`, le recomendamos enviar solicitudes mediante HTTPS para evitar fugas de contraseñas.
KeyPairName	String	No	KeyPairTestName	El nombre del key pair SSH que se vincula a la instancia Linux al vincular el disco del sistema. Las instancias Windows no admiten inicios de sesión basados en key pairs SSH. El parámetro `Password` surte efecto incluso si se especifica el parámetro KeyPairName. En instancias Linux, el método de inicio de sesión basado en contraseña está deshabilitado de forma predeterminada.

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=AttachDisk
&DiskId=d-bp1j4l5axzdy6ftk****
&InstanceId=i-bp1dq5lozx5f4pmd****
&DeleteWithInstance=false
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

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	InvalidDevice.Malformed	The specified device is not valid.	El mensaje de error devuelto porque el parámetro Device especificado no existe.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	El mensaje de error devuelto porque la operación no es compatible mientras el recurso se encuentra en el estado actual.
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	El mensaje de error devuelto porque no se especificó 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 attach disk.	El mensaje de error devuelto porque la instancia a la que se vincula el disco no admite el intercambio de discos en caliente.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	El mensaje de error devuelto porque la categoría del disco especificado no admite la operación.
400	InvalidOperation.InstanceTypeNotSupport	The specified disk which has kms key should only attach to ioOptimized instance.	El mensaje de error devuelto porque la instancia especificada no es compatible. Las claves de Key Management Service (KMS) solo pueden configurarse en instancias optimizadas para E/S.
400	InvalidParameter.AllEmpty	%s	El mensaje de error devuelto porque no se especificaron los parámetros obligatorios.
403	InstanceDiskLimitExceeded	The amount of the disk on instance in question reach its limits.	El mensaje de error devuelto porque se alcanzó el número máximo de discos que pueden vincularse a la instancia especificada.
403	InvalidDevice.InUse	The specified device has been occupied.	El mensaje de error devuelto porque el dispositivo especificado ya tiene un disco vinculado.
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 el recurso está bloqueado por motivos de seguridad.
403	ResourcesNotInSameZone	The specified instance and disk are not in the same zone.	El mensaje de error devuelto porque la instancia y el disco especificados no están en la misma zona.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	El mensaje de error devuelto porque la instancia subscription ha caducado. Renueve la instancia e inténtelo de nuevo.
403	DiskInArrears	The specified operation is denied as your disk owing fee.	El mensaje de error devuelto porque existen pagos pendientes para el disco.
403	DiskError	IncorrectDiskStatus.	El mensaje de error devuelto porque el estado del disco especificado no es válido.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	El mensaje de error devuelto porque la categoría del dispositivo Elastic Block Storage (EBS) especificado no admite esta operación.
403	DiskId.StatusNotSupported	The specified disk status is not supported.	El mensaje de error devuelto porque esta operación no es compatible mientras el disco se encuentra en el estado actual.
403	IncorrectDiskStatus	The operation is not supported in this status.	El mensaje de error devuelto porque la operación no es compatible mientras el disco se encuentra en el estado actual. Asegúrese de que el disco esté available y de que no existan pagos pendientes.
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 nuevamente cuando cuente con los permisos necesarios.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	El mensaje de error devuelto porque la clave maestra del cliente (CMK) no está habilitada al especificar un ID de clave KMS para un disco. Puede llamar 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.	El mensaje de error devuelto porque Elastic Compute Service (ECS) no tiene autorización para acceder a sus recursos de KMS.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	El mensaje de error devuelto porque el tipo de instancia especificado mediante el parámetro InstanceType no admite la categoría de disco de la instancia. Pruebe con otro tipo de instancia. Para obtener información sobre las categorías de disco admitidas por cada tipo de instancia, consulte la documentación de familias de instancias.
403	InvalidInstanceType.NvmeRequired	The instanceType of the specified instance requires nvme protocol.	El mensaje de error devuelto porque el tipo de la instancia especificada no utiliza el protocolo NVMe.
403	InvalidInstanceType.NvmeUnsupported	The instanceType of the specified instance does not support nvme protocol.	El mensaje de error devuelto porque el tipo de la instancia especificada no admite el protocolo NVMe.
403	InvalidInstanceType.NotSupportMultiAttachDisk	The instanceType of the specified instance does not support multi attach disk.	El mensaje de error devuelto porque los discos con la función multi-attach habilitada no pueden vincularse a instancias del tipo especificado.
403	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.	El mensaje de error devuelto porque se alcanzó el número máximo de instancias a las que puede vincularse el disco especificado.
403	InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk	Multi attach disk can not be attached as system disk.	El mensaje de error devuelto porque los discos con la función multi-attach habilitada no pueden vincularse como discos del sistema.
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 con la función multi-attach habilitada.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	El mensaje de error devuelto porque el parámetro InstanceId especificado no existe. Compruebe que el ID de la instancia sea correcto.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El mensaje de error devuelto porque el disco especificado no existe. Compruebe que el ID del disco sea correcto.
404	InvalidDisk.InUse	The specified disk has been occupied.	El mensaje de error devuelto porque el disco especificado está in use.
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.