ModifyDiskAttribute - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Lorsque vous appelez cette opération pour modifier les attributs d'un disque, si vous définissez DeleteWithInstance sur false alors que l'instance à laquelle le disque est attaché est verrouillée pour des raisons de sécurité, le paramètre DeleteWithInstance du disque est ignoré et ce dernier est libéré en même temps que l'instance. Si la réponse renvoyée lors de la requête d'informations sur une instance affiche "LockReason" : "security", cela signifie que l'instance est verrouillée pour des raisons de sécurité.
Utilisez le paramètre DiskIds.N pour spécifier plusieurs périphériques de stockage par bloc afin de modifier leurs attributs simultanément, y compris leur nom, leur description et la configuration de libération conjointe avec les instances associées.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyDiskAttribute	Opération à effectuer. Définissez la valeur sur ModifyDiskAttribute.
DiskId	String	No	d-bp1famypsnar20bv****	ID du disque. Remarque `DiskId` et `DiskIds.N` s'excluent mutuellement. Spécifiez l'un des paramètres en fonction de vos besoins métier.
DiskName	String	No	MyDiskName	Nom du disque. La longueur doit être comprise entre 2 et 128 caractères. Le nom doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Il peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des tirets (-).
Description	String	No	TestDescription	Description du disque. La longueur doit être comprise entre 2 et 256 caractères et ne peut pas commencer par `http://` ou `https://`.
DeleteWithInstance	Boolean	No	false	Indique si le disque doit être libéré en même temps que l'instance associée. Ce paramètre est vide par défaut, ce qui signifie que la valeur actuelle reste inchangée. Une erreur est renvoyée si vous définissez `DeleteWithInstance` sur `false` dans l'un des cas suivants : Le disque est un disque local. Le disque est un disque de base et n'est pas amovible. Si l'attribut Portable d'un disque est défini sur false, le disque n'est pas amovible.
DeleteAutoSnapshot	Boolean	No	false	Indique si les snapshots automatiques du disque doivent être supprimés lors de la libération du disque. Ce paramètre est vide par défaut, ce qui signifie que la valeur actuelle reste inchangée.
EnableAutoSnapshot	Boolean	No	true	Indique si la fonctionnalité de politique de snapshot automatique doit être activée pour le disque cloud. Valeurs possibles : true false Ce paramètre est vide par défaut, ce qui signifie que la valeur actuelle reste inchangée. Remarque Par défaut, la fonctionnalité de politique de snapshot automatique est activée pour les disques cloud. Vous devez uniquement associer une politique de snapshot automatique à un disque cloud avant de pouvoir utiliser la politique.
RegionId	String	Yes	cn-hangzhou	ID de la région du disque. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
DiskIds.N	String	No	d-bp1famypsnar20bv****	ID du disque N. Valeurs possibles pour N : 0 à 100. Remarque `DiskId` et `DiskIds.N` s'excluent mutuellement. Spécifiez l'un des paramètres en fonction de vos besoins métier.
BurstingEnabled	Boolean	No	false	Indique si la fonctionnalité d'explosion des performances (bursting) doit être activée. Valeurs possibles : true false

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=ModifyDiskAttribute
&RegionId=cn-hangzhou
&DiskId=d-bp1famypsnar20bv****
&DiskName=MyDiskName
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	Format DiskName invalide. Le nom doit comporter entre 2 et 128 caractères et peut contenir des lettres, des chiffres, des points (.), des traits de soulignement (_) et des tirets (-). Le nom doit commencer par une lettre et ne peut pas commencer par http:// ou https://.
400	NoAttributeToModify	No attribute to be modified in this request.	Aucun attribut du périphérique de stockage par bloc n'a été modifié.
400	IncompleteParamter	Some fields can not be null in this request.	Certains paramètres requis ne sont pas spécifiés.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.	Valeur RegionId invalide.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	La catégorie de disque ne prend pas en charge la fonctionnalité d'explosion des performances.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Les disques pour lesquels la fonctionnalité de montage multiple est activée ne prennent pas en charge la fonctionnalité d'explosion des performances.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Vous ne pouvez pas modifier la fonctionnalité d'explosion des performances pour un disque dont la configuration est en cours de modification.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Le nombre maximal de snapshots est atteint. Pour stocker de nouveaux snapshots, supprimez ceux dont vous n'avez plus besoin.
403	DiskNotPortable	The specified disk is not a portable disk.	Le disque spécifié n'est pas amovible.
403	IncorrectDiskStatus	The operation is not supported in this status.	Cette opération ne peut pas être effectuée sur le disque dans son état actuel. Assurez-vous que le disque est disponible et qu'aucun paiement n'est en retard pour celui-ci.
403	UserNotInTheWhiteList	The user is not in disk white list.	Vous n'êtes pas autorisé à gérer le disque. Réessayez après avoir obtenu l'autorisation.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Les disques pour lesquels la fonctionnalité de montage multiple est activée ne prennent pas en charge l'attribut DeleteWithInstance.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Ce disque est introuvable. Vérifiez si l'ID du disque est valide.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Format Description invalide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.	L'instance spécifiée est introuvable. Vérifiez si l'ID de l'instance est correct.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.