ResizeDisk - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

システムディスクまたはデータディスクのサイズを変更します。

操作説明

説明

容量を拡張する前に、クラウドディスクのパーティション形式を必ず確認してください。MBR 形式の場合、2 TiB を超える拡張はサポートされておらず、データ損失の原因となります。MBR パーティションを拡張するには、新しいデータディスクを作成してマウントし、GPT パーティション形式を使用してから、既存のデータを新しいデータディスクにコピーすることを推奨します。詳細については、「クラウドディスク容量の拡張」をご参照ください。

サイズ変更をサポートするディスクカテゴリには、基本ディスク (cloud)、Ultra ディスク (cloud_efficiency)、標準 SSD (cloud_ssd)、ESSD (cloud_essd)、ESSD AutoPL ディスク (cloud_auto)、標準エラスティック一時ディスク (elastic_ephemeral_disk_standard)、プレミアムエラスティック一時ディスク (elastic_ephemeral_disk_premium)、ESSD 同一リージョン冗長ディスク (cloud_regional_disk_auto) が含まれます。
スナップショットを作成中のクラウドディスクは、サイズ変更をサポートしていません。スナップショットの作成が完了してから、サイズ変更操作を開始してください。
このインターフェイスはパーティションとファイルシステムを拡張できません。クラウドディスクの容量を拡張した後、パーティションとファイルシステムを自分で割り当てる必要があります。具体的な操作については、「パーティションとファイルシステムの拡張 (Linux)」および「パーティションとファイルシステムの拡張 (windows)」をご参照ください。
マルチアタッチ機能が有効になっているクラウドディスクは、オンラインリサイズとオフラインリサイズをサポートしています。ディスクがアタッチされているインスタンスが次の条件を満たしていることを確認してください：
- オンラインリサイズの場合、インスタンスのステータスは実行中 (Running) である必要があります。
- オフラインリサイズの場合、インスタンスのステータスは実行中 (Running) または停止済み (Stopped) である必要があります。
クラウドディスクが次の条件を満たしていることを確認してください：
- クラウドディスクのステータスが使用中 (In Use) または利用可能 (Available) であること。
- (強く推奨) クラウドディスクのデータをバックアップするためにスナップショットが作成されていること。具体的な操作については、「スナップショットの作成」をご参照ください。
- 新しく購入したデータディスクの場合は、サイズ変更操作を実行する前に初期化を完了してください。詳細については、「初期化の概要」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:ResizeDisk

update

*Disk

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DiskId	string	必須	ディスクの ID。 DescribeDisks 操作を呼び出して、利用可能なディスク ID をクエリできます。	d-bp67acfmxazb4p****
Type	string	任意	ディスクのサイズを変更する方法。有効な値： offline (デフォルト): ディスクをオフラインでサイズ変更します。ディスクをオフラインでサイズ変更した後、コンソールでインスタンスを再起動するか、API オペレーション RebootInstance を呼び出して操作を有効にする必要があります。 online: インスタンスを再起動することなく、ディスクをオンラインでサイズ変更します。Ultra ディスク、標準 SSD、ESSD、エラスティック一時ディスクをオンラインでサイズ変更できます。	offline
NewSize	integer	必須	新しいディスク容量。単位：GiB。有効な値：システムディスク：基本ディスク (cloud): 20～500。 ESSD (cloud_essd): 有効な値は ESSD のパフォーマンスレベルによって異なります。 SystemDisk.PerformanceLevel が PL0 に設定されている場合の有効な値：1～2048。 SystemDisk.PerformanceLevel が PL1 に設定されている場合の有効な値：20～2048。 SystemDisk.PerformanceLevel が PL2 に設定されている場合の有効な値：461～2048。 SystemDisk.PerformanceLevel が PL3 に設定されている場合の有効な値：1261～2048。 ESSD AutoPL ディスク: 1～2048。その他のディスクカテゴリ: 20～2048。データディスク： Ultra ディスク (cloud_efficiency): 20～32768。標準 SSD (cloud_ssd): 20～32768。 ESSD (cloud_essd): 有効な値は ESSD のパフォーマンスレベルによって異なります。ESSD のパフォーマンスレベルをクエリするには、DescribeDisks 操作を呼び出してディスク情報をクエリし、応答の `PerformanceLevel` 値を確認します。 PL0 ESSD: 1～65536。 PL1 ESSD: 20～65536。 PL2 ESSD: 461～65536。 PL3 ESSD: 1261～65536。基本ディスク (cloud): 5～2000。 ESSD AutoPL ディスク (cloud_auto): 1～65536。標準エラスティック一時ディスク (elastic_ephemeral_disk_standard): 64～8192。プレミアムエラスティック一時ディスク (elastic_ephemeral_disk_premium): 64～8192。説明新しいディスク容量は、元のディスク容量より大きい必要があります。そうでない場合、エラーが報告されます。	1900
ClientToken	string	任意	新しいディスク容量。単位：GiB。有効な値：システムディスクの場合：基本ディスク (cloud): 20～500。 ESSD (cloud_essd): 有効な値は ESSD のパフォーマンスレベルによって異なります。 PL0 ESSD: 1～2048。 PL1 ESSD: 20～2048。 PL2 ESSD: 461～2048。 PL3 ESSD: 1261～2048。 ESSD AutoPL ディスク: 1～2048。その他のディスクカテゴリ: 20～2048。データディスクの場合： Ultra ディスク (cloud_efficiency): 20～32768。標準 SSD (cloud_ssd): 20～32768。 ESSD (cloud_essd): 有効な値は ESSD のパフォーマンスレベルによって異なります。ESSD のパフォーマンスレベルをクエリするには、DescribeDisks 操作を呼び出してディスク情報をクエリし、応答の `PerformanceLevel` 値を確認します。 PL0 ESSD: 1～65536。 PL1 ESSD: 20～65536。 PL2 ESSD: 461～65536。 PL3 ESSD: 1261～65536。基本ディスク (cloud): 5～2000。 ESSD AutoPL ディスク (cloud_auto): 1～65536。標準エラスティック一時ディスク (elastic_ephemeral_disk_standard): 64～8192。プレミアムエラスティック一時ディスク (elastic_ephemeral_disk_premium): 64～8192。説明新しいディスク容量は、元のディスク容量より大きい必要があります。そうでない場合、エラーが報告されます。	123e4567-e89b-12d3-a456-426655440000

