调用DescribeBandwidthLimitation查询不同实例规格可以购买、升级或降配的公网带宽上限。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeBandwidthLimitation

系统规定参数。取值:DescribeBandwidthLimitation

RegionId String cn-hangzhou

目标地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

InstanceType String ecs.g5.large

实例规格。取值请参见实例规格族

说明 该参数为必选参数。
InstanceChargeType String PrePaid

实例的计费方式。更多详情,请参见计费概览。取值范围:

  • PrePaid:包年包月
  • PostPaid:按量付费

默认值:PostPaid

SpotStrategy String NoSpot

按量付费实例的抢占策略。取值范围:

  • NoSpot:正常按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,最高按量付费价格。

默认值:NoSpot

说明 当参数InstanceChargeType取值为PostPaid时,参数SpotStrategy才有效。
ResourceId String i-bp67acfmxazb4ph***

资源ID。

说明 当您将参数OperationType设置为Upgrade或者Downgrade时,参数ResourceId为必选参数。
OperationType String Upgrade

查询不同操作方式的公网带宽规格限制。取值范围:

  • Upgrade:升级公网带宽。
  • Downgrade:降级公网带宽。
  • Create:新建ECS实例。

默认值:Create

返回数据

名称 类型 示例值 描述
Bandwidths Array

公网带宽上限信息组成的集合。

Bandwidth
InternetChargeType String PayByTraffic

公网带宽的计费方式。取值范围:

  • PayByBandwidth:按固定带宽计费。
  • PayByTraffic:按使用流量计费。
Max Integer 100

公网带宽最大值。

Min Integer 0

公网带宽最小值。

Unit String Mbps

公网带宽单位。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeBandwidthLimitation
&RegionId=cn-hangzhou
&InstanceType=ecs.g5.large
&<公共请求参数>

正常返回示例

XML 格式

<DescribeBandwidthLimitationResponse>
      <Bandwidths>
            <Bandwidth>
                  <Max>100</Max>
                  <InternetChargeType>PayByBandwidth</InternetChargeType>
                  <Unit>Mbps</Unit>
                  <Min>0</Min>
            </Bandwidth>
            <Bandwidth>
                  <Max>100</Max>
                  <InternetChargeType>PayByTraffic</InternetChargeType>
                  <Unit>Mbps</Unit>
                  <Min>0</Min>
            </Bandwidth>
      </Bandwidths>
      <RequestId>226CB38E-29E3-423E-85DD-DCD1C99832B0</RequestId>
</DescribeBandwidthLimitationResponse>

JSON 格式

{
	"Bandwidths": {
		"Bandwidth": [
			{
				"Max": 100,
				"InternetChargeType": "PayByBandwidth",
				"Unit": "Mbps",
				"Min": 0
			},
			{
				"Max": 100,
				"InternetChargeType": "PayByTraffic",
				"Unit": "Mbps",
				"Min": 0
			}
		]
	},
	"RequestId": "226CB38E-29E3-423E-85DD-DCD1C99832B0"
}

错误码

HttpCode 错误码 错误信息 描述
400 Invalid.InstanceChargeType The specified InstanceChargeType is not valid. 指定的参数“InstanceChargeType”无效。
404 Invalid.NetworkCategory The specified NetworkCategory is not valid. 指定的参数“NetworkCategory”无效。
404 Invalid.SpotStrategy The specified SpotStrategy is not valid. 竞价策略参数无效。
404 Invalid.IoOptimized The specified IoOptimized is not valid. 指定的参数“IoOptimized”无效。
404 Invalid.ResourceId The specified ResourceId is not valid. 指定的参数“ResourceId”无效。
404 Invalid.InstancePayType The specified InstancePayType is not valid. 指定的参数“InstanceChargeType”无效。
400 InvalidInstanceType.ValueNotSupported The specified InstanceType beyond the permitted range. 指定的实例规格不合法(超出可选范围)。

访问错误中心查看更多错误码。