Tous les produits
Search
Centre de documentation

:ResizeDisk

Dernière mise à jour :Aug 18, 2026

Redimensionne un disque système ou un disque de données.

Notes d'utilisation

Remarque

Avant d'appeler cette opération pour redimensionner un disque, vous devez vérifier le format de partition du disque. Un disque utilisant une table de partition MBR (Master Boot Record) ne peut pas être redimensionné au-delà de 2 TiB. Si vous redimensionnez un disque MBR à une taille supérieure à 2 TiB, vous risquez de perdre des données. Pour augmenter la capacité d'un disque MBR au-delà de 2 TiB, nous vous recommandons de suivre la procédure suivante : créez un autre disque de données d'une taille supérieure à 2 TiB, partitionnez et formatez ce nouveau disque en GPT (GUID Partition Table), puis copiez les données du disque MBR vers le nouveau disque GPT. Pour plus d'informations, consultez

Redimensionnement hors ligne des disques

.

  • Vous pouvez redimensionner les catégories de disques suivantes : disques basiques (cloud), disques ultra (cloud_efficiency), SSD standard (cloud_ssd), ESSD (cloud_essd)

    , disques ESSD Entry (cloud_essd_entry)

    et disques ESSD AutoPL (cloud_auto).

  • Le redimensionnement d'un disque est impossible pendant la création d'un snapshot pour ce disque.

  • L'instance à laquelle le disque est attaché doit être dans l'état Running (Running) ou Stopped (Stopped).

  • Après le redimensionnement d'un disque, ses partitions et systèmes de fichiers restent inchangés. Vous devez allouer manuellement l'espace de stockage sur le disque après son redimensionnement.

  • Les disques pour lesquels la fonctionnalité multi-attach est activée supportent le redimensionnement en ligne et hors ligne. Avant de redimensionner ces disques, assurez-vous que les instances auxquelles ils sont attachés sont dans l'état Stopped (Stopped).

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 ResizeDisk

L'opération que vous souhaitez effectuer. Définissez la valeur sur ResizeDisk.

DiskId String Yes d-bp67acfmxazb4p****

L'ID du disque. Vous pouvez appeler l'opération DescribeDisks pour interroger les ID de disque disponibles.

Type String No offline

La méthode que vous souhaitez utiliser pour redimensionner le disque. Valeurs valides :

  • offline (par défaut) : redimensionne le disque hors ligne. Après avoir redimensionné un disque hors ligne, vous devez redémarrer l'instance associée via la console Elastic Compute Service (ECS) ou en appelant l'opération RebootInstance pour que le redimensionnement prenne effet. Pour savoir comment redémarrer une instance ECS dans la console ECS, consultez Redémarrer une instance.
  • online : redimensionne le disque en ligne. Après le redimensionnement en ligne d'un disque, l'opération prend effet immédiatement et vous n'avez pas besoin de redémarrer l'instance. Vous pouvez redimensionner en ligne les disques ultra, les SSD standard et les ESSD.
NewSize Integer Yes 1900

La nouvelle capacité du disque. Unité : GiB. Valeurs valides :

  • Pour un disque système :
    • Disque basique (cloud) : 20 à 500.
    • Autres catégories de disques : 20 à 2048.
  • Pour un disque de données :
    • Disque ultra (cloud_efficiency) : 20 à 32768.
    • SSD standard (cloud_ssd) : 20 à 32768.
    • ESSD (cloud_essd) : Les valeurs valides dépendent de la valeur PerformanceLevel. Vous pouvez appeler l'opération DescribeDisks pour interroger les informations sur le disque et vérifier la valeur PerformanceLevel dans la réponse.
      • Valeurs valides lorsque PerformanceLevel est défini sur PL0 : 40 à 32768.
      • Valeurs valides lorsque PerformanceLevel est défini sur PL1 : 20 à 32768.
      • Valeurs valides lorsque PerformanceLevel est défini sur PL2 : 461 à 32768.
      • Valeurs valides lorsque PerformanceLevel est défini sur PL3 : 1261 à 32768.
    • Disque basique (cloud) : 5 à 2000.
    • Disque ESSD AutoPL (cloud_auto) : 40 à 32768.

La nouvelle capacité du disque doit être supérieure à la capacité d'origine du disque.

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer qu'il est unique pour différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

Paramètres de réponse

Parameter

Type

Example

Description

OrderId String 20413515388****

L'ID de la commande.

Remarque Ce paramètre est renvoyé uniquement lors du redimensionnement d'un disque par abonnement.
RequestId String F3CD6886-D8D0-4FEE-B93E-1B732396****

L'ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=ResizeDisk
&DiskId=d-bp67acfmxazb4p****
&NewSize=1900
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ResizeDiskResponse>
    <OrderId>20413515388****</OrderId>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B732396****</RequestId>
</ResizeDiskResponse>

JSON format

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

