Updated on 2025-08-19 GMT+08:00

Querying a PTR Record of an EIP

Function

This API is used to query a PTR record 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

Definition

The user token.

The token can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

For details about how to obtain a user token, seeObtaining a User Token.

Constraints

N/A

Range

N/A

Default Value

N/A

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

The zone of the PTR record

description

String

Descriptions about the PTR record

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 address.

status

String

Resource status.

action

String

Requested operation on the resource. The value can be CREATE, UPDATE, DELETE, or NONE. NONE indicates that no operation will be performed.

links

pageLink object

Definition

The link to the current page or other pages. When a response is broken into pages, a next link is provided to point to the next page.

Range

N/A

enterprise_project_id

String

ID of the enterprise project associated with the PTR record. The value contains a maximum of 36 characters.

Example Requests

None

Example Responses

Status code: 200

Successful request

{
  "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"
  }
}

Status Codes

Status Code

Description

200

Successful request

Error Codes

See Error Codes.