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

従量課金 ECS インスタンスのインスタンスタイプまたはパブリック帯域幅を変更します。

操作説明

この操作を実行する前に、ECS の課金方法および電卓を完全に理解していることを確認してください。

従量課金インスタンスのインスタンスタイプを変更する前に、 DescribeResourcesModification を呼び出して、現在のインスタンスが変更可能なインスタンスタイプをクエリできます。

注意事項

アカウントに料金滞納がないこと。
各呼び出しで変更できる構成は 1 つのみです。単一のリクエストでは、インスタンスタイプの変更またはパブリック帯域幅の調整のいずれかのみを実行できます。
パブリック帯域幅を調整するには、インスタンスステータスが Running (Running) または Stopped (Stopped) である必要があります。変更は直ちに効果があります。
インスタンスタイプを変更するには、インスタンスステータスが Stopped (Stopped) である必要があります。変更後、変更を有効にするにはインスタンスを起動する必要があります。

説明

単一の Alibaba Cloud アカウントの単一リージョンにおける、帯域幅課金の合計ピークパブリック帯域幅には制限があります。詳細については、「パブリック帯域幅の制限」をご参照ください。この制限はプロダクトとして適用されます。

今すぐお試しください

この 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:ModifyInstanceSpec

update

*Instance。

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

ecs:AssociatePublicIpAddress

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceId	string	必須	インスタンス ID	i-bp67acfmxazb4p****
InstanceType	string	任意	ターゲットインスタンスタイプ。詳細については、「インスタンスファミリー」をご参照ください。 DescribeInstanceTypes を呼び出して、最新のインスタンスタイプリストをクエリすることもできます。初期化形式に従ってください。	ecs.g6.large
InternetMaxBandwidthOut	integer	任意	アウトバウンドパブリック帯域幅の最大値。単位: Mbit/s。有効な値: 0～100。説明トラフィック課金モードでは、ピークインバウンドおよびアウトバウンド帯域幅は帯域幅の上限として使用され、保証されません。リソース競合が発生した場合、ピーク帯域幅が制限される可能性があります。ビジネスで保証された帯域幅が必要な場合は、帯域幅課金モードを使用してください。	10
InternetMaxBandwidthIn	integer	任意	インバウンドパブリック帯域幅の最大値。単位: Mbit/s。有効な値: 購入したアウトバウンドパブリック帯域幅が 10 Mbit/s 以下の場合: 1～10。デフォルト値: 10。購入したアウトバウンドパブリック帯域幅が 10 Mbit/s より大きい場合: 1～`InternetMaxBandwidthOut` の値。デフォルト値: `InternetMaxBandwidthOut` の値。説明トラフィック課金モードでは、ピークインバウンドおよびアウトバウンド帯域幅は帯域幅の上限として使用され、保証されません。リソース競合が発生した場合、ピーク帯域幅が制限される可能性があります。ビジネスで保証された帯域幅が必要な場合は、帯域幅課金モードを使用してください。	10
Temporary.StartTime	string	任意	説明このパラメーターは招待プレビュー中であり、一般公開されていません。	null
Temporary.EndTime	string	任意	説明このパラメーターは招待プレビュー中であり、一般公開されていません。	null
Temporary.InternetMaxBandwidthOut	integer	任意	説明このパラメーターは招待プレビュー中であり、一般公開されていません。	null
Async	boolean	任意	非同期リクエストを送信するかどうかを指定します。有効な値: true: リクエストは非同期で送信されます。 false: リクエストは非同期で送信されません。デフォルト値: false。	false
AllowMigrateAcrossZone	boolean	任意	クロスクラスターインスタンスのスペックアップをサポートするかどうかを指定します。有効な値: true: サポートされます。 false: サポートされません。デフォルト値: false。パラメーター `AllowMigrateAcrossZone` を true にセットし、応答に基づいて Elastic Compute Service インスタンスをスペックアップする場合、次の点に注意してください。クラシックネットワークタイプのインスタンス: 廃止されたインスタンスタイプの場合、非 I/O 最適化インスタンスから I/O 最適化インスタンスへの変更時に、インスタンスの非公開 IP アドレス、ディスクデバイス名、およびソフトウェア権限付与コードが変更されます。Linux インスタンスの場合、ベーシックディスク (`cloud`) は xvda または xvdb として識別され、Ultra ディスク (`cloud_efficiency`) および標準 SSD (`cloud_ssd`) は vda または vdb として識別されます。購入可能なインスタンスファミリーの場合、インスタンスの非公開 IP アドレスが変更されます。 VPC タイプのインスタンス: 廃止されたインスタンスタイプの場合、非 I/O 最適化インスタンスから I/O 最適化インスタンスへの変更時に、インスタンスのサーバーディスクデバイス名およびソフトウェア権限付与コードが変更されます。Linux インスタンスの場合、ベーシックディスク (`cloud`) は xvda または xvdb として識別され、Ultra ディスク (`cloud_efficiency`) および標準 SSD (`cloud_ssd`) は vda または vdb として識別されます。	false
SystemDisk.Category	string	任意	システムディスクの新しいカテゴリ。有効な値: cloud_efficiency: Ultra ディスク cloud_ssd: 標準 SSD 説明このパラメーターは、廃止されたインスタンスタイプから購入可能なインスタンスファミリーへのスペックアップ時に、非 I/O 最適化インスタンスから I/O 最適化インスタンスへ変更する場合にのみ有効です。	cloud_ssd
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken の値には ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。初期化形式に従ってください。	0c593ea1-3bea-11e9-b96b-88e9fe637760
ModifyMode	string	任意	説明このパラメーターは一般公開されていません。	null
Disk	array<object>	任意	説明このパラメーターは一般公開されていません。
	object	任意	説明このパラメーターは一般公開されていません。
