ECS リソースの最新料金を表示します。
説明
このアクションを呼び出す前に、チケットを送信 して権限を付与する必要があります。 そうしないと、InvalidAction エラーが発生する場合があります。
さまざまなタイプのリソースの料金を照会する場合、必要なパラメーターも異なります。
- ResourceType パラメーターがインスタンスに設定されている場合、InstanceType パラメーターを指定する必要があります。
- ResourceType パラメーターがディスクに設定されている場合、[DataDisk 1.Category] と [DataDisk. 1. Size] パラメーターを指定する必要があります。 ディスクの料金を照会する場合、PriceUnit パラメーターは時間のみに設定でき、システムはディスクの従量課金 料金のみ返します。
- 帯域幅の料金を照会する場合、システムは帯域幅の 従量課金料金のみ返します。
デバッグ
API Explorer を使用してデバッグを実行できます。 API Explorer を使用することで、さまざまな操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK サンプルコードの動的生成を行うことができます。
リクエストパラメーター
| パラメーター名 | データ型 | 必須/任意 | 例 | 説明 |
|---|---|---|---|---|
| RegionId | String | 必須 | cn-hangzhou |
リージョンの ID です。 DescribeRegions を呼び出して、Alibaba Cloud の最新のリージョンを表示できます。 |
| Action | String | 任意 | DescribePrice |
実行する操作。 値を DescribePrice に設定します。 |
| Amount | Integer | 任意 | 1 |
購入する ECS インスタンスの数。 特定の仕様で複数のインスタンスの料金を照会する場合、このパラメーターを指定できます。 有効な値: 1~1000。 デフォルト値：1。 |
| DataDisk.N.Category | String | 任意 | cloud_ssd |
データディスク N のカテゴリ。N の有効範囲は 1〜5 です。 有効な値：
|
| DataDisk.N.Size | Integer | 任意 | 2000 |
データディスクのサイズ。N の有効範囲は 1〜5 です。 単位: GiB。 有効な値：
|
| ImageId | String | 任意 | centos_7_05_64_20G_alibase_20181212.vhd |
インスタンスの作成に使用されるイメージの ID。 DescribeImages を呼び出して、利用可能なイメージを表示できます。 パラメーターを指定しない場合、システムはデフォルトで Linux イメージの料金を照会します。 |
| InstanceNetworkType | String | 任意 | vpc |
インスタンスのネットワークタイプ。 有効な値：
デフォルト値: vpc。 |
| InstanceType | String | 任意 | ecs.n1.tiny |
インスタンスタイプ。 詳細については、「 インスタンスタイプファミリ 」をご参照ください。あるいは、DescribeInstanceTypes を呼び出して、最新のインスタンスタイプを照会してください。 |
| InternetChargeType | String | 任意 | PayByTraffic |
ネットワーク帯域幅の課金方法。 有効な値：
デフォルト値: PayByTraffic。 |
| InternetMaxBandwidthOut | Integer | 任意 | 5 |
パブリックネットワークの送信帯域幅の最大値。 単位: Mbit/秒。有効な値：0〜100 。 デフォルト値：0 |
| IoOptimized | String | 任意 | none |
インスタンスが I/O 最適化されているかどうかを示します。 有効な値:
InstanceType パラメーターの値が第 1 世代タイプ を示す場合、インスタンスはデフォルトで非 I/O 最適化に設定されます。 InstanceType パラメーターの値が第 1 世代タイプを示さない場合、インスタンスはデフォルトで I/O 最適化に設定されます。 |
| Period | Integer | 任意 | 1 |
ECS インスタンスの課金期間。 有効な値：
デフォルト値: 1。 |
| PriceUnit | String | 任意 | Year |
ECS インスタンスの使用の料金設定単位。 有効な値：
|
| ResourceType | String | 任意 | instance |
リソースの タイプ 。 有効な値：
デフォルト値: instance。 |
| SystemDisk.Category | String | 任意 | cloud_ssd |
システムディスクのカテゴリ。 InstanceType パラメーターがフェーズアウトインスタンスタイプのいずれかに設定され、IoOptimized パラメーターが none に設定されている場合、デフォルト値は cloud です。 それ以外の場合、デフォルト値は cloud_efficiency です。 有効な値：
|
| SystemDisk.Size | Integer | 任意 | 80 |
システムディスクのサイズ。 単位: GiB 有効値: 20~500。 このパラメーターの値は、少なくとも 20 GiB、または ImageSize の値以上でなければなりません。 デフォルト値：Max {40, 指定したイメージのサイズ}。 |
レスポンスパラメーター
| パラメーター名 | データ型 | 例 | 説明 |
|---|---|---|---|
| PriceInfo |
料金と割引を含む PriceInfoType データの配列。 |
||
| └Price |
料金。 |
||
| └Currency | String | CNY |
通貨単位。 |
| └DetailInfos |
料金情報の詳細。 |
||
| └DiscountPrice | Float | 655.2 |
割引。 |
| └OriginalPrice | Float | 4368 |
旧価格。 |
| └Resource | String | instance |
リソースの名前。 |
| └SubRules |
料金設定ルールのサブセット。 |
||
| └Description | String | 1 年間のサブスクリプションで 15％ 割引 |
ルールサブセットの説明。 |
| └RuleId | Long | 587 |
ルールの ID 。 |
| └TradePrice | Float | 3712.8 |
取引価格。 |
| └DiscountPrice | Float | 655.2 |
割引。 |
| └OriginalPrice | Float | 4368 |
旧価格。 |
| └TradePrice | Float | 3712.8 |
取引価格。旧価格から割引を差し引いたもの。 |
| └Rules |
プロモーションルール。 |
||
| └Description | String | 1 年間のサブスクリプションで 15 ％割引 |
プロモーションルールの説明。 |
| └RuleId | Long | 587 |
プロモーションルールの ID。 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエストの ID 。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribePrice
&RegionId=cn-hangzhou
&InstanceType=ecs.n1.tiny
&<Common request parameters>通常のレスポンス例
XML 形式
<DescribePriceResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
<PriceInfo>
<Price>
<Currency> CNY </Currency>
<DiscountPrice>655.2</DiscountPrice>
<OriginalPrice>4368</OriginalPrice>
<TradePrice>3712.8</TradePrice>
</Price>
<Rules>
<Rule>
<Description> Get 15% discount on 1-year subscription</Description>
<RuleId> ONE_YEAR_85_PERCENT </RuleId>
</Rule>
</Rules>
</PriceInfo>
</DescribePriceResponse>JSON 形式
{
"PriceInfo":{
"Price":{
"DiscountPrice":655.2,
"OriginalPrice":4368,
"TradePrice":3712.8,
"Currency":"CNY"
},
"Rules":{
"Rule":[
{
"Description":"Get 15% discount on 1-year subscription",
"Code":"ONE_YEAR_85_PERCENT"
}
]
}
},
"RequestId":"04F0F334-1335-436C-A1D7-6C044FE73368"
}エラーコード
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 400 | InvalidInstanceType.ValueNotSupported | The specified InstanceType does not exist or beyond the permitted range. | 指定されたインスタンスタイプがサポートされていない場合に返されるエラーメッセージ。 |
| 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 | InvalidDataDiskCategory.ValueNotSupported | The specified parameter "DataDisk.n.Category" is not valid. | DataDisk.n.Category パラメーターが無効な場合に返されるエラーメッセージ。 |
| 403 | OperationDenied | The specified Image is disabled or is deleted. | 指定されたイメージが無効化または削除されたときに返されるエラーメッセージ。 |
| 403 | ImageRemovedInMarket | The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed. | Alibaba Cloud Marketplace から指定されたイメージが利用できない場合に返されるエラーメッセージ。 |
| 400 | InvalidDiskCategory.Mismatch | The specified disk categories' combination is not supported. | 指定したディスクカテゴリの組み合わせがサポートされていない場合に返されるエラーメッセージ。 |
| 403 | Forbbiden | User not authorized to operate on the specified resource. | 指定されたリソースへのアクセスが許可されていない場合に返されるエラーメッセージ。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定されたイメージがこのアカウントに存在しない場合に返されるエラーメッセージ。 イメージ ID が正しいかどうかを確認してください。 |
| 403 | InvalidDiskSize.TooSmall | Specified disk size is less than the size of snapshot. | 指定されたディスクの容量がスナップショットの容量より小さい場合に返されるエラーメッセージ。 |
| 403 | OperationDenied | The type of the disk does not support the operation | ディスクタイプが指定された操作をサポートしていない場合に返されるエラーメッセージ。 |
| 404 | InvalidInstanceChargeType.NotFound | The InstanceChargeType does not exist in our records | 指定されたリソースグループが存在しない場合に返されるエラーメッセージ。 |
| 400 | InvalidPeriod | The specified period is not valid. | 指定された期間が無効である場合に返されるエラーメッセージ。 |
| 400 | InvalidDataDiskCategory.ValueNotSupported | The specified parameter " DataDisk.n.Category " is not valid. | 指定されたディスクタイプが無効である場合に返されるエラーメッセージ。 |
| 400 | InvalidSystemDiskCategory.ValueNotSupported | The specified parameter " SystemDisk.Category " is not valid. | 指定されたディスクタイプが無効である場合に返されるエラーメッセージ。 |
| 403 | InvalidDiskCategory.NotSupported | The specified disk category is not support the specified instance type. | 指定されたディスクタイプがインスタンスタイプをサポートしていない場合に返されるエラーメッセージ。 |
| 403 | InvalidDiskCategory.NotSupported | The upgrade operation of instance does not support this category of disk. | インスタンスに接続されているディスクが、インスタンスタイプのアップグレードをサポートしていない場合に返されるエラーメッセージ。 |
| 400 | InstanceDiskCategoryLimitExceed | The specified DataDisk.n.Size beyond the permitted range, or the capacity of snapshot exceeds the size limit of the specified disk category. | 指定されたデータディスクのサイズが上限を超えたときに返されるエラーメッセージ。 |
| 404 | InvalidSystemDiskSize.LessThanImageSize | The specified parameter SystemDisk.Size is less than the image size. | 指定したシステムディスクのサイズがイメージサイズより小さい場合に返されるエラーメッセージ。 |
| 403 | InvalidParameter.ResourceOwnerAccount | ResourceOwnerAccount is Invalid. | 指定された ResourceOwnerAccount パラメーターが無効の場合に返されるエラーメッセージ。 |
| 403 | RegionUnauthorized | There is no authority to create instance in the specified region. | 指定されたリージョンでインスタンスを作成する権限がない場合に返されるエラーメッセージ。 |
| 404 | InvalidSystemDiskSize.ValueNotSupported | The specified parameter SystemDisk.Size is invalid. | SystemDisk.Size パラメーターの指定値が無効な場合に返されるエラーメッセージ。 |
| 400 | InstanceDiskNumber.LimitExceed | The total number of specified disk in an instance exceeds. | インスタンスに接続されているディスクの数が上限を超えたときに返されるエラーメッセージ。 |
| 400 | InvalidDiskCategory.ValueNotSupported | The specified parameter "DiskCategory" is not valid. | 指定された DiskCategory パラメーターが無効の場合に返されるエラーメッセージ。 |
| 403 | OperationDenied | The resource is out of usage. | インスタンスが実行状態にない場合に返されるエラーメッセージ。 Start the instance. |
| 400 | InvalidInternetMaxBandwidthOut.ValueNotSupported | %s | InternetMaxBandwidthOut パラメーターの設定が無効な場合に返されるエラーメッセージ。 |
| 400 | InvalidDataDiskCategory.ValueNotSupported | %s | パラメーターがサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidSystemDiskCategory.ValueNotSupported | %s | パラメーターがサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidParameter.Conflict | %s | パラメーターが別のパラメーターと競合する場合に返されるエラーメッセージ。 |
| 400 | InvalidInternetChargeType.ValueNotSupported | %s | パラメーターがサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidInstanceType.ValueNotSupported | %s | インスタンスタイプが正しくない場合に返されるエラーメッセージ。 |
| 403 | InstanceType.Offline | %s | インスタンスタイプが利用できない場合に返されるエラーメッセージ。 |
| 500 | InternalError | %s | 不明な内部エラーが発生したときに返されるエラーメッセージ。 |
| 400 | InvalidSystemDiskSize.ValueNotSupported | %s | パラメーターがサポートされていない場合に返されるエラーメッセージ。 |
| 400 | InvalidDataDiskSize.ValueNotSupported | %s | パラメーターがサポートされていない場合に返されるエラーメッセージ。 |
| 400 | PriceNotFound | The price of your queried resource is not available now, please try other resources. | リソースの料金を照会できない場合に返されるエラーメッセージ。 後でもう一度やり直してください。 |
| 400 | InvalidResourceType.ValueNotSupported | The specified parameter ResourceType is not valid. | 指定されたリソースタイプが無効である場合に返されるエラーメッセージ。 |
| 400 | InvalidPriceUnit.ValueNotSupported | The specified parameter PriceUnit is not valid. | 指定された料金単位が無効である場合に返されるエラーメッセージ。 |
| 403 | OperationDenied | The specified parameter InstanceNetworkType is not authorized. | 指定されたインスタンスネットワークタイプが許可されていない場合に返されるエラーメッセージ。 |
| 403 | InvalidAmount.Malformed | The specified parameter Amount is not valid. | Amount パラメーターの形式が無効の場合に返されるエラーメッセージ。 |
| 400 | EncryptedOption.Conflict | %s | パラメーターが暗号化されたディスクをサポートしていない場合に返されるエラーメッセージ。 |
| 404 | Invalid.InstanceId.NotFound | The Instance provided does not exist. | 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。 |
| 403 | InvalidDiskSize.TooSmall | Specified system disk size is less than the size of image | システムディスクのサイズがイメージのサイズより小さい場合に返されるエラーメッセージ。 |
| 404 | InvalidMarketImage.NotFound | The specified marketplace image does not exist, please change the imageId and try again. | 指定されたイメージが Alibaba Cloud Marketplace に存在しない場合に返されるエラーメッセージ。 |
| 400 | IncorrectImageStatus | The specified marketplace image is not available. | Alibaba Cloud Marketplace から指定されたイメージが利用できない場合に返されるエラーメッセージ。 |
| 403 | InvalidChargeType.MarketImage | The specified chargeType of marketplace image is invalid | Alibaba Cloud Marketplace からのイメージの課金方法がサポートされていない場合に返されるエラーメッセージ。 |
| 403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | クラウドディスクタイプがサポートされていない場合に返されるエラーメッセージ。 |