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

アクティブなサブスクリプション ECS インスタンスのターゲットインスタンスタイプへのアップグレード、またはサブスクリプションデータディスクの追加にかかる料金を取得します。

操作説明

有効期限内のサブスクリプション ECS インスタンスのアップグレード料金は照会できますが、ダウングレード料金は照会できません。
従量課金 ECS インスタンスのサイズ変更の料金は照会できません。サイズ変更後のインスタンスの料金は新規インスタンスと同じのため、現在の料金を取得するにはDescribePrice を呼び出してください。
インスタンスをアップグレードする前に、特定のアベイラビリティーゾーンでアップグレードに利用できるインスタンスタイプを確認するには、DescribeResourcesModification を呼び出してください。

今すぐお試しください

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

get

*Instance

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	リージョン ID。最新の Alibaba Cloud リージョンのリストを取得するには、DescribeRegions API を呼び出してください。	cn-hangzhou
InstanceId	string	必須	変更料金を照会するインスタンスの ID。	i-bp1f2o4ldh8l****
InstanceType	string	任意	インスタンスのアップグレード先のインスタンスタイプ。指定したアベイラビリティーゾーンでアップグレードに使用できるインスタンスタイプを照会するには、DescribeResourcesModification API を呼び出してください。説明 `InstanceType` と `DataDisk.N.*` パラメータのうち、少なくとも 1 つを指定する必要があります。	ecs.g6e.large
SystemDisk.Category	string	任意	システムディスクのカテゴリ。このパラメータは、廃止されたインスタンスタイプの非 I/O 最適化インスタンスを、利用可能なインスタンスタイプの I/O 最適化インスタンスにアップグレードする場合にのみ必須です。インスタンスタイプの詳細については、「インスタンスファミリー」および「廃止されたインスタンスタイプ」をご参照ください。有効な値： `cloud_efficiency` ：Ultra ディスク `cloud_ssd` ：標準 SSD デフォルト値：なし。	cloud_ssd
DataDisk	array<object>	任意
	object	任意	データディスクの構成。
PerformanceLevel	string	任意	ESSD のパフォーマンスレベル。このパラメータは、DataDisk.N.Category が cloud_essd に設定されている場合にのみ有効です。N の値は DataDisk.N.Category の N と一致する必要があります。有効な値： PL0 ：ディスクあたり最大 10,000 ランダム読み取り/書き込み IOPS。 PL1 ：ディスクあたり最大 50,000 ランダム読み取り/書き込み IOPS。 PL2 ：ディスクあたり最大 100,000 ランダム読み取り/書き込み IOPS。 PL3 ：ディスクあたり最大 1,000,000 ランダム読み取り/書き込み IOPS。デフォルト値：PL1。 ESSD のパフォーマンスレベルの詳細については、「ESSDs」 (~~122389~~) をご参照ください。	PL1
Size	integer	任意	データディスク N のサイズ (GiB)。N は 1～16 の整数です。値の範囲はディスクカテゴリによって異なります。 `cloud_efficiency` (Ultra ディスク) ：20～32768。 `cloud_ssd` (標準 SSD) ：20～32768。 `cloud_essd` ：値の範囲は `DataDisk.N.PerformanceLevel` の値によって異なります。 PL0 ：1～32768。 PL1 ：20～32768。 PL2 ：461～32768。 PL3 ：1261～32768。 `cloud` (ベーシックディスク) ：5～2000。デフォルト値：指定したデータディスクカテゴリでサポートされている最小サイズ。	100
Category	string	任意	データディスク N のカテゴリ。N は 1～16 の整数です。このパラメータを使用して、インスタンスに新しいデータディスクを追加する場合の料金を照会します。有効な値： `cloud_efficiency` ：Ultra ディスク `cloud_ssd` ：標準 SSD `cloud_essd` ：ESSD `cloud` ：ベーシックディスクデフォルト値：なし。	cloud_essd
DiskId	string	任意	データディスク N の ID。このパラメーターを使用して、特定のデータディスクを変更する場合の料金を照会します。	d-bf4rupt9****

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	A3DC3196-379B-4F32-A2C5-B937134FAD8A
PriceInfo	object	料金情報。料金詳細とプロモーションルールが含まれます。
Rules	object
Rule	array<object>	プロモーションルールのリスト。
	object
