调用ModifyBgpGroupAttribute接口修改BGP组的配置。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ModifyBgpGroupAttribute

系统规定参数。取值：ModifyBgpGroupAttribute。
RegionId String 是 cn-shanghai

BGP组所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

BgpGroupId String 是 bgpg-wz9f62v4fbg2g****

指定BGP组的ID。
Name String 否 test

BGP组的名称。

长度为2～128个字符，必须以大小写字母或中文开头，可包含数字，半角句号（.），下划线（_）和短划线（-），但不能以http:// 或https://开头。

Description String 否 BGP

BGP组的描述信息。

长度为2～256个字符，必须以大小写字母或中文开头，但不能以http:// 或https://开头。

LocalAsn Long 否 45104

自定义阿里云侧BGP AS号。取值：

  • 45104
  • 64512~65534
  • 4200000000~4294967294
说明 其中65025为阿里云保留值，阿里侧默认使用45104作为LocalAsn，使用自定义LocalAsn功能在多线接入场景时可能存在BGP路由环路风险，请合理评估后使用。
PeerAsn Long 否 1****

本地侧设备的AS号。
AuthKey String 否 !PWZ2****

BGP组的认证密钥。
IsFakeAsn Boolean 否 false

是否指定伪AS号。取值;

  • false（默认值）：否。
  • true：是。
说明 运行BGP的路由器一般只能属于一个AS。当需要用新的AS替代原有的AS（例如AS需要迁移或者和其他AS合并），并且因为业务等客观因素无法立即修改BGP配置时，可以通过指定伪AS号与本端建立连接，保证业务不中断。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。
RouteQuota Integer 否 110

BGP邻居的路由条目上限。单位：条，默认值：110。
ClearAuthKey Boolean 否 false

是否需要清空密钥。取值：

  • true：是。
  • false（默认值）：否。

返回数据

名称 类型 示例值 描述
RequestId String 8C3C6D7C-A1CE-4FD8-BC57-DC493A55F76F

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyBgpGroupAttribute
&RegionId=cn-shanghai
&BgpGroupId=bgpg-wz9f62v4fbg2g****
&Name=test
&Description=BGP
&LocalAsn=45104
&AuthKey=!PWZ2****
&IsFakeAsn=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RouteQuota=110
&ClearAuthKey=false
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyBgpGroupAttributeResponse>
    <RequestId>8C3C6D7C-A1CE-4FD8-BC57-DC493A55F76F</RequestId>
</ModifyBgpGroupAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "8C3C6D7C-A1CE-4FD8-BC57-DC493A55F76F"
}

错误码

HttpCode 错误码 错误信息 描述
400 QuotaExceeded.Bgp bgp peer count per vbr quota exceed. 边界路由器的BGP组的数量已达到配额。
400 QuotaExceeded.Nqa nqa count per vbr quota exceed. NQA数超过VBR配额。
400 QuotaExceeded.BgpNetwork bgp network count per vbr quota exceed. 边界路由器的BGP网络数量已达到配额。
400 InvalidPeerIpAddress multi pconn peer ip can not be null. 多物理专线的IP地址不能为空。
400 InvalidVbrNetwork vbr netowrk not exists 该边界路由器不存在，请您检查输入的边界路由器是否正确。
400 InvalidBgpGroup bgp group not exists 该BGP组不存在。
400 InvalidBgpName.Malformed Specified Bgp Group name is not valid. 该BGP组的名称不合法。
400 InvalidBgpDiscription.Malformed Specified Bgp Group description is not valid. 该BGP组的描述不合法。
400 InvalidBgpAuthkey.Malformed Specified Bgp Group authkey is not valid. 该BGP组的验证密钥不合法。
400 InvalidIP.Malformed Ip malformed. IP格式不合法。
400 InvalidPeerAsn.Malformed invalid peer asn cannot equals aliyun asn:45104 ASN号码不能和阿里云ASN号码一致。
400 InvalidParams.NotFound instance not found 实例不存在。
400 InvalidParams.NotFound vpc instance not found 该VPC不存在，请您检查输入的VPC是否正确。
400 InvalidParams.AlreadyExists bgp network already exists BGP网络已经存在。
400 InvalidStatus.CannotOperate invalid status cannot operate 状态不合法，无法执行该操作。
400 InvalidParams.PeerIpAddressMustPointOut vbr has 0 or more than 1 subif ,point out peerIpAddress. 请指出PeerIpAddress
400 InvalidParams.PeerIpAddressInUse peer ip address in use ,cannot create bgp peer. 对等IP地址正在使用，无法创建bgp对等。
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. 操作失败，因为出方向流量未开通。
400 OperationUnsupport Operation is unsupport, not in vbr support custom local asn white list. 操作不支持
400 OperationFailed.ClearAuthKeyForbidden The specific auth key is not empty. 指定密钥不为空，无法清空密钥。
404 InvalidRegionId.NotFound Specified value of "regionId" is not supported. 指定的 RegionId 不存在，请您检查此产品在该地域是否可用。

访问错误中心查看更多错误码。