AttachDisk - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Adjunta un disco de datos o un disco del sistema a una instancia de ECS.

Descripción de la operación

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

La instancia y el disco deben estar en la misma zona.
El disco debe estar en el estado Available (Available).
Al adjuntar un disco de datos:
- La instancia de ECS de destino debe estar en el estado Running (Running) o Stopped (Stopped).
- Si el disco se compró por separado, el método de facturación debe ser de pago por uso.
- Un disco del sistema que se desmontó de una instancia de ECS se puede adjuntar como disco de datos sin restricciones de método de facturación.
- Un disco efímero elástico que se ha separado solo se puede volver a adjuntar a su instancia original.
Al adjuntar un disco del sistema:
- La instancia de ECS de destino debe ser la instancia original de la que se separó el disco del sistema.
- La instancia de ECS de destino debe estar en el estado Stopped (Stopped).
- Debe configurar las credenciales de inicio de sesión para la instancia.
- Los discos efímeros elásticos no se pueden adjuntar como discos del sistema.
- Para obtener más información sobre cómo adjuntar discos del sistema, consulte Desconectar o conectar un disco del sistema.
Al consultar la información de la instancia de ECS, si la respuesta contiene {"OperationLocks": {"LockReason" : "security"}}, todas las operaciones en la instancia están prohibidas.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:AttachDisk

update

*Disk.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

