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

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

操作説明

この操作を呼び出す前に、ECS の課金方法と料金を十分に理解していることを確認してください。。。

。

この操作を呼び出す前に、ECS の課金方法と料金電卓を十分に理解していることを確認してください。。。

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

前提条件。

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

説明

帯域幅課金方式で課金される 1 つのリージョン内の 1 つの 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 サービスインスタンスをスペックアップする場合は、以下の項目に注意してください: クラシックネットワークタイプのインスタンス: 販売終了したインスタンスタイプの場合、非 I/O 最適化インスタンスを I/O 最適化インスタンスに変更すると、インスタンスの非公開 IP アドレス、ディスクデバイス名、およびソフトウェア権限付与コードが変更されます。Linux インスタンスの場合、ベーシックディスク (`cloud`) は xvda または xvdb として識別され、ウルトラディスク (`cloud_efficiency`) および標準 SSD (`cloud_ssd`) は vda または vdb として識別されます。購入可能なインスタンスファミリーの場合、インスタンスの非公開 IP アドレスが変更されます。 VPC タイプのインスタンス: 販売終了したインスタンスタイプの場合、非 I/O 最適化インスタンスを I/O 最適化インスタンスに変更すると、インスタンスのディスクデバイス名およびソフトウェア権限付与コードが変更されます。Linux インスタンスの場合、ベーシックディスク (`cloud`) は xvda または xvdb として識別され、ウルトラディスク (`cloud_efficiency`) および標準 SSD (`cloud_ssd`) は vda または vdb として識別されます。	false
SystemDisk.Category	string	任意	更换系统盘类型。取值范围： cloud_efficiency：高效云盘 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.
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.
400	InvalidParameter.AllowMigrateAcrossZone	The specified parameter CanMigrateAcrossZone is not valid.
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.
400	InvalidInstanceStatus.NotStopped	The specified Instance status is not stopped.
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.
400	Price.PricePlanResultNotFound	The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid.
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.
400	InvalidOperation.VpcHasEnabledAdvancedNetworkFeature	The specified vpc has enabled advanced network feature.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.
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.
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.
400	InvalidParameter.DedicatedRegionNotSupported	The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP.
400	InvalidOperation.OnlineModificationUnsupported	Online modification of instance type is not supported for the specified instance due to its CPU topology.
400	QuotaExceeded.InternetBandwidth	%s.
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support 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.
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.
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
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.
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.
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
403	InvalidOperation.Ipv6CountExceeded	%s
403	InvalidOperation.Ipv6NotSupport	%s
403	InvalidOperation.Ipv4NotSupport	%s
403	InvalidOperation.InstanceWithEipNotSupport	The special instance with eip not support operate, please unassociate eip first.
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	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.
403	InvalidResourceType.NotSupported	%s
403	InvalidOperation.NotAllowed	The specified vpc %s has enabled senior network feature.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s
403	InvalidOperation.MaxEniQueueNumberExceeded	%s
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s
403	InvalidParameter.InvalidEniQueueNumber	%s
403	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.
403	InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode	%s
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.
403	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.
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.

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

変更履歴

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