DescribeBandwidthLimitation - 云服务器 ECS

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeBandwidthLimitation	系统规定参数。取值：DescribeBandwidthLimitation。
RegionId	String	是	cn-hangzhou	目标地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
InstanceChargeType	String	否	PostPaid	实例的计费方式。更多详情，请参见计费概览。取值范围： PrePaid：包年包月。 PostPaid：按量付费。默认值：PostPaid。
SpotStrategy	String	否	NoSpot	按量付费实例的抢占策略。取值范围： NoSpot：正常按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，最高按量付费价格。默认值：NoSpot。说明当参数InstanceChargeType取值为PostPaid时，参数SpotStrategy才有效。
InstanceType	String	是	ecs.g5.large	实例规格。取值请参见实例规格族。
ResourceId	String	否	i-bp67acfmxazb4ph***	资源ID。说明当您将参数OperationType设置为Upgrade或者Downgrade时，参数ResourceId为必选参数。
OperationType	String	否	Upgrade	查询不同操作方式的公网带宽规格限制。取值范围： Upgrade：升级公网带宽。 Downgrade：降级公网带宽。 Create：新建ECS实例。默认值：Create。

返回数据

名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	请求ID。
Bandwidths	Array of Bandwidth		公网带宽上限信息组成的集合。
Bandwidth
InternetChargeType	String	PayByTraffic	公网带宽的计费方式。可能值： PayByBandwidth：按固定带宽计费。 PayByTraffic：按使用流量计费。
Max	Integer	100	公网带宽最大值。
Min	Integer	0	公网带宽最小值。
Unit	String	Mbps	公网带宽单位。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=DescribeBandwidthLimitation
&RegionId=cn-hangzhou
&InstanceType=ecs.g5.large
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeBandwidthLimitationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <Bandwidths>
        <InternetChargeType>PayByTraffic</InternetChargeType>
        <Max>100</Max>
        <Min>0</Min>
        <Unit>Mbps</Unit>
    </Bandwidths>
</DescribeBandwidthLimitationResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Bandwidths" : [ {
    "InternetChargeType" : "PayByTraffic",
    "Max" : 100,
    "Min" : 0,
    "Unit" : "Mbps"
  } ]
}

错误码

HttpCode	错误码	错误信息	描述
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	指定的参数 InstanceChargeType 无效。
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType beyond the permitted range.	指定的实例规格不合法（超出可选范围）。
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 无效。

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