Description	string	ルールの説明。	升级优惠
RuleId	integer	ルール ID。	1234567890
Price	object	料金詳細。
OriginalPrice	number	元の価格。	175.200
DiscountPrice	number	割引額。	61.320
Currency	string	通貨。有効値： `CNY`：中国サイト用。 `USD`：国際サイト用。	CNY
TradePrice	number	最終価格 (元の価格 - 割引額)。	113.880
DetailInfos	object
DetailInfo	array<object>	設定内の各リソースの料金詳細のリスト。説明このパラメーターは、`ResourceType` が `instance` に設定されている場合にのみ返されます。
	array<object>	単一リソースの料金詳細。
Resource	string	リソースタイプ。有効値： `instanceType`：インスタンスタイプ `bandwidth`：帯域幅 `image`：イメージ `systemDisk`：システムディスク `dataDisk`：データディスク	instanceType
OriginalPrice	number	元の価格。	4368
DiscountPrice	number	割引額。	655.2
TradePrice	number	最終価格 (元の価格 - 割引額)。	3712.8
SubRules	object
Rule	array<object>	料金ルールのサブセットのリスト。
	object	単一の料金ルールのサブセット。
Description	string	ルールサブセットの説明。	买满1年，立享官网价格8.5折优惠
RuleId	integer	ルール ID。	315716429631488
RelatedPrice	object
MarketplaceImagePrice	object
Currency	string		CNY
OriginalPrice	number		100
DiscountPrice	number		0
TradePrice	number		100

例

成功レスポンス

JSONJSON

{
  "RequestId": "A3DC3196-379B-4F32-A2C5-B937134FAD8A",
  "PriceInfo": {
    "Rules": {
      "Rule": [
        {
          "Description": "升级优惠",
          "RuleId": 1234567890
        }
      ]
    },
    "Price": {
      "OriginalPrice": 175.2,
      "DiscountPrice": 61.32,
      "Currency": "CNY",
      "TradePrice": 113.88,
      "DetailInfos": {
        "DetailInfo": [
          {
            "Resource": "instanceType",
            "OriginalPrice": 4368,
            "DiscountPrice": 655.2,
            "TradePrice": 3712.8,
            "SubRules": {
              "Rule": [
                {
                  "Description": "买满1年，立享官网价格8.5折优惠",
                  "RuleId": 315716429631488
                }
              ]
            }
          }
        ]
      }
    },
    "RelatedPrice": {
      "MarketplaceImagePrice": {
        "Currency": "CNY",
        "OriginalPrice": 100,
        "DiscountPrice": 0,
        "TradePrice": 100
      }
    }
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	MissingParameter.InstanceTypeOrDataDisk	You must specify the parameter InstanceType or DataDisk.
400	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter "SystemDisk.Category" is not valid.
400	InvalidDiskCategory.Missing	The DataDisk.1.Category parameter that is mandatory for processing the request is not provided.
400	InvalidDataDiskCategory.ValueNotSupported	The specified parameter "DataDisk.n.Category" is not valid.
400	InvalidDiskCategory.ValueNotSupported	The specified parameter "DiskCategory" is not valid.
400	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size beyond the permitted range.
400	InvalidPerformanceLevel.Malformed	The specified parameter DataDisk.n.PerformanceLevel is not valid.
400	InvalidDiskSize.TooSmall	Specified disk size is too small when choose PL0 of cloud_essd.
400	OperationDenied.PerformanceLevelNotMatch	The specified DataDisk.n.PerformanceLevel and DataDisk.n.Size do not match.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.
400	PriceNotFound	The price of your queried resource is not available now, please try other resources.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.
403	ChargeTypeViolation	PostPaid instance do not support this operation.
403	InvalidInstanceType.NotSupportUpgrade	The specified InstanceType can only be downgraded. This API supports querying prices only of InstanceType that can be upgraded.
403	InstanceExpired	The PrePaid instance has been expired.
403	Throttling.User	Request was denied due to user flow control.
403	Throttling	Request was denied due to request throttling.
403	InstanceType.Offline	The specified InstanceType has been offline
403	RegionUnauthorized	There is no authority to create instance in the specified region.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.

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

変更履歴

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