DescribeBandwidthLimitation查询实例规格的公网带宽上限-云服务器 ECS-阿里云-云服务器 ECS(ECS)-阿里云帮助中心

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DescribeBandwidthLimitation

get

*Instance

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

无

请求参数

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

返回参数

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

示例

正常返回示例

JSON格式

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

错误码

HTTP status code	错误码	错误信息	描述
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	指定的参数 InstanceChargeType 无效。
400	InvalidParam	The input parameter DestinationResource that is mandatory for processing this request is not supplied.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType beyond the permitted range.	指定的实例规格不合法（超出可选范围）。
400	InvalidInstanceId.NotFound	The specified ecs instance not found.
404	Invalid.ResourceType.NotFound	The ResourceType provided does not exist in our records.
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 无效。
404	Invalid.OperationType	The specified OperationType is not valid.	指定的参数OperationType无效。

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

变更历史

更多信息，参考变更详情。