ModifyDiskSpec - Elastic Compute Service - Centre de documentation Alibaba Cloud

Modifie la catégorie d'un disque cloud ou le niveau de performance d'un disque SSD d'entreprise (ESSD). Vous ne pouvez pas modifier les catégories des disques ESSD régionaux, des disques de base, des disques éphémères élastiques et des disques locaux.

Description de l'opération

Pour minimiser l'impact sur votre activité, modifiez les catégories de disques ou les niveaux de performance des disques cloud pendant les heures creuses.

Prenez note des éléments suivants :

Pour modifier le niveau de performance d'un disque ESSD, prenez note des éléments suivants :
- Si le disque ESSD est un disque ESSD par abonnement, vous pouvez uniquement augmenter son niveau de performance.
- Si le disque ESSD est un disque ESSD à la demande, vous pouvez augmenter ou diminuer son niveau de performance. Cependant, vous ne pouvez pas réduire le niveau de performance à 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), l'instance doit être dans l'état En cours d'exécution (Running) ou Arrêtée (Stopped). L'instance ne peut pas être dans l'état Expiré ou arrêtée en raison d'un paiement en retard.
- Si vous ne pouvez pas augmenter le niveau de performance d'un disque ESSD en raison de la limite de capacité, étendez le disque ESSD en appelant l'opération ResizeDisk, puis réessayez. Pour plus d'informations, consultez la section Disques ESSD.
Pour plus d'informations sur les limites relatives à la modification de la catégorie d'un disque cloud, consultez la section Modifier la catégorie d'un disque.
Pour connaître les catégories de disques vers lesquelles les disques cloud de chaque catégorie peuvent être modifiés, consultez la section Modifier la catégorie d'un disque.

Une fois la catégorie du disque cloud modifiée, la facturation du disque cloud subit les modifications suivantes :

Si le disque cloud est un disque à la demande, il est facturé en fonction de la nouvelle catégorie de disque.
Si le disque cloud est un disque par abonnement, des frais supplémentaires peuvent vous être facturés en fonction de la différence de prix entre l'ancienne et la nouvelle catégorie de disque et du nombre de jours restants dans le cycle de facturation, à partir de 00h00 le lendemain jusqu'à la fin de la période d'abonnement.

Pour plus d'informations sur la facturation des disques cloud, consultez la section Périphériques de stockage par blocs.

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:ModifyDiskSpec

update

