You need to enable JavaScript to run this app.
导航
CreateCenInterRegionBandwidth
最近更新时间:2024.10.18 15:45:55首次发布时间:2022.01.07 11:44:37

调用 CreateCenInterRegionBandwidth 接口,为指定云企业网实例分配域间带宽。

使用说明

加入到同一带宽包中的总域间带宽之和不得超过带宽包上限。

调试

请求参数

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

CenId

String

cen-7qthudw0ll6jmc****

云企业网实例的ID。
您可以调用DescribeCens接口,查询云企业网实例ID。

LocalRegionId

String

cn-beijing

本端地域的ID。
云企业网支持的地域信息请参见区域与地域介绍

CenBandwidthPackageId

String

cbp-bp1o94dp5****

带宽包ID。

  • 您可以调用 DescribeCenBandwidthPackages 接口,获取带宽包ID。

  • 若未指定,系统根据LocalRegionIdPeerRegionId自动匹配满足条件的带宽包

PeerRegionId

String

cn-shanghai

对端地域的ID。
云企业网支持的地域信息请参见区域与地域介绍

BandwidthInteger1000CEN域间带宽的带宽峰值,单位为Mbps。取值不能超过所属带宽包可分配的带宽大小。

返回参数

参数名称
类型
示例值
描述
InterRegionBandwidthIdStringcirb-3tex2x1cwd4c6c0v****CEN域间带宽的ID。

请求示例

GET /?Action=CreateCenInterRegionBandwidth&Version=2020-04-01&CenId=cen-7qthudw0ll6jmc****&LocalRegionId=cn-beijing&PeerRegionId=cn-shanghai&Bandwidth=1000 HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20211222122528010225****",
        "Action": "CreateCenInterRegionBandwidth",
        "Version": "2020-04-01",
        "Service": "cen",
        "Region": "cn-beijing"
    },
    "Result": {
        "InterRegionBandwidthId": "cirb-3tex2x1cwd4c6c0v****"
		}
}

错误码

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

HttpCode
错误码
错误信息
描述
400InvalidCenCrossBorderBandwidthPackage.FrozenStatusThe specified request is denied because your account has been frozen for cross-border. Please wait for the Service Provider to unfreeze it.您的账号当前处于跨境封停状态,请等待运营商解封后再进行操作。
400InvalidInterRegionBandwidth.BandwidthPackageNotFoundNo bandwidth package exists between given regions.指定的互通地域之间未创建带宽包。
400InvalidInterRegionBandwidth.CenMissmatchThe associated cen of specified inter-region bandwidth and bandwidth package are different.指定的域间带宽与带宽包关联的云企业网不一致。
400InvalidInterRegionBandwidth.ConflictThe specified bandwidth between local region and peer region exists.指定的互通地域之间已经存在域间带宽。
400InvalidInterRegionBandwidth.GeographicRegionSetIDMissmatchThe regions of specified inter-region bandwidth do not match the geographic region set ID of the bandwidth package.指定域间带宽的互通地域与带宽包的互通区域不匹配。
400InvalidLocalRegionId.ConflictThe specified LocalRegionId and PeerRegionId are the same.指定的本端地域和对端地域相同。
400InvalidParameterA parameter specified in the request is not valid, is unsupported or cannot be used.该请求传入了非法或不支持的参数。
400LimitExceeded.InterRegionBandwidthThe specified inter-region bandwidth exceeds the range of bandwidth package.指定的域间带宽大小超出带宽包可分配的带宽。
400LimitExceeded.InterRegionBandwidthThe specified inter-region bandwidth exceeds the lower limit.指定的带宽大小超出域间带宽最小限制。
400LimitExceeded.PhysicalLineBandwidthYou’ve reached the bandwidth limit on the number of physical line.已达到物理线路可分配带宽上限。
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.指定带宽包欠费关停,不支持当前操作。
404InvalidCen.NotFoundThe specified CEN does not exist.指定的云企业网实例不存在。
404InvalidCenBandwidthPackage.NotFoundThe bandwidth package of the specified geographic regions does not exist.指定的带宽包不存在。
404InvalidLocalRegionId.NotFoundThe specified LocalRegionId does not exist.指定的本端地域不存在。
404InvalidPeerRegionId.NotFoundThe specified PeerRegionId does not exist.指定的对端地域不存在。
409InvalidCen.InvalidStatusThe specified CEN instance is not in the correct status for the request.指定的云企业网实例所处的状态无法响应该请求,请稍后再试。