華為云計(jì)算 云知識 創(chuàng)建虛擬接口對等體CreateVifPeer
創(chuàng)建虛擬接口對等體CreateVifPeer

 

接口說明

每個虛擬接口可支持兩個對等體,IPv4和IPv6對等體,在創(chuàng)建虛擬接口時默認(rèn)創(chuàng)建IPv4對等體, 本接口一般用于增加ipv6對等體。創(chuàng)建虛擬接口對接體之后,可以通過虛擬接口查詢配置結(jié)果 本接口只在支持Ipv6的區(qū)域開放,如需要使用請聯(lián)系客服

URL
POST  https://dcaas.cn-north-4.myhuaweicloud.com/v3/{project_id}/dcaas/vif-peers 
請求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token。 獲取Token ,請參考《 統(tǒng)一身份認(rèn)證 服務(wù)API參考》的“獲取用戶Token”章節(jié)。請求響應(yīng)成功后在響應(yīng)消息頭中包含的“X-Subject-Token”的值即為Token值。

project_id
 
string path

租戶項(xiàng)目ID

Body參數(shù)
名稱 類型 必選 描述
vif_peer
 
CreateVifPeer object

創(chuàng)建虛擬接口對等體參數(shù)

參數(shù):
vif_peer
名稱 類型 必選 描述
name
 
string

VIF對等體名字

description
 
string

VIF對等體名字描述信息

address_family
 
string

接口的地址簇類型,ipv4,ipv6

local_gateway_ip
 
string

VIF對等體云側(cè)接口地址

remote_gateway_ip
 
string

VIF對等體客戶側(cè)接口地址

route_mode
 
string

路由模式:static/bgp

bgp_asn
 
integer

BGP鄰居的AS號

bgp_md5
 
string

BGP鄰居的MD5密碼

remote_ep_group
 
Array of strings

遠(yuǎn)端子網(wǎng)列表,記錄租戶側(cè)的cidrs

vif_id
 
string

vif對等體對應(yīng)的虛擬接口ID

返回參數(shù)
返回碼: 201

CREATED

名稱 類型 必選 描述
vif_peer
 
VifPeer object

虛擬接口對等體對象

201 vif_peer
名稱 類型 必選 描述
id
 
string

資源ID

tenant_id
 
string

歸屬租戶ID

name
 
string

VIF對等體名字

description
 
string

VIF對等體名字描述信息

address_family
 
string

接口的地址簇類型,ipv4,ipv6

local_gateway_ip
 
string

VIF對等體云側(cè)接口地址

remote_gateway_ip
 
string

VIF對等體客戶側(cè)接口地址

route_mode
 
string

路由模式:static/bgp

bgp_asn
 
integer

BGP鄰居的AS號

bgp_md5
 
string

BGP鄰居的MD5密碼

remote_ep_group
 
Array of strings

遠(yuǎn)端子網(wǎng)列表,記錄租戶側(cè)的cidrs

service_ep_group
 
Array of strings

該字段用于公網(wǎng)專線接口,表示租戶可以訪問云上公網(wǎng)服務(wù)地址列表

device_id
 
string

歸屬的設(shè)備ID

bgp_route_limit
 
integer

BGP的路由配置規(guī)格

bgp_status
 
string

接口BGP協(xié)議狀態(tài),如果是靜態(tài)路由接口則狀態(tài)為 null

status
 
string

VIF對等體狀態(tài)

vif_id
 
string

vif對等體對應(yīng)的虛擬接口ID

請求示例
示例 1

創(chuàng)建一個虛擬接口對等體,遠(yuǎn)端子網(wǎng)列表為20.1.1.0/24。

 
"POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dcaas/vif-peers/68250543-0a13-4ac7-aa36-d018856ac640"
 
{ "vif_peer": { "name": "vif-0819", "description": "mytest", "remote_ep_group": [ "20.1.1.0/24" ] } }
返回示例
返回碼:201

CREATED

示例 1
 
{
"vif_peer": {
"name": "vif-0819",
"description": "mytest",
"id": "4c95de3e-9f75-4357-9c79-b22498dd71c7",
"tenant_id": "ed28c294165741faaeccab26913122a1",
"address_family": "ipv4",
"local_gateway_ip": "12.3.4.1/30",
"remote_gateway_ip": "12.3.4.2/30",
"route_mode": "static",
"bgp_asn": null,
"bgp_md5": null,
"bgp_route_limit": 100,
"bgp_status": null,
"status": "ACTIVE",
"vif_id": "5d6c17bc-0ebe-420b-8734-21f519e9d7ad",
"remote_ep_group": [
"12.3.4.0/30 172.56.0.0/16"
]
}
}
SDK
點(diǎn)擊  云專線  (DC) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。