阿里云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 of Bandwidth		公网带宽上限信息组成的集合。
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.	指定的实例规格不合法（超出可选范围）。