调用SetCenInterRegionBandwidthLimit接口设置、修改或删除基础版转发路由器带宽包中两个地域间的跨地域互通带宽。
接口说明
此接口仅支持设置基础版转发路由器带宽包中两个地域间的跨地域互通带宽。
前提条件
目标云企业网实例已经绑定了带宽包实例。具体操作,请参见 CreateCenBandwidthPackage 和 AssociateCenBandwidthPackage 。
您可以调用 SetCenInterRegionBandwidthLimit 接口设置、修改或删除跨地域互通带宽:
- BandwidthLimit 不为 0 ,表示设置或修改跨地域互通带宽。 
- BandwidthLimit 为 0 ,表示删除跨地域互通带宽。 
使用限制
- 
跨地域互通带宽的最大值不能超过其所属的带宽包实例的带宽峰值。 
- 
一个带宽包实例下的所有跨地域互通带宽之和不能超过该带宽包实例的带宽峰值。 
- 
如果跨地域连接开启了带宽复用功能,则不支持修改跨地域互通带宽。 
- 
SetCenInterRegionBandwidthLimit 接口仅支持为基础版转发路由器设置、修改或删除跨地域互通带宽。 如果您需要为企业版转发路由器设置、修改或删除跨地域互通带宽,请参见 CreateTransitRouterPeerAttachment 、 UpdateTransitRouterPeerAttachmentAttribute 和 DeleteTransitRouterPeerAttachment 。 
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
 调试
        
            调试
        
    
授权信息
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 | 
| cen:SetCenInterRegionBandwidthLimit | update | *CenInstance 
 | 无 | 无 | 
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 | 
| CenId | string | 是 | 云企业网实例 ID。 | cen-7qthudw0ll6jmx**** | 
| LocalRegionId | string | 是 | 本端地域 ID。 您可以调用 DescribeChildInstanceRegions 接口获取云企业网支持加载的网络实例的地域信息。 | cn-hangzhou | 
| OppositeRegionId | string | 是 | 对端地域 ID。 | us-west-1 | 
| BandwidthLimit | integer | 是 | 两个地域之间的跨地域互通带宽。单位:Mbps。 | 8 | 
| BandwidthType | string | 否 | 带宽的分配方式。取值: 
 | BandwidthPackage | 
返回参数
| 名称 | 类型 | 描述 | 示例值 | 
| object | |||
| RequestId | string | 请求 ID。 | 530BC816-F575-412A-AAB2-435125D26328 | 
示例
正常返回示例
JSON格式
{
  "RequestId": "530BC816-F575-412A-AAB2-435125D26328"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 | 
|---|---|---|---|
| 400 | MissingParam.CbnBandwidthPackageId | There are more than one suitable cen bandwidth package | 缺少参数CbnBandwidthPackageId。 | 
| 400 | AttrMismatching.CbnBandwidthPackageId | %s | |
| 400 | OperationFailed.InvalidOperation | The operation is failed because the operation is not support. | |
| 400 | OperationUnsupported.Attachment | The cross region connection contains an existing bandwidth. The operation is not supported. | 跨地域连接存在带宽复用,不支持此操作。 | 
| 400 | InvalidOperation.UnsupportChargeType | The charge type is not supported by this operation. | 当前付费类型不支持该操作。 | 
| 400 | OperationUnsupported.TrafficQosPolicyExist | Operation unsupported because traffic qos policy exists. | qos策略存在,不支持该操作。 | 
| 400 | OperationUnsupported.BandwidthType | The specified BandwidthType does not support the operation. | 当前BandwidthType不支持该操作。 | 
| 400 | IllegalParam.BandwidthType | BandwidthType is illegal. | 带宽包类型不合法。 | 
| 400 | IllegalParam.Bandwidth | Bandwidth is illegal. | 带宽包ID不合法。 | 
| 400 | ParamExclusive.BandwidthTypeAndCenBandwidthPackageId | DataTransfer and CenBandwidthPackageId is mutually exclusive. | 带宽分配方式为CDT时,不支持设置CenBandwidthPackageId字段。 | 
| 400 | IdentityRegistrationStatusNotSupport | Real name registration of enterprises required. | 需要完成企业实名登记 | 
| 400 | IllegalParam.BandwidthLessThanQosPolicyBandwidth | The input bandwidth value is less than the sum of the Qos policy bandwidth. | 输入的带宽值小于QoS按带宽分配的限速值总和。 | 
| 400 | OperationUnsupported.RegionId | The specified RegionId does not support the operation. | 当前地域不支持该操作。 | 
| 400 | QuotaExceeded.Bandwidth | Bandwidth quota exceeded. | 带宽值超出配额限制。 | 
| 400 | InvalidParameter | Invalid parameter. | 参数不合法。 | 
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 账号无权限操作。 | 
| 400 | IncorrectStatus.TransitRouter | The resource is not in a valid state for the operation. | 当前TR的状态不支持该操作,请稍后重试。 | 
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。