ModifyDiskSpec - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Tenez compte des points suivants :

Pour modifier le niveau de performance d'un disque ESSD, observez les règles suivantes :
- Pour un disque ESSD prépayé (abonnement), vous ne pouvez qu'augmenter son niveau de performance.
- Pour un disque ESSD en paiement à l'utilisation, vous pouvez augmenter ou diminuer son niveau de performance. Toutefois, il est impossible de rétrograder le niveau vers PL0.
- Le disque ESSD doit être dans l'état En cours d'utilisation (In_Use) ou Non attaché (Available).
- Si le disque ESSD est attaché à une instance Elastic Compute Service (ECS), celle-ci doit être dans l'état En cours d'exécution (Running) ou Arrêtée (Stopped). L'instance ne doit ni avoir expiré ni être arrêtée pour impayé.
- Si vous ne parvenez pas à augmenter le niveau de performance d'un disque ESSD en raison d'une limite de capacité, redimensionnez le disque en appelant l'opération ResizeDisk, puis réessayez. Pour plus d'informations, consultez la rubrique Disques ESSD.
Pour connaître les limites relatives au changement de catégorie d'un disque, consultez la section « Limites » de la rubrique Changer la catégorie d'un disque.

La nouvelle catégorie de disque ou le nouveau niveau de performance prend effet immédiatement après l'exécution de cette opération. Alibaba Cloud calcule la facturation sur la base de la nouvelle catégorie et du nouveau niveau de performance.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre 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	ModifyDiskSpec	L'opération à effectuer. Définissez la valeur sur ModifyDiskSpec.
DiskId	String	Yes	d-bp131n0q38u3a4zi****	L'ID du disque.
PerformanceLevel	String	No	PL2	Le nouveau niveau de performance du disque ESSD. Valeurs possibles : PL0 : un seul disque ESSD peut fournir jusqu'à 10 000 IOPS en lecture/écriture aléatoire. PL1 : un seul disque ESSD peut fournir jusqu'à 50 000 IOPS en lecture/écriture aléatoire. PL2 : un seul disque ESSD peut fournir jusqu'à 100 000 IOPS en lecture/écriture aléatoire. PL3 : un seul disque ESSD peut fournir jusqu'à 1 000 000 IOPS en lecture/écriture aléatoire. Valeur par défaut : PL1.
DiskCategory	String	No	cloud_essd	La nouvelle catégorie du disque. Valeurs possibles : cloud_essd : disque ESSD cloud_auto : disque ESSD AutoPL cloud_ssd : disque SSD standard cloud_efficiency : disque ultra Ce paramètre est vide par défaut, ce qui indique que la catégorie du disque n'est pas modifiée. Remarque Les valeurs ci-dessus sont listées par ordre décroissant de performance du disque. Les disques prépayés (abonnement) ne peuvent pas être rétrogradés.
DryRun	Boolean	No	false	Indique s'il faut effectuer uniquement une simulation, sans exécuter la requête réelle. Valeurs possibles : true : effectue uniquement une simulation. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment les valeurs de paramètres manquantes, la syntaxe de requête incorrecte, les limites de service et les ressources Elastic Compute Service (ECS) insuffisantes. Si la simulation échoue, un message d'erreur est renvoyé. Si la simulation réussit, le code d'erreur `DryRunOperation` est renvoyé. false : effectue une simulation puis exécute la requête réelle. Si la simulation réussit, un code d'état HTTP 2xx est renvoyé et l'opération est effectuée. Valeur par défaut : false.
ProvisionedIops	Long	No	50000	Les IOPS en lecture/écriture provisionnés du disque ESSD AutoPL. Valeurs possibles : 0 à min{50 000, 1 000 × Capacité - IOPS de base}. IOPS de base = min{1 800 + 50 × Capacité, 50 000}. Remarque Ce paramètre est disponible uniquement si DiskCategory est défini sur cloud_auto. Pour plus d'informations, consultez Disques ESSD AutoPL et Modifier les configurations de performance d'un disque ESSD AutoPL.
PerformanceControlOptions.IOPS	Integer	No	2000	Les nouveaux IOPS du disque. Vous ne pouvez modifier les IOPS que des disques situés dans des clusters de stockage bloc dédiés. Valeurs possibles : 900 jusqu'au nombre maximal d'IOPS par disque (avec un incrément de 100). Pour plus d'informations, consultez Performances du stockage bloc.
PerformanceControlOptions.Throughput	Integer	No	200	Le nouveau débit du disque. Vous ne pouvez modifier le débit que des disques situés dans des clusters de stockage bloc dédiés. Unité : Mo/s. Valeurs possibles : 60 jusqu'au débit maximal par disque. Pour plus d'informations, consultez Performances du stockage bloc.
PerformanceControlOptions.Recover	String	No	All	Indique s'il faut réinitialiser les IOPS et le débit du disque. Ce paramètre n'est valide que lorsque le disque se trouve dans un cluster de stockage bloc dédié. Lorsque vous spécifiez ce paramètre, PerformanceControlOptions.IOPS et PerformanceControlOptions.Throughput ne prennent pas effet. Définissez la valeur sur All, ce qui indique que les IOPS et le débit du disque sont réinitialisés aux valeurs initiales.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	L'ID de la requête.
TaskId	String	t-bp67acfmxazb4p****	L'ID de la tâche de changement de catégorie de disque. Remarque Si vous modifiez uniquement le niveau de performance d'un disque ESSD, ce paramètre n'est pas renvoyé.
OrderId	String	20413515388****	L'ID de la commande. Remarque Ce paramètre est renvoyé uniquement lorsque la catégorie d'un disque prépayé (abonnement) ou le niveau de performance d'un disque ESSD prépayé est modifié.

