• Domain Name Service

dns
  1. Help Center
  2. Domain Name Service
  3. API Reference
  4. API Description
  5. PTR Record Management
  6. Querying a PTR Record

Querying a PTR Record

Function

Query the PTR record of an EIP.

URI

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

For details, see Table 1.
Table 1 Parameters in the URI

Parameter

Mandatory

Type

Description

region

Yes

string

Region of the tenant

floatingip_id

Yes

string

EIP ID

Request

None

Response

  • Parameter description
    Table 2 Parameters in the response

    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

    int

    Caching period of a PTR record (in seconds)

    The default value is 300s.

    The value range is 300–2147483647.

    address

    string

    EIP

    status

    enum

    Resource status

    The value can be PENDING_CREATE, ACTIVE, PENDING_DELETE, PENDING_UPDATE, or ERROR.

    action

    enum

    Requested operation on the resource

    The value can be CREATE, UPDATE, or DELETE.

    links

    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.

  • Example response
    {
        "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"
        }
    }

Returned Value

See General Request Return Code.