ecs:LoginAsNonRoot
ecs:PasswordCustomized

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia de ECS a la que desea adjuntar el disco.	i-bp1dq5lozx5f4pmd****
DiskId	string	Sí	El ID del disco que se va a adjuntar. El disco (`DiskId`) y la instancia (`InstanceId`) deben estar en la misma zona. Nota Se pueden adjuntar tanto discos de datos como discos del sistema. Para conocer las restricciones relacionadas, consulte la sección de descripción de la operación anterior.	d-bp1j4l5axzdy6ftk****
Device	string	No	El nombre del dispositivo del disco. Nota Este parámetro quedará obsoleto pronto. Para mejorar la compatibilidad, utilice otros parámetros para identificar el disco.	testDeviceName
DeleteWithInstance	boolean	No	Especifica si se debe liberar el disco cuando se libera la instancia. Valores válidos: true: El disco se libera junto con la instancia. false: El disco no se libera junto con la instancia. El disco se conserva como un disco de datos de pago por uso. Valor predeterminado: false. Tenga en cuenta los siguientes puntos al configurar este parámetro: Si establece `DeleteWithInstance` en `false` y la instancia de ECS está bloqueada por motivos de seguridad, lo que significa que `OperationLocks` contiene `"LockReason" : "security"`, este parámetro se ignora cuando se libera la instancia de ECS y el disco se libera junto con la instancia. Si el disco que desea adjuntar es un disco efímero elástico, debe establecer `DeleteWithInstance` en `true`. Los discos con la función multi-attach habilitada no admiten este parámetro.	false
Bootable	boolean	No	Especifica si se debe adjuntar el disco como disco del sistema. Valores válidos: true: El disco se adjunta como disco del sistema. false: El disco no se adjunta como disco del sistema. Valor predeterminado: false. Nota Si establece `Bootable=true`, la instancia de ECS de destino no debe tener ningún disco del sistema adjuntado.	false
Password	string	No	La contraseña que se establece para la instancia al adjuntar un disco del sistema. La contraseña solo es aplicable a los nombres de usuario administrator y root, y no se aplica a otros nombres de usuario. La contraseña debe tener entre 8 y 30 caracteres de longitud y debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Se admiten los siguientes caracteres especiales: ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ Para las instancias de Windows, la contraseña no puede comenzar con una barra diagonal (/). Nota* Si especifica el parámetro `Password`, envíe la solicitud a través de HTTPS para evitar filtraciones de la contraseña.	EcsV587!
KeyPairName	string	No	El nombre del par de claves SSH que se vincula a la instancia de ECS Linux al adjuntar un disco del sistema. Instancias de Windows Server: No se admiten los pares de claves SSH. Incluso si se especifica este parámetro, solo surte efecto la configuración de `Password`. Instancias de Linux: El método de inicio de sesión basado en contraseña está deshabilitado de forma predeterminada.	KeyPairTestName
Force	boolean	No	Especifica si se debe adjuntar el disco de forma forzada. Valores válidos: true: Adjunta el disco de forma forzada. false: No adjunta el disco de forma forzada. Valor predeterminado: false. Nota Actualmente, solo los ESSD regionales (cloud_regional_disk_auto) admiten establecer este parámetro en true.	false

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "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.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	El estado actual de la instancia no admite esta operación.
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	Los parámetros de la solicitud actual no son válidos. Inténtelo de nuevo.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot attach disk.	La instancia a la que está conectado el disco no admite el intercambio en caliente.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category.	El tipo de disco actual no admite esta operación.
400	InvalidDisk.DiskNotBootable	The specified disk is not a bootable disk. It cannot be attached as a system disk.
400	InvalidInstance.NotOriginInstance	The specified disk can not attached to other instance as system disk.
400	InvalidParameterForce.DiskCategoryNotSupported	The specified disk category does not support force attach operation.	El tipo de disco especificado no admite la operación de conexión forzada.
400	InvalidParameterForce.PrepaidDiskNotSupported	The prepaid disk does not support force attach operation.	Los discos de suscripción no admiten operaciones de conexión forzada.
400	InvalidParameterForce.MultiAttachDiskNotSupported	The multi attach disk does not support force attach operation.	Los discos de conexión múltiple no admiten operaciones de conexión forzada.
400	InvalidParameterForce.RegionNotSupported	The specified region does not support force attach operation.	La región especificada no admite operaciones de conexión forzada.
400	OperationConflict.DisksAttachingParallellyExceed	The number of disks attaching parallelly exceeds the limit.	El número de discos conectados en paralelo supera el límite.
400	InvalidInstanceType.NotSupported	The specified instanceType is not supported by the image architecture.	El InstanceType especificado no es compatible.
400	InvalidOperation.EncryptedDiskUnsupported	The specified encrypted disk is not supported for this operation.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403	InstanceDiskLimitExceeded	The number of disks attached to the instance has exceeded the limit.
403	InvalidDevice.InUse	The specified device has been occupied.
403	DiskNotPortable	The specified disk is not a portable disk.
403	InstanceLockedForSecurity	The instance is locked due to security.	La instancia a la que está conectado el disco está bloqueada por motivos de seguridad.
403	ResourcesNotInSameZone	The specified instance and disk are not in the same zone.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	DiskInArrears	The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403	DiskError	IncorrectDiskStatus.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	El tipo de almacenamiento de bloques especificado no admite esta operación.
403	DiskId.StatusNotSupported	The specified disk status is not supported.	El estado actual del disco no admite esta operación.
403	IncorrectInstanceStatus.NotSupportESSD	The operation is not supported in this status. Please reboot the instance.
403	IncorrectDiskStatus	The operation is not supported in this status.	El disco actual no admite esta operación. Asegúrese de que el disco esté en uso normal y de que no haya pagos vencidos.
403	UserNotInTheWhiteList	The user is not in disk white list.	El usuario no se encuentra en la lista blanca de Shared Block Storage. Envíe un ticket para solicitar el acceso a la lista blanca.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	DependencyViolation.WindowsInstance	The instance image is Windows. SSH key pair login is not supported.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	El tipo de instancia especificado (InstanceType) no admite la categoría de disco de la instancia actual. Pruebe con un tipo de instancia diferente. Para obtener información sobre los tipos de disco que admite cada tipo de instancia, consulte la documentación de familias de instancias.
403	InvalidInstanceType.NotSupportPL0	The instanceType of the specified instance does not support PL0 of cloud_essd.
403	InvalidInstanceType.NvmeRequired	The instanceType of the specified instance requires nvme protocol.	El tipo de instancia especificado requiere el protocolo NVMe.
403	InvalidInstanceType.NvmeUnsupported	The instanceType of the specified instance does not support nvme protocol.	El tipo de instancia especificado no admite el protocolo NVMe.
403	InvalidInstanceType.NotSupportMultiAttachDisk	The instanceType of the specified instance does not support multi attach disk.	El tipo de instancia especificado no admite la conexión de discos con la conexión múltiple habilitada.
403	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.	El número de instancias a las que está conectado el disco especificado ha alcanzado el límite superior.
403	InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk	Multi attach disk can not be attached as system disk.	Los discos con la conexión múltiple habilitada no se pueden utilizar como discos del sistema.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	El disco especificado no es un disco extraíble y no admite su liberación junto con la instancia.
403	InvalidParameter.DeleteWithInstance	The DeleteWithInstance for the elastic ephemeral disk must be set to true.	La propiedad DeleteWithInstance de un disco efímero elástico debe establecerse en true.
403	InvalidOperation.OtherInstanceUnsupported	The elastic ephemeral disk can only be attached to the instance it was last mounted on. Please check the disk system tag to get the last associated instance.
403	InvalidInstance.ZoneConflict	The force attach operation is not supported when both the current and target instances are in the same zone.	La conexión forzada requiere que la instancia actual y la instancia de destino se encuentren en zonas diferentes.
403	InvalidParameter.AllEmpty	The current operation requires either a password or a keyPairName to must be provided. Please ensure that at least one of them is not empty.	No se especificaron parámetros. Especifique los parámetros requeridos.
403	InvalidOperation.DiskQueueNumberNotEnough	The number of disk queues on the instance is not enough.	El número de colas de disco en la instancia es insuficiente.
403	InvalidOperation.DiskAttachModeUnsupported	The instance type does not support the disk attach mode.	El tipo de instancia actual no admite el modo de conexión del disco.
403	OperationDenied.HpnZoneMismatch	Instance and disk must be in the same HPN zone for restricted HPN zones.	Para las regiones HPN parcialmente restringidas, la instancia y el disco deben estar en la misma región HPN para la operación de conexión.
403	OperationDenied.UnsupportedEncryptedDisk	The instance type does not support attaching encrypted disks.	El tipo de instancia no admite la conexión de discos cifrados.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	La instancia especificada no existe. Verifique si el ID de la instancia es correcto.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El disco especificado no existe. Verifique si el ID del disco es correcto.
404	InvalidDisk.InUse	The specified disk has been occupied.
404	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.
404	InvalidKMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.