功能介紹
虛擬IP地址用于為網(wǎng)卡提供第二個(gè)IP地址，同時(shí)支持與多個(gè)彈性 云服務(wù)器 的網(wǎng)卡綁定，從而實(shí)現(xiàn)多個(gè)彈性云服務(wù)器之間的高可用性。
該接口用于給云服務(wù)器網(wǎng)卡配置虛擬IP地址：
- 當(dāng)指定的IP地址是一個(gè)不存在的虛擬IP地址時(shí)，系統(tǒng)會(huì)創(chuàng)建該虛擬IP，并綁定至對應(yīng)網(wǎng)卡。
- 當(dāng)指定的IP地址是一個(gè)已經(jīng)創(chuàng)建好的虛擬IP時(shí)，系統(tǒng)會(huì)將指定的網(wǎng)卡和虛擬IP綁定。如果該IP的device_owner為空，則僅支持VPC內(nèi)二三層通信；如果該IP的device_owner為neutron:VIP_PORT，則支持VPC內(nèi)二三層通信、VPC之間對等連接訪問，以及 彈性公網(wǎng)IP 、VPN、 云專線 等Internet接入。
了解更多請參考虛擬IP簡介。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /v1/{project_id}/cloudservers/nics/{nic_id}
參數(shù)說明請參見表1。
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請參見獲取項(xiàng)目ID。 |
|
nic_id |
是 |
云服務(wù)器網(wǎng)卡ID。 |
請求消息
請求參數(shù)如表2所示。
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
subnet_id |
是 |
String |
云服務(wù)器添加網(wǎng)卡的信息。 需要指定云服務(wù)器所屬 虛擬私有云 下已創(chuàng)建的網(wǎng)絡(luò)（network）的ID，UUID格式。 |
|
ip_address |
是 |
String |
網(wǎng)卡即將配置的虛擬IP的地址。 |
|
reverse_binding |
否 |
Boolean |
虛擬IP的allowed_address_pairs屬性是否添加網(wǎng)卡的IP/Mac對。 說明：
添加IP/Mac對后才能在網(wǎng)卡詳情頁面正常展示虛擬IP的地址。 |
響應(yīng)消息
請求示例
PUT https://{endpoint}/v1/{project_id}/cloudservers/nics/{nic_id}
{
"nic": {
"subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
"ip_address": "192.168.0.7",
"reverse_binding": true
}
}
響應(yīng)示例
{
"port_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23"
}
返回值
請參考通用請求返回值。
錯(cuò)誤碼
請參考錯(cuò)誤碼。
猜你喜歡