{
  "OrderId" : "20413515388****",
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

400

InvalidDataDiskSize.ValueNotSupported

The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category.

Le paramètre DataDisk.N.Size n'est pas valide, ou la taille du snapshot dépasse la capacité maximale autorisée pour la catégorie de disque spécifiée.

400

InvalidDataDiskCategory.ValueNotSupported

%s

Valeur DataDiskCategory non valide. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.

400

InvalidParameter.Conflict

%s

Un paramètre spécifié n'est pas valide. Vérifiez s'il existe des conflits de paramètres. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.

400

InvalidDataDiskSize.ValueNotSupported

%s

Valeur DataDiskSize non valide. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.

400

InvalidSystemDiskSize.ValueNotSupported

%s

Valeur SystemDisk.Size non valide.

400

IncompleteParamter

Some fields can not be null in this request.

Un paramètre requis n'est pas spécifié.

400

InvalidRegionId.MalFormed

The specified RegionId is not valid.

Valeur RegionId non valide.

400

InvalidParam.Type

The specified type is not supported.

Valeur Type non valide.

400

LastOrderProcessing

The previous order is still processing, please try again later.

La commande est en cours de traitement. Réessayez ultérieurement.

400

InvalidSystemDiskSize.ImageNotSupportResize

The specified image does not support resize.

L'image spécifiée ne prend pas en charge le redimensionnement.

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 de disque spécifiée dépasse la limite de quota pour la zone. Vous pouvez accéder au Quota Center pour afficher et augmenter le quota.

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 la prise d'effet de la commande.

403

OperationDenied

The type of the disk does not support the operation.

La catégorie de disque ne prend pas en charge cette opération.

403

OperationDenied

The status of the disk or the instance that the disk is attaching with does not support the operation.

L'opération ne peut pas être effectuée sur le disque ou l'instance dans l'état actuel.

403

InvalidDiskSize.TooSmall

Specified new disk size is less than the original disk size.

La nouvelle capacité de disque spécifiée est inférieure à la capacité d'origine du disque.

403

InvalidDiskSize.TooLarge

Specified new disk size is beyond the permitted range.

La nouvelle taille de disque spécifiée est hors plage.

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 avant de continuer.

403

DiskInArrears

The specified operation is denied as your disk owing fee.

Vous avez un impayé pour le disque spécifié.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

L'opération ne peut pas être effectuée sur la ressource dans l'état actuel.

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

InvalidDiskSize

Specified new disk size is less than or equal the original disk size.

La nouvelle taille du disque doit être supérieure à la taille d'origine du disque.

403

Operation.Conflict

The operation may conflicts with others.

L'opération entre en conflit avec d'autres opérations.

403

InstanceLockedForSecurity

The instance is locked due to security.

Cette opération ne peut pas être effectuée sur la ressource verrouillée pour des raisons de sécurité.

403

IncorrectDiskStatus

The current disk status does not support this operation.

Cette opération ne peut pas être effectuée sur le disque 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.

Vous n'êtes pas autorisé à gérer le disque. Réessayez lorsque vous serez autorisé.

403

InvalidDiskCategory.NotSupported

The specified disk category is not supported.

La catégorie de disque spécifiée ne prend pas en charge cette opération.

403

InvalidRegion.NotSupport

The specified region does not support resize online.

Le redimensionnement en ligne n'est pas pris en charge dans la région.

403

InvalidDiskCategory.NotSupported

The specified disk category does not support resize online.

La catégorie de disque spécifiée ne prend pas en charge le redimensionnement en ligne.

403

IncorrectInstanceStatus

The current status of the resource does not support resize online.

Cette opération ne peut pas être effectuée sur la ressource dans l'état actuel.

403

InvalidInstanceStatus.NotRunning

The status of instance to which the disk attachs must be running when resizing online.

L'instance à laquelle le disque est attaché n'est pas dans l'état Running lors du redimensionnement en ligne du disque.

403

InvalidParameter.KMSKeyId.CMKUnauthorized

The CMK needs to be added ECS tag.

Vous n'êtes pas autorisé à utiliser la clé maître cliente (CMK).

403

InvalidParameter.KMSKeyId.CMKNotEnabled

The CMK needs to be enabled.

La CMK n'est pas activée lorsque l'ID de la CMK est spécifié pour un disque. Vous pouvez appeler l'opération DescribeKey de Key Management Service (KMS) pour interroger les informations sur la CMK spécifiée.

403

InvalidParameter.KMSKeyId.KMSUnauthorized

ECS service have no right to access your KMS.

ECS n'est pas autorisé à accéder à vos ressources KMS.

403

SecurityRisk.3DVerification

We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.

Des risques ont été détectés sur votre carte de crédit ou de débit par défaut. Cliquez sur l'URL dans l'e-mail pour la vérification.

403

QuotaExceeded.PostpaidDataDiskCapacity

The quota of postpaid data disk capacity exceeds.

La capacité des disques de données à la demande dépasse la limite de quota.

403

InvalidOperation.MultiAttachDiskNotSupportResizeOnline

Multi attach disk does not support resize online.

Le disque pour lequel la fonctionnalité multi-attach est activée ne prend pas en charge le redimensionnement en ligne.

404

InvalidDiskId.NotFound

The specified disk does not exist.

Le disque spécifié est introuvable. Vérifiez si l'ID de disque spécifié 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.

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.

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.