ModifyRCDiskAttribute - ApsaraDB RDS - Centre de documentation Alibaba Cloud

Modifie les attributs d'un périphérique de stockage par blocs, tels que son nom, sa description, si le disque est libéré avec son instance et si la fonctionnalité de burst est activée.

Description de l'opération

Appelez cette opération pour modifier les attributs d'un périphérique de stockage par blocs, tels que son nom, sa description et s'il est libéré avec son instance.

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.

rds:ModifyRCDiskAttribute

update

*Toutes les ressources.

*

Aucune

Syntaxe de la requête

POST  HTTP/1.1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Appelez l'opération DescribeRegions pour consulter la liste la plus récente des régions.	cn-hangzhou
DiskId	string	Oui	L'identifiant du disque à modifier.	rcd-wz9c8isqly8637zw****
DiskName	string	Non	Le nom du disque. Le nom doit comporter de 2 à 128 caractères et peut contenir des lettres de la catégorie Letter d'Unicode (y compris les caractères anglais et chinois), des chiffres, des deux-points (:), des traits de soulignement (_), des points (.) et des traits d'union (-).	testDisk
Description	string	Non	La description du disque. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.	test
DeleteWithInstance	boolean	Non	Indique si le disque doit être libéré lorsque son instance associée est libérée. Si vous ne spécifiez pas ce paramètre, le paramètre actuel est conservé.\n\nCe paramètre n'est pas pris en charge pour les disques cloud pour lesquels la fonctionnalité d'attachement multiple est activée.\n\nUne erreur se produit si vous définissez DeleteWithInstance sur false dans les cas suivants :\n\nLe disque est un disque éphémère (ephemeral).\nLe disque est un disque cloud (cloud) qui n'est pas détachable (Portable=false).\n Avertissement : Si vous définissez DeleteWithInstance sur false, le paramètre est ignoré sous certaines conditions. Lorsque l'instance ECS attachée fait l'objet d'un verrouillage de sécurité (indiqué par "LockReason" : "security" dans OperationLocks), le disque est libéré avec l'instance, quelle que soit la valeur de DeleteWithInstance.	false
BurstingEnabled	boolean	Non	Indique si la fonctionnalité de burst doit être activée pour les disques qui la prennent en charge. Valeurs valides :\n\ntrue : Active la fonctionnalité.\nfalse : Désactive la fonctionnalité.\n Remarque : Une erreur se produit si vous spécifiez ce paramètre pour un disque qui ne prend pas en charge le burst.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object	Corps de la réponse.
RequestId	string	L'identifiant de la requête.	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

Exemples

JSON format

{
  "RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	Le RegionId spécifié n'est pas valide.
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	Le format du nom du disque est invalide. Le nom doit comporter entre 2 et 128 caractères, commencer par une lettre ou un caractère chinois, et peut contenir des chiffres, des points (.), des traits de soulignement (_) ou des traits d'union (-). Le nom ne peut pas commencer par http:// ou https://.
400	NoAttributeToModify	No attribute to be modified in this request.	Aucun attribut n'a été modifié.
400	IncompleteParamter	Some fields can not be null in this request.	Un paramètre est manquant dans la requête.
400	MissingParameter.DiskIdOrDiskIds	Specified parameter DiskId or DiskIds is missing.	Le paramètre DiskId ou DiskIds est manquant.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	Le type de disque spécifié ne prend pas en charge la fonctionnalité d'accélération des performances.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Les disques multi-attachement ne prennent pas en charge la fonctionnalité d'accélération des performances.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Vous ne pouvez pas modifier la fonctionnalité d'accélération pour un disque en cours de reconfiguration.
400	InvalidBurstingEnabled.DiskSizeTooSmall	The disk size must be greater than 3 GiB to enable burst.	Le burst de performances d'E/S ne peut être activé que lorsque la taille du disque dépasse 3 Gio.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Le quota d'instantanés a été dépassé. Pour stocker de nouveaux instantanés, supprimez les anciens instantanés existants sans affecter votre activité.
403	DiskNotPortable	The specified disk is not a portable disk.	Le disque spécifié n'est pas détachable. Les disques dont le paramètre Portable est défini sur false ne peuvent pas être détachés.
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 dans un état normal et qu'il n'y a aucun paiement en retard.
403	UserNotInTheWhiteList	The user is not in disk white list.	Vous n'êtes pas dans la liste blanche des disques. Ajoutez votre compte à la liste blanche et réessayez.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	L'image spécifiée provient d'Alibaba Cloud Marketplace et ne prend pas en charge la désactivation de la libération avec l'instance.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Le disque spécifié n'existe pas. Vérifiez si l'identifiant du disque est correct.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Le format de description de la ressource spécifié est 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 n'existe pas. Vérifiez si l'identifiant de l'instance est correct.

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

Notes de version

Consultez Notes de version pour la liste complète.