全部产品
Search
文档中心

云服务器 ECS:DescribeBandwidthLimitation - 查询不同实例规格公网带宽上限

更新时间:Mar 19, 2024

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:DescribeBandwidthLimitationRead
  • Instance
    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
  • ecs:tag

请求参数

名称类型必填描述示例值
RegionIdstring

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

cn-hangzhou
InstanceChargeTypestring

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

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

默认值:PostPaid。

PostPaid
SpotStrategystring

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

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

默认值:NoSpot。

说明 当参数 InstanceChargeType 取值为 PostPaid 时,参数 SpotStrategy 才有效。
NoSpot
InstanceTypestring

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

ecs.g5.large
ResourceIdstring

资源 ID。

说明 当您将参数 OperationType 设置为 Upgrade 或者 Downgrade 时,参数 ResourceId 为必选参数。
i-bp67acfmxazb4ph***
OperationTypestring

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

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

默认值:Create。

Upgrade

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
Bandwidthsobject []

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

InternetChargeTypestring

公网带宽的计费方式。可能值:

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

公网带宽最大值。

100
Mininteger

公网带宽最小值。

0
Unitstring

公网带宽单位。

Mbps

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400Invalid.InstanceChargeTypeThe specified InstanceChargeType is not valid.指定的参数 InstanceChargeType 无效。
400InvalidParamThe input parameter DestinationResource that is mandatory for processing this request is not supplied.-
400InvalidInstanceType.ValueNotSupportedThe specified InstanceType beyond the permitted range.指定的实例规格不合法(超出可选范围)。
400InvalidInstanceId.NotFoundThe specified ecs instance not found.-
404Invalid.ResourceType.NotFoundThe ResourceType provided does not exist in our records.-
404Invalid.NetworkCategoryThe specified NetworkCategory is not valid.指定的参数 NetworkCategory 无效。
404Invalid.SpotStrategyThe specified SpotStrategy is not valid.竞价策略参数无效。
404Invalid.IoOptimizedThe specified IoOptimized is not valid.指定的参数 IoOptimized 无效。
404Invalid.ResourceIdThe specified ResourceId is not valid.指定的参数 ResourceId 无效。
404Invalid.InstancePayTypeThe specified InstancePayType is not valid.指定的参数 InstanceChargeType 无效。
404Invalid.OperationTypeThe specified OperationType is not valid.指定的参数 operationType 无效。

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

变更历史

变更时间变更内容概要操作
2023-03-07OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404