Exemples

Exemple de requête

http(s)://ecs.aliyuncs.com/?Action=ModifyDiskSpec
&ResourceOwnerId=123
&DiskId=d-bp131n0q38u3a4zi****
&PerformanceLevel=PL2
&DiskCategory=cloud_essd
&DryRun=false
&ProvisionedIops=50000
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<ModifyDiskSpecResponse>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RequestId>5B38289D-88AB-42BD-B021-12FC6942F099</RequestId>
    <OrderId>20413515388****</TaskId>
</ModifyDiskSpecResponse>

JSON format

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

{
  "TaskId" : "t-bp67acfmxazb4p****",
  "RequestId" : "5B38289D-88AB-42BD-B021-12FC6942F099",
  "OrderId" : "20413515388****"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidPerformanceLevel.Malformed	The specified parameter PerformanceLevel is not valid.	Valeur PerformanceLevel non valide.
400	ProvisionedIopsForDiskCategoryUnsupported	The specified disk category does not support provisioned iops.	La catégorie de disque ne prend pas en charge les IOPS provisionnés.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	La capacité des disques appartenant à la catégorie spécifiée dépasse la limite de quota pour la zone. Accédez au Centre de quotas pour afficher et augmenter le quota.
400	MalformedParameter.PerformanceControlOptions	Parameter invalid, %s.	Valeur de paramètre non valide.
400	InvalidPerformanceControlOptions.ModifyOperationUnsupported	The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS.	Les paramètres préfixés par PerformanceControlOptions entrent en conflit avec la catégorie de disque, le niveau de performance ou les IOPS provisionnés du disque.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.	Les commandes de renouvellement et de rétrogradation de configuration n'ont pas pris effet. Cette opération ne peut pas être effectuée avant que les commandes ne prennent effet.
403	DiskInArrears	The specified operation is denied as your disk owing fee.	Un paiement est en retard pour le disque spécifié.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	L'instance a expiré ou présente un impayé. Renouvelez ou effectuez le paiement de l'instance, puis réessayez.
403	IncorrectDiskStatus	The current disk status does not support this operation.	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.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.	Un snapshot est en cours de création pour le disque spécifié.
403	OperationDenied	The type of the disk does not support the operation.	La catégorie de disque spécifiée ne prend pas en charge cette opération.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	Le niveau de performance spécifié et la taille du disque ne correspondent pas.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	Le type d'instance spécifié par 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 disque prises en charge par les types d'instance, consultez la documentation sur les familles d'instances.
403	ModifyingDiskCategoryLimitExceed	The amount of modifying disk category exceeds the limit.	Le nombre maximal de disques dont la configuration est en cours de modification est dépassé dans la région.
403	DiskInCoolingPeriod	There is a cooling period after the disk is successfully modified.	Le disque se trouve dans une période de limitation de changement de configuration et ne peut pas voir sa configuration modifiée pendant cette période.
403	NoChangeInDiskCategoryAndPerformanceLevel	There is no change between the parameters transmitted and the current.	La catégorie de disque et le niveau de performance spécifiés sont identiques à la catégorie et au niveau actuels.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Les ressources demandées ne sont pas disponibles dans la zone spécifiée. Essayez un autre type d'instance ou une autre zone. Vous pouvez appeler l'opération DescribeZones pour interroger les ressources disponibles.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Le disque pour lequel la fonctionnalité de montage multiple est activée ne prend pas en charge l'opération.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	La catégorie de disque spécifiée ne prend pas en charge l'opération.
403	InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster	The specified disk not in dedicated storage cluster, can not modify performance control options.	Les disques qui ne se trouvent pas dans des clusters de stockage bloc dédiés ne prennent pas en charge les paramètres préfixés par PerformanceControlOptions.
403	InvalidStatus.DiskUnderPerformanceControl	The specified disk is under performance control, any modifications to the category or performance level of the specified disk are unsupported..	La catégorie de disque et le niveau de performance ne peuvent pas être modifiés lorsque des paramètres préfixés par PerformanceControlOptions sont spécifiés.
403	InvalidStatus.DiskNotReady	This specified disk is not ready, status needs to be either In_use or Available.	Le disque spécifié doit être dans l'état In_use ou Available.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Le disque spécifié est introuvable. Vérifiez si l'ID du disque est valide.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance est introuvable. Vérifiez si l'ID de l'instance est correct.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite. Réessayez ultérieurement.

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