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

システムディスクおよびデータディスクを含むクラウドディスクの容量を拡張します。

操作説明

説明

ディスクを拡張する前に、ディスクのパーティション形式を確認してください。ディスクが MBR パーティション形式を使用している場合、ディスクを 2 TiB 以上に拡張することはできません。拡張すると、データ損失が発生する可能性があります。MBR パーティションのディスクを拡張するには、GUID パーティションテーブル (GPT) 形式を使用する新しいデータディスクを作成してアタッチし、既存のデータを新しいデータディスクにコピーします。詳細については、「ディスクの拡張」を参照してください。

サポートされているディスクタイプには、基本ディスク (cloud)、Ultra ディスク (cloud_efficiency)、標準 SSD (cloud_ssd)、ESSD (エンタープライズ SSD) (cloud_essd)、ESSD AutoPL ディスク (cloud_auto)、エラスティック一時ディスク - Standard (elastic_ephemeral_disk_standard)、エラスティック一時ディスク - Premium (elastic_ephemeral_disk_premium)、およびリージョン ESSD (cloud_regional_disk_auto) が含まれます。
スナップショットの作成中のディスクは拡張できません。スナップショットの作成が完了するまで待ってから、ディスクを拡張してください。
この操作では、パーティションまたはファイルシステムは拡張されません。ディスク容量を拡張した後、パーティションとファイルシステムを手動で割り当てる必要があります。詳細については、「パーティションとファイルシステムの拡張 (Linux)」および「パーティションとファイルシステムの拡張 (Windows)」を参照してください。
マルチアタッチ機能が有効なディスクは、オンラインとオフラインの両方の拡張をサポートしています。ディスクがアタッチされているインスタンスが次の要件を満たしていることを確認してください。
- オンライン拡張の場合、インスタンスステータスが Running (Running) である必要があります。
- オフライン拡張の場合、インスタンスステータスが Running (Running) または Stopped (Stopped) である必要があります。
ディスクが次の要件を満たしていることを確認してください。
- ディスクが In Use (In Use) または Available (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 (デフォルト): オフライン拡張。拡張後、変更の効果を発揮するために、「インスタンスの再起動」の手順に従ってコンソールでインスタンスを再起動するか、 RebootInstance 操作の呼び出しを行う必要があります。 online: オンライン拡張。インスタンスを再起動せずに効果を発揮します。サポートされているディスクタイプには、Ultra ディスク、標準 SSD、ESSD (エンタープライズ SSD)、およびエラスティック一時ディスクが含まれます。	offline
NewSize	integer	必須	拡張先の新しいディスク容量。単位: GiB。有効な値: システムディスク: 基本ディスク: 20 ~ 500。 ESSD (エンタープライズ SSD): PL0: 1 ~ 2048。 PL1: 20 ~ 2048。 PL2: 461 ~ 2048。 PL3: 1261 ~ 2048。 ESSD AutoPL ディスク: 1 ~ 2048。その他のディスクタイプ: 20 ~ 2048。データディスク: Ultra ディスク (cloud_efficiency): 20 ~ 32768。標準 SSD (cloud_ssd): 20 ~ 32768。 ESSD (エンタープライズ SSD) (cloud_essd): 有効な値は `PerformanceLevel` の値によって異なります。 DescribeDisks を呼び出してディスク情報をクエリし、応答内の `PerformanceLevel` パラメーターを確認できます。 PL0: 1 ~ 65536。 PL1: 20 ~ 65536。 PL2: 461 ~ 65536。 PL3: 1261 ~ 65536。基本ディスク (cloud): 5 ~ 2000。 ESSD AutoPL ディスク (cloud_auto): 1 ~ 65536。エラスティック一時ディスク - Standard (elastic_ephemeral_disk_standard): 64 ~ 8,192。エラスティック一時ディスク - Premium (elastic_ephemeral_disk_premium): 64 ~ 8,192。説明指定された新しいディスク容量は、元のディスク容量より大きい必要があります。そうでない場合、エラーが返されます。	1900
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken の値には ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」を参照してください。	123e4567-e89b-12d3-a456-426655440000

レスポンスフィールド

フィールド	型	説明	例
	object
OrderId	string	注文の ID。説明注文の 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 is beyond the permitted range; or the capacity of the 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.	指定された Type パラメーターが無効です。
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. This operation is not supported.
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 to 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.	指定された SystemDisk.Size が無効です。
400	OperationDenied.UnfinishedOrder	The current instance has an unfinished refund order. This operation is denied.
400	AccountForbidden.CreateOrder	Order cannot be created due to abnormal account.	現在のアカウントは注文を作成できません。
400	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the 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 because the disk has overdue payments. Please settle the outstanding balance.
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 conflict with others. Please retry later.
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.	現在のインスタンスステータスでは、この操作はサポートされていません。インスタンスステータスが Running のときにこの操作を実行してください。
403	InvalidOperation.InstanceTypeNotSupportOnlineResize	The instance type of the specified instance does not support resize online.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
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.	デフォルトのクレジットカードまたはデビットカードでセキュリティリスクが検出されました。メール内のリンクを使用して ID を確認してください。
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.	指定された DataDisk.n.Category パラメーターは無効です。
403	InvalidDiskSize.NotSupportMultiAttachDisk	The specified disk size exceeds the maximum limit 65536 for enabling multi-attach.	64 TB を超えるディスクではマルチアタッチの有効化はサポートされていません。
404	InvalidDiskId.NotFound	The specified disk does not exist.	指定されたディスクが存在しません。ディスク ID が正しいかどうかを確認してください。
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	指定されたインスタンスが存在しません。インスタンス ID が正しいかどうかを確認してください。

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

変更履歴

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