调用SetCenInterRegionBandwidthLimit接口设置、修改或删除基础版转发路由器带宽包中两个地域间的跨地域互通带宽。
接口说明
此接口仅支持设置基础版转发路由器带宽包中两个地域间的跨地域互通带宽。
前提条件
目标云企业网实例已经绑定了带宽包实例。具体操作，请参见 CreateCenBandwidthPackage 和 AssociateCenBandwidthPackage 。
您可以调用 SetCenInterRegionBandwidthLimit 接口设置、修改或删除跨地域互通带宽：
- BandwidthLimit 不为 0 ，表示设置或修改跨地域互通带宽。
- BandwidthLimit 为 0 ，表示删除跨地域互通带宽。
使用限制
-
跨地域互通带宽的最大值不能超过其所属的带宽包实例的带宽峰值。
-
一个带宽包实例下的所有跨地域互通带宽之和不能超过该带宽包实例的带宽峰值。
-
如果跨地域连接开启了带宽复用功能，则不支持修改跨地域互通带宽。
-
SetCenInterRegionBandwidthLimit 接口仅支持为基础版转发路由器设置、修改或删除跨地域互通带宽。
如果您需要为企业版转发路由器设置、修改或删除跨地域互通带宽，请参见 CreateTransitRouterPeerAttachment 、 UpdateTransitRouterPeerAttachmentAttribute 和 DeleteTransitRouterPeerAttachment 。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| cen:SetCenInterRegionBandwidthLimit | update | *CenInstance acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| CenId | string | 是 | 云企业网实例 ID。 | cen-7qthudw0ll6jmx**** |
| LocalRegionId | string | 是 | 本端地域 ID。 您可以调用 DescribeChildInstanceRegions 接口获取云企业网支持加载的网络实例的地域信息。 | cn-hangzhou |
| OppositeRegionId | string | 是 | 对端地域 ID。 | us-west-1 |
| BandwidthLimit | long | 是 | 两个地域之间的跨地域互通带宽。单位：Mbps。 | 8 |
| BandwidthType | string | 否 | 带宽的分配方式。取值：
| 默认为BandwidthPackage |
返回参数
示例
正常返回示例
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 | InvalidParameter | Invalid parameter. | 参数不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 账号无权限操作。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-12-04 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-08-16 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-05-17 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2023-09-08 | OpenAPI 错误码发生变更 | 查看变更详情 |