查询全域弹性公网IP详情 - ShowGlobalEip

功能介绍

查询全域弹性公网IP详情。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项
eip:globalEips:get

Read

globalEip *

g:ResourceTag/<tag-key>

g:EnterpriseProjectId

-

-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
eip:globalEips:get	Read	globalEip *	g:ResourceTag/<tag-key> g:EnterpriseProjectId	-	-

URI

GET /v3/{domain_id}/global-eips/{global_eip_id}

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	租户账号ID，获取租户账号ID请参见租户账号ID 最小长度：5 最大长度：32
global_eip_id	是	String	global_eip_id 最小长度：36 最大长度：36

表2 Query参数
参数	是否必选	参数类型	描述
fields	否	Array of strings	功能说明：查询指定的字段，格式为fields=A&fields=B&fields=C&...... 支持的字段： id name description domain_id access_site geip_pool_name isp ip_version ip_address ipv6_address freezen freezen_info polluted status created_at updated_at internet_bandwidth_info global_connection_bandwidth_info associate_instance_info is_pre_paid tags sys_tags enterprise_project_id

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户的Token，获取用户Token请参见获取用户Token

响应参数

状态码：200

表4 响应Header参数
参数	参数类型	描述
X-Request-Id	String	本次请求编号

请求示例

查询id为393f69a0-e007-45ee-89f0-872d11620f31的全域弹性公网IP详情

GET https://{Endpoint}/v3/{domain_id}/global-eips/393f69a0-e007-45ee-89f0-872d11620f31

响应示例

状态码：200

{
  "example" : {
    "request_id" : "da346cb858ae8d335a6f6b45edbc4836",
    "global_eip" : {
      "enterprise_project_id" : 0,
      "name" : "geip-f833",
      "created_at" : "2023-12-11T09:44:44Z",
      "updated_at" : "2023-12-11T09:44:45Z",
      "id" : "393f69a0-e007-45ee-89f0-872d11620f31",
      "description" : null,
      "domain_id" : "f35feb8670a94a04a08d6628e0d5165b",
      "access_site" : "cn-south-odin",
      "geip_pool_name" : "cn-south-odin",
      "isp" : "BGP",
      "ip_version" : 4,
      "freezen" : false,
      "status" : "idle",
      "freezen_info" : null,
      "is_pre_paid" : false,
      "is_charged" : true,
      "tags" : [ {
        "key" : "tag1",
        "value" : "tom"
      } ],
      "ip_address" : "10.83.68.92",
      "ipv6_address" : null,
      "polluted" : false,
      "internet_bandwidth_info" : {
        "id" : "63d8437d-e0b4-4704-967c-1bc74e5926ef",
        "size" : 100
      },
      "global_connection_bandwidth_info" : null,
      "associate_instance_info" : null
    }
  },
  "schema" : {
    "$ref" : "#/components/schemas/ShowGlobalEipResponseBody"
  }
}