文档首页 > > 开发指南> 常见操作> 弹性公网IP> 查询弹性公网IP列表

查询弹性公网IP列表

分享
更新时间: 2019/10/30 GMT+08:00

场景描述

根据不同条件查询EIP列表信息。

  • 可以在URI后面用‘?’和‘&’添加不同的查询条件组合,请参考请求样例。
  • 通过IAM服务获取到的Token有效期为24小时,需要同一个Token鉴权时,可以先将Token缓存,避免频繁调用。

涉及API

当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

  • IAM获取token的API
  • VPC查询EIP列表的API

参数说明及响应详细信息参考《虚拟私有云API参考》“查询弹性公网IP列表”章节。

具体步骤

  1. Token认证,具体操作请参考Token认证
  2. 发送“GET https:// VPC的Endpoint/v1/{project_id}/publicips”。其中,project_id为项目ID。
  3. 在Request Header中增加“X-Auth-Token”。
  4. 在GET请求后通过‘?’和‘&’添加不同的查询条件组合,请求示例:https://VPC的Endpoint/v1/8b7e35ad379141fc9df3e178bd64f55c/publicips?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d
  5. 请求响应成功后,响应样例如下:
    {
        "publicips": [
            {
                "id": "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0",
                "status": "DOWN",
                "profile": {
                  "user_id": "35f2b308f5d64441a6fa7999fbcd4321",
                  "product_id": "00301-48027-0--0",
                  "region_id": "xxx",
                  "order_id": "xxxxxxxxx"
                },
                "type": "5_bgp",
                "public_ip_address": "161.xx.xx.9",
                "private_ip_address": "192.168.10.5",
                "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
                "create_time": "2015-07-16 04:22:32",
                "bandwidth_id": "3fa5b383-5a73-4dcb-a314-c6128546d855",
                "bandwidth_share_type": "PER",
                "bandwidth_size": 5,
                "bandwidth_name": "bandwidth-test",
                "enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439",
                "ip_version": 4
            },
            {
                "id": "80d5b82e-43b9-4f82-809a-37bec5793bd4",
                "status": "DOWN",              "user_id": null,            "type": "5_bgp",
                "public_ip_address": "161.xx.xx.10",
                "private_ip_address": "192.168.10.6",
                "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
                "create_time": "2015-07-16 04:23:03",
                "bandwidth_id": "a79fd11a-047b-4f5b-8f12-99c178cc780a",
                "bandwidth_share_type": "PER",
                "bandwidth_size": 5,
                "bandwidth_name": "bandwidth-test1",
                "enterprise_project_id":"0",
                "ip_version": 4
            }
        ]
    }
  6. 请求异常返回值说明请参考错误码

常用列表查询方法

  1. EIP列表查询。

    GET /v1/{project_id}/publicips

  2. EIP列表分页查询。

    GET /v1/{project_id}/publicips?limit=10

  3. 从某资源开始分页查询EIP列表。

    GET /v1/{project_id}/publicips?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区