AttachDisk - Elastic Compute Service - Centre de documentation Alibaba Cloud

Attache un disque de données ou un disque système à une instance ECS.

Description de l'opération

Lorsque vous appelez cette opération, prenez note des éléments suivants :

L'instance et le disque doivent se trouver dans la même zone.
Le disque doit être dans l'état Available (Available).
Lorsque vous attachez un disque de données :
- L'instance ECS de destination doit être dans l'état Running (Running) ou Stopped (Stopped).
- Si le disque est acheté séparément, le mode de facturation doit être à la demande.
- Un disque système qui a été désinstallé d'une instance ECS peut être attaché en tant que disque de données sans restriction de mode de facturation.
- Un disque éphémère élastique qui a été détaché ne peut être rattaché qu'à son instance d'origine.
Lorsque vous attachez un disque système :
- L'instance ECS de destination doit être l'instance d'origine de laquelle le disque système a été détaché.
- L'instance ECS de destination doit être dans l'état Stopped (Stopped).
- Vous devez configurer les identifiants de connexion pour l'instance.
- Les disques éphémères élastiques ne peuvent pas être attachés en tant que disques système.
- Pour plus d'informations sur l'attachement des disques système, consultez Détacher ou attacher un disque système.
Lorsque vous interrogez les informations de l'instance ECS, si la réponse contient {"OperationLocks": {"LockReason" : "security"}}, toutes les opérations sur l'instance sont interdites.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:AttachDisk

update

*Disk.

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

*Instance.

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