*Disk

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
DiskId	string	Oui	L'identifiant du disque.	d-bp131n0q38u3a4zi****
PerformanceLevel	string	Non	Le nouveau niveau de performance du disque ESSD. Valeurs valides : PL0 : un disque ESSD peut fournir jusqu'à 10 000 IOPS en lecture/écriture aléatoire. PL1 : un disque ESSD peut fournir jusqu'à 50 000 IOPS en lecture/écriture aléatoire. PL2 : un disque ESSD peut fournir jusqu'à 100 000 IOPS en lecture/écriture aléatoire. PL3 : un disque ESSD fournit jusqu'à 1 000 000 d'IOPS en lecture/écriture aléatoire. Valeur par défaut : PL1.	PL2
DiskCategory	string	Non	La nouvelle catégorie du disque cloud. Valeurs valides : cloud_essd : ESSD cloud_auto : disque ESSD AutoPL cloud_ssd : 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 précédentes sont répertoriées par ordre décroissant de performance du disque. Les disques par abonnement ne peuvent pas être rétrogradés.	cloud_essd
DryRun	boolean	Non	Indique si un test à blanc uniquement doit être effectué, sans exécuter la requête réelle. Valeurs valides : true : effectue uniquement un test à blanc. Le système vérifie si la requête présente des problèmes potentiels, notamment des valeurs de paramètre manquantes, une syntaxe de requête incorrecte, des limites de service et des ressources ECS insuffisantes. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur DryRunOperation est renvoyé. false : effectue un test à blanc et exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est exécutée. Valeur par défaut : false.	false
ProvisionedIops	integer	Non	Les IOPS en lecture/écriture provisionnés du disque ESSD AutoPL. Valeurs valides : 0 à min{50 000, 1 000 × Capacité - IOPS de base}. IOPS de base = min{1 800 + 50 × Capacité, 50 000}. Remarque Ce paramètre n'est disponible que si vous définissez DiskCategory sur cloud_auto. Pour plus d'informations, consultez les sections Disques ESSD AutoPL et Modifier les configurations de performance d'un disque ESSD AutoPL.	50000
PerformanceControlOptions	object	Non	Les spécifications de performance du disque.
IOPS	integer	Non	Le nouveau taux d'IOPS du disque cloud. Vous ne pouvez modifier le taux d'IOPS que des disques cloud dans les clusters de stockage par blocs dédiés. Valeurs valides : 900 au maximum d'IOPS par disque (avec un incrément de 100). Pour plus d'informations, consultez la section Performances du stockage par blocs.	2000
Throughput	integer	Non	Le nouveau débit du disque cloud. Vous ne pouvez modifier le débit que des disques cloud dans les clusters de stockage par blocs dédiés. Unité : Mo/s. Valeurs valides : 60 au débit maximum par disque. Pour plus d'informations, consultez la section Performances du stockage par blocs.	200
Recover	string	Non	Indique si le taux d'IOPS et le débit du disque cloud doivent être réinitialisés. Ce paramètre ne prend effet que lorsque le disque cloud appartient à un cluster de stockage par blocs dédié. Une fois ce paramètre spécifié, PerformanceControlOptions.IOPS et PerformanceControlOptions.Throughput ne prennent pas effet. Définissez la valeur sur All, ce qui indique que le taux d'IOPS et le débit du disque cloud sont réinitialisés à leurs valeurs initiales.	All
DestinationZoneId	string	Non	Remarque Ce paramètre est en avant-première sur invitation et n'est pas disponible publiquement.	cn-hangzhou-g

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TaskId	string	L'identifiant de la tâche de modification de la catégorie du disque. Remarque Si vous modifiez uniquement le niveau de performance d'un disque ESSD, ce paramètre n'est pas renvoyé.	t-bp67acfmxazb4p****
OrderId	string	L'identifiant de la commande. Remarque Ce paramètre n'est renvoyé que lorsque la catégorie d'un disque par abonnement ou le niveau de performance d'un disque ESSD par abonnement est modifié.	20413515388****

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TaskId": "t-bp67acfmxazb4p****",
  "OrderId": "20413515388****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidPerformanceLevel.Malformed	The specified parameter PerformanceLevel is not valid.	The specified PerformanceLevel parameter is invalid.
