AttachDisk - - Centre de documentation Alibaba Cloud

Description

Lors de l'appel à cette opération, tenez compte des points suivants :

Le disque doit être dans l'état Unattached (Available).
Pour l'attachement d'un disque de données :
- L'instance doit être dans l'état Running (Running) ou Stopped (Stopped).
- Si le disque a été acheté séparément, sa méthode de facturation doit être le paiement à l'utilisation.
- S'il s'agit d'un disque système détaché d'une instance, aucune restriction ne s'applique à sa méthode de facturation.
Pour l'attachement d'un disque système :
- L'instance doit être l'instance d'origine dont le disque système a été détaché.
- L'instance doit être dans l'état Stopped (Stopped).
- Les identifiants de connexion doivent être configurés.
Si la réponse lors de la requête d'informations sur l'instance contient {"OperationLocks": {"LockReason" : "security"}}, l'instance est verrouillée pour des raisons de sécurité et aucune opération ne peut aboutir.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	AttachDisk	Opération à effectuer. Définissez la valeur sur AttachDisk.
DiskId	String	Oui	d-bp1j4l5axzdy6ftk****	ID du disque à attacher. Le disque spécifié par le paramètre `DiskId` et l'instance spécifiée par le paramètre `InstanceId` doivent se trouver dans la même zone. Remarque Pour connaître les limites relatives à l'attachement d'un disque de données et d'un disque système, consultez la section « Description ».
InstanceId	String	Oui	i-bp1dq5lozx5f4pmd****	ID de l'instance à laquelle attacher le disque.
Device	String	Non	testDeviceName	Nom du disque. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser d'autres paramètres pour garantir la compatibilité future.
DeleteWithInstance	Boolean	Non	false	Indique si le disque doit être libéré avec l'instance. Valeurs possibles : true : le disque est libéré avec l'instance. false : le disque n'est pas libéré avec l'instance. Il est conservé en tant que disque de données en paiement à l'utilisation. Valeur par défaut : false. Lorsque vous spécifiez ce paramètre, tenez compte des points suivants : Si `OperationLocks` pour une instance contient `"LockReason" : "security"`, l'instance est verrouillée pour des raisons de sécurité. Même si `DeleteWithInstance` des disques attachés est défini sur `false`, le paramètre DeleteWithInstance est ignoré et les disques sont libérés avec l'instance. Ce paramètre n'est pas disponible pour les disques ayant la fonctionnalité multi-attach activée.
Bootable	Boolean	Non	false	Indique si le disque doit être attaché en tant que disque système. Valeur par défaut : false. Remarque Si le paramètre `Bootable` est défini sur true, l'instance doit être dans l'état No System Disk.
Password	String	Non	EcsV587!	Mot de passe défini lors de l'attachement du disque système. Le mot de passe s'applique uniquement aux utilisateurs administrateur et root. Sa longueur doit être comprise entre 8 et 30 caractères. Il 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 autorisés : ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ Pour les instances Windows, le mot de passe ne peut pas commencer par une barre oblique (/). Remarque* Si le paramètre `Password` est spécifié, nous vous recommandons d'envoyer des requêtes via HTTPS afin d'éviter toute fuite de mot de passe.
KeyPairName	String	Non	KeyPairTestName	Nom de la paire de clés SSH que vous liez à l'instance Linux lors de l'attachement du disque système. Les instances Windows ne prennent pas en charge les connexions basées sur des paires de clés SSH. Le paramètre `Password` prend effet même si le paramètre KeyPairName est spécifié. Pour les instances Linux, la méthode de connexion par mot de passe est désactivée par défaut.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=AttachDisk
&DiskId=d-bp1j4l5axzdy6ftk****
&InstanceId=i-bp1dq5lozx5f4pmd****
&DeleteWithInstance=false
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