レスポンスフィールド

フィールド	型	説明	例
	object
OrderId	string	注文の ID。	20413515388****
RequestId	string	リクエストの ID。	F3CD6886-D8D0-4FEE-B93E-1B732396****

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.
400	InvalidParameter.Conflict	%s
400	IncompleteParamter	Some fields can not be null in this request.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	InvalidParam.Type	The specified type is not supported.
400	LastOrderProcessing	The previous order is still processing, please try again later.
400	InvalidStatus.Upgrading	The instance which the disk attachs is upgrading; please try again later.
400	InvalidSystemDiskSize.ImageNotSupportResize	The image of the instance does not support resize.
400	InvalidDisk.DetachedSystemDisk	The specified disk is a detached system disk, does not support this operation.
400	OperationDenied.NotEnoughCapacity	The capacity of the current dedicated block storage cluster is not enough to expand.
400	IncorrectDiskStatus.ReplicationStatusNotFound	Disk replication status not found.
400	IncorrectDiskStatus.InReplication	Disk already in replication.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.
400	InvalidOperation.InstanceRenewWithDowngradeInPlan	The operation is denied due to the specified instance has renew with downgrade record in plan.
400	InvalidSystemDiskSize.ValueNotSupported	The specified system disk size is invalid.
400	OperationDenied.UnfinishedOrder	The current instance has unfinished refundOrder, this operation is denied.
400	AccountForbidden.CreateOrder	Order cannot be created due to abnormal account.
500	InternalError	The request processing has failed due to some unknown error.
403	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.
403	OperationDenied	The type of the disk does not support the operation.
403	InvalidDiskSize.TooSmall	Specified new disk size is less than the original disk size.
403	InvalidDiskSize.TooLarge	Specified new disk size is beyond the permitted range.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	DiskError	Incorrect disk status.
403	DiskInArrears	The specified operation is denied as your disk owing fee.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	DiskCreatingSnapshot	The operation is denied due to a snapshot of the specified disk is not completed yet.
403	InvalidDiskSize	Specified new disk size is less than or equal the original disk size.
403	Operation.Conflict	The operation may conflicts with others.
403	InstanceLockedForSecurity	The instance is locked due to security.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	UserNotInTheWhiteList	The user is not in disk white list.
403	InvalidDiskCategory.NotSupported	The specified disk category is not supported.
403	InvalidRegion.NotSupport	The specified region does not support resize online.
403	InvalidInstanceStatus.NotRunning	The status of instance to which the disk attachs must be running when resizing online.
403	InvalidOperation.InstanceTypeNotSupportOnlineResize	The instance type of the specified instance does not support resize online.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK needs to be added ECS tag.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.
403	InstanceSpecModification.NotEffective	The instance which the disk attachs has been reserved for making a spec modification and not taken effective in the current contract period.
403	InvalidDiskSize.NotSupportResizeOnline	The current size of the resource does not support resize online.
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.
403	QuotaExceeded.PostpaidDataDiskCapacity	The quota of postpaid data disk capacity exceeds.
403	InvalidOperation.MultiAttachDiskNotSupportResizeOnline	Multi attach disk does not support resize online.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.
403	InvalidDiskSize.NotSupportMultiAttachDisk	The specified disk size exceeds the maximum limit 65536 for enabling multi-attach.
404	InvalidDiskId.NotFound	The specified disk does not exist.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。