DiskId	string	任意	説明このパラメーターは一般公開されていません。	null
Category	string	任意	説明このパラメーターは一般公開されていません。	null
PerformanceLevel	string	任意	説明このパラメーターは一般公開されていません。	null
DryRun	boolean	任意	ドライランのみを実行するかどうかを指定します。有効な値: true: ドライランのみを実行します。インスタンスタイプとパブリック帯域幅は変更済みになりません。システムは、必須パラメーターが指定されているか、リクエストの初期化形式が有効か、ビジネス制限を満たしているか、および ECS リソースが利用可能かどうかを確認します。チェックが失敗した場合、対応するエラーが返されます。チェックが成功した場合、`DryRunOperation` エラーコードが返されます。 false (デフォルト): ドライランを実行し、リクエストを送信します。チェックが成功した場合、インスタンスタイプとパブリック帯域幅が直接変更されます。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	指定されたネットワーク使用量の課金方法はサポートされていません。関連パラメーターが正しいことを確認してください。
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType does not exist or beyond the permitted range.	指定されたインスタンスタイプが存在しないか、またはこのタイプのインスタンスを操作するレートがありません。
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	指定されたインスタンスタイプは、現在のインスタンスにアタッチされているデータディスクのディスクタイプをサポートしていません。
400	InvalidParameter	The specified parameter "InternetMaxBandwidthOut" is not valid.
400	InvalidParameter.Mismatch	Too many parameters in one request.	暗号化されていないディスクは、暗号化されたスナップショットを使用してリセットできません。
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	現在のインスタンスは EIP に関連付けられています。
400	InvalidTemporary.StartTime	The specifed Temporary.StartTime is not valid.	指定された一時的なアップグレードの開始時刻が無効です。
400	InvalidTemporary.EndTime	The specifed Temporary.EndTime is not valid.	指定された一時的なアップグレードの終了時刻が無効です。
400	Downgrade.NotSupported	Downgrade operation is not supported.	スペックダウンはサポートされていません。
400	DependencyViolation.InstanceType	The current InstanceType cannot be changed to the specified InstanceType.	現在のインスタンスのインスタンスタイプを指定されたインスタンスタイプに変更できません。
400	Account.Arrearage	Your account has an outstanding payment.	アカウントに未払いがあります。
400	InvalidParameter.Bandwidth	The specified parameter Bandwidth is not valid.	指定された帯域幅が有効ではありません。パラメーターが正しいかどうかを確認してください。
400	InvalidParameter.Conflict	The specified image does not support the specified instance type.	現在の操作では、ディスクId とイメージId を同時に指定することはできません。ディスクId またはイメージId のいずれかが空でないことを確認してください。
400	InvalidParameter.AllowMigrateAcrossZone	The specified parameter CanMigrateAcrossZone is not valid.	指定されたパラメーター CanMigrateAcrossZone レートが有効ではありません。
400	InvalidParam.SystemDiskCategory	The specified param SystemDisk.Category is not valid.	指定されたシステムディスクタイプパラメーターが無効です。
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	リクエストがスロットルされました。クエリには PageNumber ベースのページングメソッドではなく、NextToken ベースのページングメソッドを使用してください。
400	InvalidInstanceStatus.NotStopped	The specified Instance status is not stopped.	インスタンスが停止状態ではないため、Secure Boot の設定を変更できません。
400	InvalidAction	Specified action is not valid.	指定された操作タイプはサポートされていません。
400	IdempotenceParamNotMatch	There is a idempotence signature mismatch between this and last request.	べき等性パラメーターが一致しません。
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	指定された ClientToken が無効です。
400	Price.PricePlanResultNotFound	The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid.	指定された internetMaxBandwidthIn または internetMaxBandwidthOut が無効です。
400	InvalidAction.NotSupport	The ecs on dedicatedHost not support modify instanceType.	専用ホスト上のインスタンスではインスタンスタイプの変更はサポートされていません。
400	InvalidMarketImageStatus.NotSupported	The status of specified market image does not support this operation.	指定された Alibaba Cloud Marketplace イメージのステータスでは、この操作はサポートされていません。
400	InvalidOperation.VpcHasEnabledAdvancedNetworkFeature	The specified vpc has enabled advanced network feature.	VPC で高度な特徴が有効になっているため、低スペックの ECS インスタンスを作成できません。
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	指定されたパラメーター PrivatePoolOptions.MatchCriteria が無効です。
400	InstanceTypeNotSupported.TooManyDisksAttached	%s
400	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.
400	InvalidParameter.CloudboxNotSupported	%s
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	指定されたディスクタイプの使用容量がアクティブなゾーンのクォータ制限を超えました。クォータセンターでディスク容量クォータのクエリおよび引き上げリクエストを行えます。
400	InvalidParam.Async	The specified parameter async is not valid.	Async パラメーターが無効です。
400	MissingParameter.DiskCategory	The specified parameter Disk.Category can not be null when Disk.DiskId is specified.
400	InvalidParameter.DiskCategory	The specified parameter Disk.Category is not valid.
400	InvalidPerformanceLevel.Malformed	The specified parameter Disk.n.PerformanceLevel is not valid.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	この操作には課金に関する権限が必要です。Alibaba Cloud アカウントから権限を申請するか、AutoPay パラメーターを true に設定して自動支払いを行ってください。
400	InvalidParameter.DedicatedRegionNotSupported	The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.	専用クラウドリージョンのインスタンスは、パブリック IP 関連のパラメーターをサポートしていません。
400	InvalidOperation.OnlineModificationUnsupported	Online modification of instance type is not supported for the specified instance due to its CPU topology.	現在の CPU トポロジータイプはホットスペック変更をサポートしていません。
400	QuotaExceeded.InternetBandwidth	%s.	現在のアカウント配下の従量課金 ECS インスタンスの帯域幅課金パブリック帯域幅の合計が、帯域幅クォータ制限の合計を超えています。
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.	指定されたインスタンスのインスタンスタイプは、RSS の有効化をサポートしていません。
400	InvalidInstanceType.NotSupportCpuOptionsNestedVirtualization	The specified instance type does not support CpuOptions.NestedVirtualization: %s.	現在のインスタンスタイプは、指定された入れ子になった仮想化機能をサポートしていません。
401	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	指定されたインスタンスタイプが存在しないか、またはこのタイプのインスタンスを操作するレートがありません。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	リクエストの送信中にエラーが発生しました。後でもう一度お試しください。
403	CategoryViolation	The specified instance does not support this operation because of its disk category.
403	InvalidStatus.ValueNotSupported	The current status of the resource does not support this operation.	指定された発行の repairStatus が無効です。期待されるステータスは空または失敗したです。
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	インスタンスはセキュリティ上の理由によりロック済みです。セキュリティテクニカルサポートにお問い合わせください。
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	OperationDenied	The specified instance is out of usage.	指定された EIP は利用できないか、権限が付与されていません。
403	LastTokenProcessing	The last token request is processing.
403	InvalidInstance.UnpaidOrder	The specified instance has unpaid order.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	指定されたインスタンスはスペック変更のため予約されており、現在の契約期間中は効果がありません。
403	InvalidInstanceType.ValueNotSupported	The specified zone does not offer the specified instancetype.	指定されたインスタンスタイプは、現在のインスタンスにアタッチされているデータディスクのディスクタイプをサポートしていません。
403	ImageNotSupportInstanceType	The specified image do not support the InstanceType instance.	指定されたイメージは選択されたインスタンスタイプのインスタンスをサポートしていません。
403	InstanceType.Offline	The specified InstanceType has been offline.	指定されたインスタンスタイプは廃止されました。
403	InvalidParameter.NotMatch	%s	指定されたインスタンスタイプは特定のイメージのみをサポートしています。利用可能なイメージをクエリするには、DescribeImages 操作を呼び出してください。
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	EIP がバインドされているインスタンスでは、この操作はサポートされていません。先に EIP の関連付けを解除してください。
403	InvalidInstance.NatPortMapNotSupport	The special instance with nat port map not support operate, please remove nat port map first.
403	InvalidOperation.StarterPackage	StarterPackage not support modification.
403	OperationDenied.NoStock	The resource is out of usage.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	指定されたインスタンス ID に未払いの注文があります。ECS コンソールにログインして支払いを完了できます。
403	InvalidOperation.EipNotSupport	The special instance with eip not support operate, please unassociate eip first.
403	InvalidParameter.InternetMaxBandwidthOut	The specified parameter InternetMaxBandwidthOut is invalid.
403	InvalidOperation.EniCountExceeded	%s
403	InvalidOperation.Ipv4CountExceeded	%s	現在の ECS インスタンスにアタッチされている Elastic Network Interface (ENI) の IPv4 アドレス数が、ターゲットインスタンスタイプの制限を超えています。
403	InvalidOperation.Ipv6CountExceeded	%s	現在の ECS インスタンスにアタッチされている Elastic Network Interface (ENI) の IPv6 アドレス数が、ターゲットインスタンスタイプの制限を超えています。
403	InvalidOperation.Ipv6NotSupport	%s	現在のインスタンスタイプは IPv6 をサポートしていません。
403	InvalidOperation.Ipv4NotSupport	%s
403	InvalidOperation.InstanceWithEipNotSupport	The special instance with eip not support operate, please unassociate eip first.	EIP が関連付けられているインスタンスでは、この操作はサポートされていません。先に EIP の関連付けを解除してください。
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	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	指定されたインスタンスタイプ (InstanceType) は、現在のインスタンスのディスクカテゴリをサポートしていません。別のインスタンスタイプを選択してください。各インスタンスタイプでサポートされるディスクタイプについては、インスタンスファミリーのドキュメントを参照してください。
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	ECS の使用量がクォータを超えています。Alibaba Cloud マネジメントコンソールにログインし、クォータの引き上げをリクエストしてください。
403	InvalidResourceType.NotSupported	%s	指定されたリソースの組み合わせが存在しません。別のゾーンまたはインスタンスタイプをお試しください。
403	InvalidOperation.NotAllowed	The specified vpc %s has enabled senior network feature.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	指定されたインスタンスタイプは、Elastic Network Interface (ENI) のトランクモード操作をサポートしていません。
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Elastic Network Interface (ENI) のキュー数が上限を超えています。詳細については、エラーメッセージ内の %s プレースホルダーの実際の戻り結果を参照してください。
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	現在の ECS インスタンスにアタッチされている Elastic Network Interface (ENI) キューの数が、ターゲットインスタンスタイプのネットワークインターフェイスコントローラー (NIC) キュー上限を超えています。
403	InvalidParameter.InvalidEniQueueNumber	%s	ネットワークインターフェースコントローラー (NIC) のキュー番号が正しくありません。詳細については、エラーメッセージ内の %s プレースホルダーの実際の戻り結果を参照してください。
403	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.	インスタンスが休止状態オプションの有効化要件を満たしていないため、この操作は許可されていません。
403	InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode	%s	現在のインスタンスタイプは、RDMA ENI のアタッチをサポートしていません。
403	InvalidOperation.EniQueuePairNumberOverflow	%s
403	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	%s
403	InvalidOperation.MaxEniQueuePairNumberExceed	%s
403	InvalidOperation.MaxModifyOnlineNumberExceeded	The specified instance has reached the maximum number of modify online attempts and needs to be rebooted.
403	InvalidOperation.RebootingRequired	The specified instance needs to be rebooted.
403	InvalidOperation.OSTypeNotSupported	The specified OS type is not supported.
403	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter SystemDisk.Category is not valid.	指定されたシステムディスクの仕様パラメーターが無効です。
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	指定された DataDisk.Category パラメーターが無効です。
403	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.	指定されたディスクタイプは現在のゾーンではサポートされていません。ディスクタイプを変更するか、ゾーンを変更してから再試行してください。
403	InvalidOperation.InstanceTypeSecureBootUnsupported	The instance type does not support secure boot.	インスタンスタイプは Secure Boot をサポートしていません。
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	指定されたインスタンス ID が無効です。
404	MissingTemporary.StartTime	Temporary.StartTime is not specified.	一時的なアップグレードの開始時刻が指定されていません。
404	MissingTemporary.EndTime	Temporary.EndTime is not specified.	一時的なアップグレードの終了時刻が指定されていません。
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	サービスは現在利用できません。後でもう一度お試しください。

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

変更履歴

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