文档首页> 弹性云服务器 ECS> API参考> 应用示例> 查询弹性云服务器关联的弹性公网IP
更新时间:2023-12-01 GMT+08:00
分享

查询弹性云服务器关联的弹性公网IP

场景描述

本章节指导用户通过弹性云服务器和弹性公网IP接口,查询弹性云服务器关联的弹性公网IP详情。

涉及接口

本示例场景涉及如下接口调用:

操作步骤

  1. 查询弹性云服务器详情

    • 接口相关信息

      URI格式: GET /v1/{project_id}/cloudservers/{server_id}

      详情请参见“查询云服务器详情”。

    • 请求示例

      GET https://{endpoint}/v1/743b4c0428d945316666666666666666/cloudservers/893c7791-f1df-4c3d-8383-3caae9656c62

      {endpoint}信息请从地区和终端节点获取。

    • 响应示例
      {
      	"server": {
      		"fault": null,
      		"id": "b8b1b475-d6c9-4733-a3db-c3a526407286",
      		"name": "ecs-test",
      		"addresses": {
      			"24bbb54c-659f-4141-8db9-a957e12b6ee8": [{
      				"version": "4",
      				"addr": "192.168.0.16",
      				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:37:de:ee",
      				"OS-EXT-IPS:type": "fixed",
      				"OS-EXT-IPS:port_id": "390b39b0-9a77-4ec2-ae1e-3af358f78999"
      			},
      			{
      				"version": "4",
      				"addr": "121.xx.xx.64",
      				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:37:de:ee",
      				"OS-EXT-IPS:type": "floating",
      				"OS-EXT-IPS:port_id": "390b39b0-9a77-4ec2-ae1e-3af358f78999"
      			}]
      		},
      		"flavor": {
      			"disk": "0",
      			"vcpus": "2",
      			"ram": "4096",
      			"id": "c6s.large.2",
      			"name": "c6s.large.2"
      		},
      		"accessIPv4": "",
      		"accessIPv6": "",
      		"status": "SHUTOFF",
      		"progress": null,
      		"hostId": "604599c4eeeaa05d8865749e4c97979e14d74c6639a08460051b3a97",
      		"updated": "2021-02-18T12:38:39Z",
      		"created": "2021-02-18T12:37:42Z",
      		"metadata": {
      			"metering.image_id": "6674d782-54ba-4f04-896d-95edd50f2eb9",
      			"metering.imagetype": "gold",
      			"metering.resourcespeccode": "c6s.large.2.linux",
      			"image_name": "CentOS 8.2 64bit",
      			"os_bit": "64",
      			"cascaded.instance_extrainfo": "stopped_release_resource:True,pcibridge:1",
      			"metering.resourcetype": "1",
      			"vpc_id": "24bbb54c-659f-4141-8db9-a957e12b6ee8",
      			"os_type": "Linux",
      			"charging_mode": "0",
      			"__support_agent_list": "ces"
      		},
      		"tags": [],
      		"description": "",
      		"locked": false,
      		"config_drive": "",
      		"tenant_id": "0b3ade290700f3612f29c005b9d16666",
      		"user_id": "0b3ade2a03800fec1f20c005d6116666",
      		"key_name": null,
      		"os-extended-volumes:volumes_attached": [{
      			"device": "/dev/vda",
      			"bootIndex": "0",
      			"id": "0dc13ef4-dcf6-49d2-8d34-395d94767917",
      			"delete_on_termination": "true"
      		}],
      		"OS-EXT-STS:task_state": null,
      		"OS-EXT-STS:power_state": 4,
      		"OS-EXT-STS:vm_state": "stopped",
      		"OS-EXT-SRV-ATTR:host": "604599c4eeeaa05d8865749e4c97979e14d74c6639a08460051b3a97",
      		"OS-EXT-SRV-ATTR:instance_name": "instance-003ef12a",
      		"OS-EXT-SRV-ATTR:hypervisor_hostname": "5edb1b44af14ebaaa784cfba010f78f113b1fd0865fef854c264a925",
      		"OS-DCF:diskConfig": "MANUAL",
      		"OS-EXT-AZ:availability_zone": "cn-east-3c",
      		"os:scheduler_hints": {
      			
      		},
      		"OS-EXT-SRV-ATTR:root_device_name": "/dev/vda",
      		"OS-EXT-SRV-ATTR:ramdisk_id": "",
      		"enterprise_project_id": "0",
      		"OS-EXT-SRV-ATTR:user_data": null,
      		"OS-SRV-USG:launched_at": "2021-02-18T12:37:57.000000",
      		"OS-EXT-SRV-ATTR:kernel_id": "",
      		"OS-EXT-SRV-ATTR:launch_index": 0,
      		"host_status": "UP",
      		"OS-EXT-SRV-ATTR:reservation_id": "r-q8xjhqzk",
      		"OS-EXT-SRV-ATTR:hostname": "ecs-test",
      		"OS-SRV-USG:terminated_at": null,
      		"sys_tags": [{
      			"key": "_sys_enterprise_project_id",
      			"value": "0"
      		}],
      		"security_groups": [{
      			"id": "d0d30ee2-5b34-44d4-b5a3-68b9d64e7286",
      			"name": "Sys-WebServer"
      		}],
      		"image": {
      			"id": "6674d782-54ba-4f04-896d-95edd50f2eb9"
      		},
      		"hypervisor": null,
      		"auto_terminate_time": ""
      	}
      }

  2. 根据公网IP查询公网IP详情

    • 请求示例

      GET https://{endpoint}/v1/743b4c0428d945316666666666666666/publicips?public_ip_address=121.xx.xx.64

      {endpoint}信息请从地区和终端节点获取。

      public_ip_address参数传入的公网IP地址从1的返回信息中获取,从返回body体中的"server"下的"address"信息中找到"OS-EXT-IPS:type"为"floating"的"addr"字段,即为公网IP地址。

    • 响应示例
      {
      	"publicips": [{
      		"id": "92597d39-b81d-42b0-8d02-fe8afe7ef076",
      		"type": "5_bgp",
      		"port_id": "390b39b0-9a77-4ec2-ae1e-3af358f78999",
      		"public_ip_address": "121.xx.xx.64",
      		"private_ip_address": "192.168.0.16",
      		"status": "ACTIVE",
      		"tenant_id": "0b3ade290700f3612f29c005b9d16666",
      		"create_time": "2021-02-18 12:38:08",
      		"bandwidth_id": "3a087bbd-0bcf-4401-9e2b-6a96fa2e3471",
      		"bandwidth_name": "ecs-test-bandwidth-891e",
      		"bandwidth_share_type": "PER",
      		"bandwidth_size": 5,
      		"profile": {},
      		"enterprise_project_id": "0",
      		"ip_version": 4
      	}]
      }

分享:

    相关文档

    相关产品