400	InvalidDiskCategory.ValueNotSupported	The specified parameter "DiskCategory" is not valid.	The specified cloud disk type DiskCategory is invalid.
400	InvalidPerformanceLevelParam.Mismatch	The specified parameter PerformanceLevel should be null when DiskCategory is not cloud_essd.
400	OperationDenied.DiskInDedicatedBlockStorageCluster	The disk in dedicated block storage cluster is not allowed to do this operation.
400	IncorrectDiskStatus.ReplicationStatusNotFound	Disk replication status not found.
400	IncorrectDiskStatus.InReplication	Disk already in replication.
400	ProvisionedIopsForDiskCategoryUnsupported	The specified disk category does not support provisioned iops.	The specified disk type does not support provisioned IOPS.
400	InvalidProvisionedIops.LimitExceed	The provisioned iops exceeds the limit.	The filled ProvisionedIops parameter exceeds the limit.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	The capacity of disks that belong to the specified disk category exceeds the quota limit for the zone.
400	MalformedParameter.PerformanceControlOptions	Parameter invalid, %s.	The parameter is invalid.
400	InvalidPerformanceControlOptions.ModifyOperationUnsupported	The specified performance control options are conflicts with disk category or performance level or ProvisionIOPS.	The disk performance control parameters conflict with the disk type, disk performance level, or provisioned IOPS parameter.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account or set the parameter AutoPay to true.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	This account does not have permission to operate refund, and the main account needs to authorize refund-related permissions.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.	There are renewal downgrade orders that have not yet taken effect. This operation is not allowed before the order takes effect.
400	InvalidOperation.InstanceStatusUnsupported	The specified instance status is not supported for this operation. The expected status is Running or Stopped.
400	MissingParameter.DestinationZoneId	The parameter DestinationZoneId must be specified when modifying the disk specification from a regional disk to a zone disk.	The parameter DestinationZoneId must be specified when modifying the disk specification from a regional disk to a zone disk.
400	InvalidDestinationZoneId.Mismatch	The specified DestinationZoneId of the regional disk with 'In-use' status should remain consistent with the ZoneId of instance.	The specified DestinationZoneId of the regional disk with 'In-use' status should remain consistent with the ZoneId of instance.
400	InvalidOperation.MultiAttachRegionalDiskUnsupported	The multi-attach regional disk with 'In-use' status attached to more than one instance is not allowed to modify disk spec.	The multi-attach regional disk with 'In-use' status attached to more than one instance is not allowed to modify disk spec.
400	InvalidDestinationZoneId.DiskCategoryUnsupported	The specified disk category does not allow the DestinationZoneId parameter for this operation.	The disk type of this disk does not support specifying DestinationZoneId during a specification change.
400	IncorrectInstanceStatus	The current status of the instance does not support this operation.	The instance is in a state that does not support the current 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	DiskInArrears	The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	OperationDenied	The type of the disk does not support the operation.	The disk category does not support the specified operation.
403	InvalidPerformanceLevel.TooLow	Specified new performance level is lower than the original performance level.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	The specified performance level and disk size do not match.
403	UserNotInTheWhiteList	The user is not in modify disk category white list.
403	InvalidRegion.NotSupport	The specified region does not support modify disk category.
403	InvalidDiskCategory.ValueNotSupported	The current disk category of the resource does not support this operation.	The disk type on the specified resource does not support this operation.
403	Downgrade.NotSupported	Downgrade operation for prepay resource is not supported.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	The instance type does not support the current disk category. Try another instance type. For information about the disk categories supported by instance types, see the instance family documentation.
403	ModifyingDiskCategoryLimitExceed	The amount of modifying disk category exceeds the limit.	The number of disks being modified in the current region has exceeded the upper limit.
403	DiskInCoolingPeriod	There is a cooling period after the disk is successfully modified.	The disk is within a specification change cooldown period and cannot be changed again.
403	DiskHasFlashSnapshot	The specified disk with flash snapshots do not support modify disk category.
403	NoChangeInDiskCategoryAndPerformanceLevel	There is no change between the parameters transmitted and the current.	The disk category and performance level you specified are the same as the current disk.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	The requested resources are insufficient.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Disks for which the multi-attach feature is enabled do not support the operation.
403	OperationDenied.DiskExpansionUnfinished	The instance has not been restarted after a previous disk expansion.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.	The specified disk category does not support this operation.
403	InvalidPerformanceParameter.DiskNotInDedicatedStorageCluster	The specified disk is not in a dedicated storage cluster. Performance control options cannot be modified.
403	InvalidStatus.DiskUnderPerformanceControl	The specified disk is under performance control. Any modifications to the category or performance level of the specified disk are unsupported.
403	InvalidStatus.DiskNotReady	The specified disk is not ready. The status must be either In_use or Available.
403	InvalidOperation.DiskInReplicaPairsUnsupported	The disk in replication pairs does not support this operation.	The disk in replication pairs does not support this operation.
403	InvalidDisk.DetachedSystemDisk	The specified resource is/has a detached system disk %s , not support current operation.	The specified disk is a detached system disk and does not support this operation.
403	InvalidDiskCategory.InstanceTypeUnsupported	The current instance type does not support the specified disk category. Please check the list of disk category supported by the instance type and select an appropriate disk category for configuration.	The current instance type does not support the specified disk class. Check the list of disk types supported by the instance type and select the appropriate disk category to configure.
403	InvalidOperation.CMKNotEnabled	The CMK (Customer Master Key) must be in an active state.	The master key must be enabled.
403	InvalidOperation.CMKUnauthorized	The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.	The master key needs to authorize the ECS service to add tags.
403	InstanceLockedForSecurity	The instance is locked for security reasons. Please contact Security Technical Support for assistance.	The instance is locked for security reasons. You can contact the security technical support.
404	InvalidDiskId.NotFound	The specified disk does not exist.	The specified disk does not exist. Check whether the disk ID is correct.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	The specified instanceId is invalid.
404	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
404	InvalidDiskCategory.ValueUnauthorized	The specified DiskCategory is not authorized.
404	OperationDenied	The specified InstanceType or Zone is not available or not authorized.

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

Notes de version

Consultez Notes de version pour la liste complète.