Querying PTR Records of an EIP

Updated on 2024-03-25 GMT+08:00

View PDF

Function

This API is used to query PTR records of an EIP.

Calling Method

For details, see Calling APIs.

URI

GET /v2/reverse/floatingips/{region}:{floatingip_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
region	Yes	String	Region
floatingip_id	Yes	String	EIP ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
id	String	PTR record ID, which is in {region}:{floatingip_id} format
ptrdname	String	Domain name of the PTR record
description	String	PTR record description
ttl	Integer	PTR record caching duration (in seconds) on a local DNS server. The longer the duration is, the slower the update takes effect.
address	String	EIP
status	String	Resource status
action	String	Requested operation on the resource.Value options: CREATE, UPDATE, DELETE, NONE, CREATE, UPDATE, and DELETENONE: No operation will be performed.
links	pageLink object	Link of the current resource or other related resources. When a response is broken into pages, a next link is provided to retrieve all results.
enterprise_project_id	String	ID of the enterprise project associated with the PTR record. The value contains a maximum of 36 characters.

**Table 4** pageLink
Parameter	Type	Description
self	String	Link to the current resource
next	String	Link to the next page

Example Requests

None

Example Responses

Status code: 200

Response to the request for querying the PTR record of an EIP

{
  "id" : "region_id:c5504932-bf23-4171-b655-b87a6bc59334",
  "ptrdname" : "www.example.com.",
  "description" : "Description for this PTR record",
  "address" : "10.154.52.138",
  "action" : "CREATE",
  "ttl" : 300,
  "status" : "ACTIVE",
  "links" : {
    "self" : "https://Endpoint/v2/reverse/floatingips/region_id:c5504932-bf23-4171-b655-b87a6bc59334"
  }
}