ecs:LoginAsNonRoot
ecs:PasswordCustomized

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
InstanceId	string	Oui	L'identifiant de l'instance ECS à laquelle vous souhaitez attacher le disque.	i-bp1dq5lozx5f4pmd****
DiskId	string	Oui	L'identifiant du disque à attacher. Le disque (DiskId) et l'instance (InstanceId) doivent se trouver dans la même zone. Remarque Les disques de données et les disques système peuvent tous deux être attachés. Pour les contraintes associées, consultez la section de description de l'opération ci-dessus.	d-bp1j4l5axzdy6ftk****
Device	string	Non	Le nom de périphérique du disque. Remarque Ce paramètre sera bientôt obsolète. Pour améliorer la compatibilité, utilisez d'autres paramètres pour identifier le disque.	testDeviceName
DeleteWithInstance	boolean	Non	Indique si le disque doit être libéré lorsque l'instance est libérée. Valeurs valides : true : le disque est libéré en même temps que l'instance. false : le disque n'est pas libéré en même temps que l'instance. Le disque est conservé en tant que disque de données à la demande. Valeur par défaut : false. Prenez note des éléments suivants lors de la configuration de ce paramètre : Si vous définissez DeleteWithInstance sur false et que l'instance ECS est verrouillée pour des raisons de sécurité, ce qui signifie que OperationLocks contient "LockReason" : "security", ce paramètre est ignoré lorsque l'instance ECS est libérée, et le disque est libéré en même temps que l'instance. Si le disque que vous souhaitez attacher est un disque éphémère élastique, vous devez définir DeleteWithInstance sur true. Les disques avec la fonctionnalité multi-attachement activée ne prennent pas en charge ce paramètre.	false
Bootable	boolean	Non	Indique si le disque doit être attaché en tant que disque système. Valeurs valides : true : le disque est attaché en tant que disque système. false : le disque n'est pas attaché en tant que disque système. Valeur par défaut : false. Remarque Si vous définissez Bootable=true, l'instance ECS de destination ne doit avoir aucun disque système attaché.	false
Password	string	Non	Le mot de passe défini pour l'instance lorsque vous attachez un disque système. Le mot de passe s'applique uniquement aux noms d'utilisateur administrator et root et ne s'applique pas aux autres noms d'utilisateur. Le mot de passe doit comporter entre 8 et 30 caractères et doit contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Les caractères spéciaux suivants sont pris en charge : ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ Pour les instances Windows, le mot de passe ne peut pas commencer par une barre oblique (/). Remarque* Si vous spécifiez le paramètre Password, envoyez la requête via HTTPS pour éviter les fuites de mot de passe.	EcsV587!
KeyPairName	string	Non	Le nom de la paire de clés SSH liée à l'instance ECS Linux lorsque vous attachez un disque système. Instances Windows Server : les paires de clés SSH ne sont pas prises en charge. Même si ce paramètre est spécifié, seule la configuration Password prend effet. Instances Linux : la méthode de connexion par mot de passe est désactivée par défaut.	KeyPairTestName
Force	boolean	Non	Indique si le disque doit être attaché de force. Valeurs valides : true : attache le disque de force. false : n'attache pas le disque de force. Valeur par défaut : false. Remarque Actuellement, seuls les ESSD régionaux (cloud_regional_disk_auto) prennent en charge la définition de ce paramètre sur true.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidDevice.Malformed	The specified device is not valid.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	L'état actuel de l'instance ne prend pas en charge cette opération.
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	Les paramètres de requête actuels ne sont pas valides. Veuillez réessayer.
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.	L'instance à laquelle le disque est attaché ne prend pas en charge le remplacement à chaud.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category.	Le type de disque actuel ne prend pas en charge cette opération.
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.	Le type de disque spécifié ne prend pas en charge l'opération d'attachement forcé.
400	InvalidParameterForce.PrepaidDiskNotSupported	The prepaid disk does not support force attach operation.	Les disques par abonnement ne prennent pas en charge les opérations d'attachement forcé.
400	InvalidParameterForce.MultiAttachDiskNotSupported	The multi attach disk does not support force attach operation.	Les disques à attachements multiples ne prennent pas en charge les opérations d'attachement forcé.
400	InvalidParameterForce.RegionNotSupported	The specified region does not support force attach operation.	Cette région ne prend pas en charge les opérations d'attachement forcé.
400	OperationConflict.DisksAttachingParallellyExceed	The number of disks attaching parallelly exceeds the limit.	Le nombre de disques attachés en parallèle dépasse la limite.
400	InvalidInstanceType.NotSupported	The specified instanceType is not supported by the image architecture.	Le type d'instance spécifié n'est pas pris en charge.
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.	L'instance à laquelle le disque est attaché est verrouillée pour des raisons de sécurité.
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.	Le type de stockage par blocs spécifié ne prend pas en charge cette opération.
403	DiskId.StatusNotSupported	The specified disk status is not supported.	L'état actuel du disque ne prend pas en charge cette opération.
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.	Le disque actuel ne prend pas en charge cette opération. Assurez-vous que le disque est utilisé normalement et que votre compte ne présente aucun retard de paiement.
403	UserNotInTheWhiteList	The user is not in disk white list.	L'utilisateur ne figure pas dans la liste blanche du stockage par blocs partagé. Soumettez un ticket pour demander l'accès à la liste blanche.
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.	Le type d'instance spécifié (InstanceType) ne prend pas en charge la catégorie de disque de l'instance actuelle. Essayez un autre type d'instance. Pour plus d'informations sur les types de disques pris en charge par chaque type d'instance, consultez la documentation relative aux familles d'instances.
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.	Le type d'instance spécifié requiert le protocole NVMe.
403	InvalidInstanceType.NvmeUnsupported	The instanceType of the specified instance does not support nvme protocol.	Le type d'instance spécifié ne prend pas en charge le protocole NVMe.
403	InvalidInstanceType.NotSupportMultiAttachDisk	The instanceType of the specified instance does not support multi attach disk.	Le type d'instance spécifié ne prend pas en charge l'attachement de disques avec l'attachement multiple activé.
403	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.	Le nombre d'instances auxquelles le disque spécifié est attaché a atteint la limite supérieure.
403	InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk	Multi attach disk can not be attached as system disk.	Les disques avec l'attachement multiple activé ne peuvent pas être utilisés comme disques système.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Le disque spécifié n'est pas un disque amovible et ne peut pas être libéré en même temps que l'instance.
403	InvalidParameter.DeleteWithInstance	The DeleteWithInstance for the elastic ephemeral disk must be set to true.	La propriété DeleteWithInstance d'un disque éphémère élastique doit être définie sur 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.	L'attachement forcé nécessite que l'instance actuelle et l'instance cible se trouvent dans des zones différentes.
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.	Aucun paramètre n'a été spécifié. Spécifiez les paramètres requis.
403	InvalidOperation.DiskQueueNumberNotEnough	The number of disk queues on the instance is not enough.	Le nombre de files d'attente de disques sur l'instance est insuffisant.
403	InvalidOperation.DiskAttachModeUnsupported	The instance type does not support the disk attach mode.	Le type d'instance actuel ne prend pas en charge le mode de rattachement du disque.
403	OperationDenied.HpnZoneMismatch	Instance and disk must be in the same HPN zone for restricted HPN zones.	Pour les régions HPN partiellement restreintes, l'instance et le disque doivent se trouver dans la même région HPN pour effectuer l'opération de rattachement.
403	OperationDenied.UnsupportedEncryptedDisk	The instance type does not support attaching encrypted disks.	Le type d'instance ne prend pas en charge le rattachement de disques chiffrés.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance spécifiée n'existe pas. Vérifiez si l'identifiant de l'instance est correct.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Le disque spécifié n'existe pas. Vérifiez que l'identifiant du disque est correct.
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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.