Query the specified high-availability virtual IP address
Updated at：2025-10-16
Description
Query the specified highly available virtual IP address.
Request structure
Plain Text
1GET /v{version}/havip/{haVipId} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization stringRequest headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | For API version No., the current value is 1 |
| haVipId | String | Yes | URL parameter | High-availability virtual IP address ID |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| haVipId | String | High-availability virtual IP address ID |
| name | String | High-availability virtual IP address name |
| description | String | High-availability virtual IP address description |
| vpcId | String | VPC ID where the high-availability virtual IP address is located |
| subnetId | String | Subnet ID where the high-availability virtual IP address is located |
| status | String | High-availability virtual IP address status: "available" for available, "bound" for bound to instances |
| privateIpAddress | String | Intranet IP address of the high-availability virtual IP address |
| publicIpAddress | String | Public IP address of the high-availability virtual IP address |
| bindedInstances | List<[HaVipBindedInstance](VPC/API Reference/Appendix.md#HaVipBindedInstance)> | Instance bound to high-availability virtual IP address |
| createdTime | String | Creation time of the high-availability virtual IP address |
Request example
Plain Text
1GET /v1/havip/havip-w2d4kgc3x0y1 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1deResponse example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7e789a40-adac-414a-8bd4-916d6be61112
3Date: Mon, 02 Apr 2019 08:14:25 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6{
7 "haVipId": "havip-jshdu47sk",
8 "name": "test_havip",
9 "description": "",
10 "vpcId": "vpc-r625rqw3wuer",
11 "subnetId": "sbn-i4d47zb73ztx",
12 "status": "available",
13 "privateIpAddress": "192.168.1.221",
14 "publicIpAddress": "180.76.245.166",
15 "createdTime": "2022-08-31T11:42:19Z",
16 "bindedInstances": [
17 {
18 "instanceId": "eni-w2kmnu1peqxg",
19 "instanceType": "ENI",
20 "master": true
21 },
22 {
23 "instanceId": "eni-7c9yzhkfn9c2",
24 "instanceType": "ENI",
25 "master": false
26 }
27 ]
28}