You need to enable JavaScript to run this app.
导航
云企业网
  • 文档首页
    • /云企业网/API参考/带宽包/ModifyCenBandwidthPackageAttributes
ModifyCenBandwidthPackageAttributes
最近更新时间：2024.10.18 15:45:32首次发布时间：2022.04.28 07:28:31
我的收藏

调用 ModifyCenBandwidthPackageAttributes 接口，修改带宽包的名称、描述和带宽上限。

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

参数名称
类型
是否必选
示例值
描述
ActionString是ModifyCenBandwidthPackageAttributes要执行的操作，取值为ModifyCenBandwidthPackageAttributes。
VersionString是2020-04-01API版本信息，当前版本为2020-04-01。

CenBandwidthPackageId

String

是

cbp-4c2zaavbvh5fx****

带宽包的实例ID。
您可以调用 DescribeCenBandwidthPackages 接口，查询带宽包ID。

CenBandwidthPackageName

String

否

cbp-test

带宽包的名称。

  • 必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：点号 (.) 、下划线 (_) 和中划线 (-) 。
  • 长度限制为1 ~ 128个字符。

Description

String

否

namedesc

带宽包的描述。

  • 必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（ ）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。
  • 长度限制为0 ~ 255个字符。

Bandwidth

Integer

否

100

带宽包的带宽上限。取值范围为2~10000，单位为Mbps。

说明

传入的带宽值应不小于已分配域间带宽的大小。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=ModifyCenBandwidthPackageAttributes&Version=2020-04-01&CenBandwidthPackageId=cbp-4c2zaavbvh5fx****&Bandwidth=100 HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021081115253901022514606****",
        "Action": "ModifyCenBandwidthPackageAttributes",
        "Version": "2020-04-01",
        "Service": "cen",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode
错误码
错误信息
描述
400FailedOperationFailed to obtain CEN bandwidth package billing information.获取带宽包计费信息失败。
400InvalidBandwidthPackage.OrderConflictThe specified Bandwidth package has unpaid order.指定的带宽包存在未支付的订单，请先完成上个订单的支付或等待24h超时。
400InvalidCenBandwidthPackage.BandwidthNotEnoughSpecified bandwidth is not enough for current inter region bandwidths.指定的带宽值无法满足当前域间带宽使用。
400InvalidCenBandwidthPackage.InvalidStatusSpecified CEN bandwidth package is being operated now.指定的带宽包所处状态无法响应该请求，请稍后重试。
400InvalidCenCrossBorderBandwidthPackage.FrozenStatusThe specified request is denied because your account has been frozen for cross-border. Please wait for the Service Provider to unfreeze it.您的账号当前处于跨境封停状态，请等待运营商解封后再进行操作。
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法，请修复描述格式后重试。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法，描述长度不能超过255个字符。
400InvalidName.MalformedThe specified name is malformed.指定的名称格式不合法，请修复名称格式后重试。
400InvalidName.MalformedThe specified name is malformed. Ensure the maximum length of name is 128.指定的名称格式不合法，名称长度不能超过128个字符。
400InvalidWhiteList.AccountNotFoundSpecific account does not exist in white list.指定的账号在白名单中不存在。
400LimitExceeded.BandwidthOfBandwidthPackageSpecified bandwidth exceeds the range of bandwidth package.指定的带宽超出带宽包取值范围。
400OrderErrorFailed to create an order.下单失败。
400UnsupportedOperationThe payment failed due to the account balance is not enough for this order.账户余额不足，订单支付失败。
400UnsupportedOperationThe request on the specified bandwidth package is denied because the bandwidth package is expired.指定带宽包已过期，不支持当前操作。
400UnsupportedOperationThe request on the specified bandwidth package is denied because the bandwidth package is shut down due to arrears.指定带宽包欠费关停，不支持当前操作。
400UnsupportedOperationThe specified request is denied because the type of bandwidth package is POC.指定的带宽包为测试带宽包，暂不支持此操作。
400UnsupportedOperationThe request on the specified instance is denied due to the account in arrears status.因账户处于欠费状态，对于该实例的操作请求被拒绝。
400UnsupportedOperation.BandwidthScaleDownSpecified bandwidth value cannot be less than current value.暂不支持带宽包降配。
404InvalidCenBandwidthPackage.NotFoundThe bandwidth package of the specified geographic regions does not exist.指定的带宽包不存在。
409InvalidCen.InvalidStatusThe specified CEN instance is not in the correct status for the request.指定的云企业网实例所处的状态无法响应该请求，请稍后再试。