文档首页 > > 开发指南> 常见操作> 弹性公网IP> 更新(绑定/解绑)弹性公网IP

更新(绑定/解绑)弹性公网IP

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

场景描述

更新EIP,主要用于EIP与实例之间绑定状态的修改。

  • 用户可以将创建的EIP与ECS/BMS/虚拟IP/ELB/NAT等资源灵活地绑定及解绑。
  • 通过IAM服务获取到的Token有效期为24小时,需要同一个Token鉴权时,可以先将Token缓存,避免频繁调用。

涉及API

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

  • IAM获取token的API
  • VPC更新EIP的API

参数说明及响应详细信息参考《虚拟私有云API参考》“更新(绑定/解绑)弹性公网IP”章节。

具体步骤

  • Token认证,具体操作请参考Token认证
  • 发送“PUT https://VPC的Endpoint/v1/{project_id}/publicips/{publicip_id}”。其中,project_id为项目ID,publicip_id为EIP ID。
  • 在Request Header中增加“X-Auth-Token”。
  • 在Request Body中传入参数,样例如下:
    • 请求样例1(EIP绑定一张网卡)
      PUT https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}
      
      {
          "publicip": {
              "port_id": "f588ccfa-8750-4d7c-bf5d-2ede24414706"
          }
      }
    • 请求样例2(转换为IPv6 EIP)
      PUT https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}
      
      {
          "publicip": {
              "ip_version ": 6 
          }
      }
  • 请求响应成功后,响应样例如下:
    • 响应样例1(EIP绑定一张网卡)
      {
        "publicip": {
          "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb",
          "status": "ACTIVE",
          "type": "5_bgp",
          "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe",
          "public_ip_address": "10.xx.xx.162",
          "private_ip_address": "192.168.1.131",
          "tenant_id": "26ae5181a416420998eb2093aaed84d9",
          "create_time": "2019-03-27 01:33:18",
          "bandwidth_size": 7,
          "ip_version": 4
        }
      }
    • 响应样例2(转换为IPv6 EIP)
      {
        "publicip": {
          "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb",
          "status": "DOWN",
          "type": "5_bgp",
          "public_ip_address": "10.xx.xx.162",
          "public_ipv6_address": "cdcd:xx:xx:xx::a9a:4aa2",
          "tenant_id": "26ae5181a416420998eb2093aaed84d9",
          "create_time": "2019-03-27 01:33:18",
          "bandwidth_size": 7,
          "ip_version": 6
        }
      }
  • 请求异常返回值说明请参考错误码
分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区