更新时间:2024-04-18 GMT+08:00

批量更新带宽

功能介绍

批量更新带宽,共享带宽和包周期带宽该接口不适用。

URI

PUT /v2/{project_id}/batch-bandwidths/modify

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

bandwidths

Array of ModifyBandwidthOption objects

更新带宽列表

表3 ModifyBandwidthOption

参数

是否必选

参数类型

描述

id

String

  • 功能说明:带宽唯一标识

最大长度:36

name

String

取值范围:1-64,支持数字、字母、中文、_(下划线)、-(中划线),为空表示不修改名称 功能说明:带宽名称 约束:name、size必须有一个参数有值

最小长度:1

最大长度:64

size

Integer

取值范围:默认1Mbit/s~2000Mbit/s(具体范围以各区域配置为准,请参见控制台对应页面显示),不带此参数时表示不修改大小 功能说明:带宽大小,单位Mbit/s。 约束:name、size必须有一个参数有值 如果传入的参数为小数(如 10.2)或者字符类型(如“10”),会自动强制转换为整数。 约束:name、size必须要有一个参数有值。 调整带宽时的最小单位会根据带宽范围不同存在差异: 小于等于300Mbit/s:默认最小单位为1Mbit/s。 300Mbit/s~1000Mbit/s:默认最小单位为50Mbit/s。 大于1000Mbit/s:默认最小单位为500Mbit/s。

charge_mode

String

功能说明:按流量计费,按带宽计费还是按增强型95计费。 取值范围:bandwidth,traffic,95peak_plus(按增强型95计费)不返回或者为空时表示是bandwidth。 约束:只有共享带宽支持95peak_plus(按增强型95计费),按增强型95计费时需要指定保底百分比,默认是20%。

枚举值:

  • bandwidth
  • traffic
  • 95peak_plus

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

success_resources

Array of SuccessResources objects

成功资源

failure_resources

Array of FailureResources objects

失败资源

表5 SuccessResources

参数

参数类型

描述

id

String

  • 功能说明:更新成功的带宽id

最小长度:1

最大长度:36

表6 FailureResources

参数

参数类型

描述

id

String

  • 功能说明:更新失败的带宽id

最小长度:1

最大长度:36

code

String

  • 功能说明:错误码

最小长度:1

最大长度:36

message

String

  • 功能说明:错误信息

最小长度:1

最大长度:256

请求示例

批量更新带宽

{
  "bandwidths" : [ {
    "id" : "837d84a0-b940-4401-9477-4a99de1979a7",
    "name" : "bandwidth123",
    "size" : 5
  }, {
    "id" : "f2549bed-c419-4f58-9609-7ade104772bb",
    "name" : "bandwidth123",
    "size" : 5
  } ]
}

响应示例

状态码: 200

GET和PUT操作正常返回

{
  "success_resources" : [ {
    "id" : "837d84a0-b940-4401-9477-4a99de1979a7"
  } ],
  "failure_resources" : [ {
    "id" : "f2549bed-c419-4f58-9609-7ade104772bb",
    "code" : "VPC.0319",
    "message" : "updateBandwidth bandwidth failed. the bandwidth is share bandwidth."
  } ]
}

状态码

状态码

描述

200

GET和PUT操作正常返回

错误码

请参见错误码