调用CreateBgpPeer接口向指定的BGP组中添加BGP邻居-阿里云帮助中心

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateBgpPeer	系统规定参数。取值：CreateBgpPeer。
RegionId	String	是	cn-shanghai	BGP组所在的地域ID。您可以通过调用DescribeRegions接口获取地域ID。
BgpGroupId	String	是	bgpg-wz9f62v4fbg****	BGP组的ID。
PeerIpAddress	String	否	116.62.XX.XX	BGP邻居的IP地址。
EnableBfd	Boolean	否	true	是否开启BFD功能，取值： true：开启BFD功能。 false：不开启BFD功能。
ClientToken	String	否	123e4567-e89b-12d3-a456-426655440000	客户端Token，用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。说明若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。
IpVersion	String	否	ipv4	IP版本。取值： IPv4（默认值）：IPv4版本。 IPv6：IPv6版本，只有当创建BGP组的VBR开通IPv6功能时，支持IPv6版本。
BfdMultiHop	Integer	否	3	BFD跳数。取值范围：1~255。选择开启BFD功能时，需要配置此参数。输入BFD跳数，即数据从源端到目标端传输时经过的最大设备数量。您可以根据真实的物理链路因素配置不同的跳数。

返回数据


名称	类型	示例值	描述
BgpPeerId	String	bgp-m5eoyp2mwegk8ce9v****	BGP邻居的ID。
RequestId	String	D4B7649A-61BB-4C64-A586-1DFF1EDA6A42	请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateBgpPeer
&RegionId=cn-shanghai
&BgpGroupId=bgpg-wz9f62v4fbg****
&PeerIpAddress=116.62.XX.XX
&EnableBfd=true
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&IpVersion=ipv4
&BfdMultiHop=3
&公共请求参数

正常返回示例

XML格式

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

<CreateBgpPeerResponse>
    <BgpPeerId>bgp-m5eoyp2mwegk8ce9v****</BgpPeerId>
    <RequestId>D4B7649A-61BB-4C64-A586-1DFF1EDA6A42</RequestId>
</CreateBgpPeerResponse>

JSON格式

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

{
  "BgpPeerId" : "bgp-m5eoyp2mwegk8ce9v****",
  "RequestId" : "D4B7649A-61BB-4C64-A586-1DFF1EDA6A42"
}

错误码


HttpCode	错误码	错误信息	描述
400	QuotaExceeded.Bgp	bgp peer count per vbr quota exceed.	边界路由器的BGP组的数量已达到配额。
400	QuotaExceeded.Bgp	bgp group 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.NotNull	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	UnsupportedFeature.Vpconn	The feature of Vpconn is not supported.	不支持Vpconn类型。
400	DuplicatedParam.PeerIpAddress	The param of PeerIpAddress is duplicated.	BGP邻居IP地址重复。
400	DuplicatedParam.LocalIpAddress	The LocalIpAddress already exists.	本端IP地址参数有重复，请更换本端IP后重试。
400	DuplicatedParam.PeerIpv6Address	The PeerIpv6Address already exists.	对端IP地址参数有重复，请更换对端IP后重试。
400	DuplicatedParam.LocalIpv6Address	The LocalIpv6Address already exists.	本端IP地址参数有重复，请更换本端IP后重试。
400	IllegalParam.LocalGatewayIpAndMask	The LocalGatewayIpAndMask value is invalid.	本端网关IP和掩码非法，请更正后重试。
400	IllegalParam.PeeringIpv6SubnetMask	The PeeringIpv6SubnetMask value is invalid.	掩码非法，请更正后重试。
404	InvalidRegionId.NotFound	Specified value of "regionId" is not supported.	指定的 RegionId 不存在，请您检查此产品在该地域是否可用。

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