更新时间:2022-01-25 GMT+08:00
查询弹性公网IP
功能介绍
查询指定弹性公网IP。
URI
GET /v1/{project_id}/publicips/{publicip_id}
响应消息
- 响应参数
表2 响应参数 名称
参数类型
说明
publicip
Object
弹性公网IP对象,请参见表3。
表3 publicip字段说明 名称
参数类型
说明
id
String
弹性公网IP唯一标识
status
String
- 功能说明:弹性公网IP的状态
- 取值范围:
- FREEZED:冻结
- BIND_ERROR:绑定失败
- BINDING:绑定中
- PENDING_DELETE:释放中
- PENDING_CREATE:创建中
- PENDING_UPDATE:更新中
- DOWN:未绑定
- ACTIVE:绑定
- ELB:绑定ELB
- ERROR:异常失败
type
String
- 功能说明:弹性公网IP的类型
- 取值范围:5_bgp
- 约束:
- 必须是系统具体支持的类型
- publicip_id为IPv4端口,所以"publicip_type"字段未给定时,默认为5_bgp。
private_ip_address
String
- 功能说明:绑定弹性公网IP的私有IP地址
- 约束:只有绑定了的弹性公网IP查询才会返回该参数
port_id
String
- 功能说明:端口id。
- 约束:只有绑定了的弹性公网IP查询才会返回该参数
tenant_id
String
项目ID
create_time
String
弹性公网IP申请时间(UTC)
bandwidth_id
String
弹性公网IP对应带宽ID
bandwidth_size
Integer
带宽大小,单位为Mbit/s。
bandwidth_share_type
String
- 功能说明:弹性公网IP的带宽类型
- 取值范围:PER,WHOLE。
- PER:独享带宽
- WHOLE:共享带宽
- 响应样例
{ "publicip": { "id": "2ec9b78d-9368-46f3-8f29-d1a95622a568", "status": "DOWN", "type": "5_bgp", "public_ip_address": "161.xx.xx.12", "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c", "private_ip_address": "192.168.10.5", "create_time": "2015-07-16 04:32:50", "bandwidth_id": "49c8825b-bed9-46ff-9416-704b96d876a2", "bandwidth_share_type": "PER", "bandwidth_size": 10, //EIP的带宽大小为10Mbit/s "ip_version": 4 } }
状态码
请参见状态码。
错误码
请参考错误码。
父主题: 弹性公网IP