Format JSON

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

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidDevice.Malformed	The specified device is not valid.	Message d'erreur indiquant que le paramètre Device spécifié n'existe pas.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Message d'erreur indiquant que l'opération n'est pas prise en charge lorsque la ressource se trouve dans l'état actuel.
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	Message d'erreur indiquant qu'un paramètre obligatoire n'a pas été spécifié.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid	Message d'erreur indiquant que le paramètre RegionId spécifié n'est pas valide.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot attach disk.	Message d'erreur indiquant que l'instance à laquelle le disque est attaché ne prend pas en charge le remplacement à chaud des disques.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	Message d'erreur indiquant que la catégorie de disque spécifiée ne prend pas en charge l'opération.
400	InvalidOperation.InstanceTypeNotSupport	The specified disk which has kms key should only attach to ioOptimized instance.	Message d'erreur indiquant que l'instance spécifiée n'est pas prise en charge. Vous pouvez définir des clés Key Management Service (KMS) uniquement pour les instances optimisées pour les E/S.
400	InvalidParameter.AllEmpty	%s	Message d'erreur indiquant que les paramètres requis n'ont pas été spécifiés.
403	InstanceDiskLimitExceeded	The amount of the disk on instance in question reach its limits.	Message d'erreur indiquant que le nombre maximal de disques pouvant être attachés à l'instance spécifiée a été atteint.
403	InvalidDevice.InUse	The specified device has been occupied.	Message d'erreur indiquant qu'un disque est déjà attaché au périphérique spécifié.
403	DiskNotPortable	The specified disk is not a portable disk.	Message d'erreur indiquant que le disque spécifié n'est pas amovible.
403	InstanceLockedForSecurity	The instance is locked due to security.	Message d'erreur indiquant que l'opération n'est pas prise en charge lorsque la ressource est verrouillée pour des raisons de sécurité.
403	ResourcesNotInSameZone	The specified instance and disk are not in the same zone.	Message d'erreur indiquant que l'instance et le disque spécifiés ne se trouvent pas dans la même zone.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Message d'erreur indiquant que l'instance par abonnement a expiré. Renouvelez l'instance et réessayez.
403	DiskInArrears	The specified operation is denied as your disk owing fee.	Message d'erreur indiquant que vous avez des impayés pour le disque.
403	DiskError	IncorrectDiskStatus.	Message d'erreur indiquant que l'état du disque spécifié n'est pas valide.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	Message d'erreur indiquant que la catégorie du périphérique Elastic Block Storage (EBS) spécifié ne prend pas en charge cette opération.
403	DiskId.StatusNotSupported	The specified disk status is not supported.	Message d'erreur indiquant que cette opération n'est pas prise en charge lorsque le disque se trouve dans l'état actuel.
403	IncorrectDiskStatus	The operation is not supported in this status.	Message d'erreur indiquant que l'opération n'est pas prise en charge lorsque le disque se trouve dans l'état actuel. Assurez-vous que le disque est disponible et que vous n'avez aucun impayé le concernant.
403	UserNotInTheWhiteList	The user is not in disk white list.	Message d'erreur indiquant que vous n'êtes pas autorisé à gérer le disque. Réessayez une fois que vous y serez autorisé.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Message d'erreur indiquant que la clé maître cliente (CMK) n'est pas activée lorsqu'un ID de clé KMS est spécifié pour un disque. Vous pouvez appeler l'opération DescribeKey de KMS pour interroger les informations relatives à la CMK spécifiée.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Message d'erreur indiquant qu'Elastic Compute Service (ECS) n'est pas autorisé à accéder à vos ressources KMS.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	Message d'erreur indiquant que le type d'instance spécifié par le paramètre InstanceType ne prend pas en charge la catégorie de disque de l'instance. Essayez un autre type d'instance. Pour obtenir des informations sur les catégories de disques prises en charge par les types d'instance, consultez la documentation sur les familles d'instances.
403	InvalidInstanceType.NvmeRequired	The instanceType of the specified instance requires nvme protocol.	Message d'erreur indiquant que le type d'instance de l'instance spécifiée n'utilise pas le protocole NVMe.
403	InvalidInstanceType.NvmeUnsupported	The instanceType of the specified instance does not support nvme protocol.	Message d'erreur indiquant que le type d'instance de l'instance spécifiée ne prend pas en charge le protocole NVMe.
403	InvalidInstanceType.NotSupportMultiAttachDisk	The instanceType of the specified instance does not support multi attach disk.	Message d'erreur indiquant que les disques pour lesquels la fonctionnalité multi-attach est activée ne peuvent pas être attachés aux instances du type d'instance spécifié.
403	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.	Message d'erreur indiquant que le nombre maximal d'instances auxquelles le disque spécifié peut être attaché a été atteint.
403	InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk	Multi attach disk can not be attached as system disk.	Message d'erreur indiquant que les disques pour lesquels la fonctionnalité multi-attach est activée ne peuvent pas être attachés en tant que disques système.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Message d'erreur indiquant que l'attribut DeleteWithInstance n'est pas valide pour les disques ayant la fonctionnalité multi-attach activée.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Message d'erreur indiquant que le paramètre InstanceId spécifié n'existe pas. Vérifiez que l'ID de l'instance est correct.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Message d'erreur indiquant que le disque spécifié n'existe pas. Vérifiez que l'ID du disque est correct.
404	InvalidDisk.InUse	The specified disk has been occupied.	Message d'erreur indiquant que le disque spécifié est en cours d'utilisation.
500	InternalError	The request processing has failed due to some unknown error.	Message d'erreur indiquant qu'une erreur interne s'est produite. Réessayez ultérieurement.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Message d'erreur indiquant qu'une erreur interne s'est produite. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.