User Tools

Site Tools


api:dns:acmegetzone

API : DNS Acme Get Zone

Introduction

This request can be used by the ACME client using the PowerDNS module to fetch a zones records.

Request

URL https://api.telecomx.dk/dns/acme/api/v1/servers/default/zones/DOMAIN
Method GET
Access level VIEWER, MANAGER, OWNER, RESELLER, RESELLER_ADMIN, ADMIN.
Params DOMAIN Domain to lookup zone data for

Response

Example

{
  "account": "",
  "api_rectify": false,
  "dnssec": false,
  "edited_serial": 2022040501,
  "id": "example.org.",
  "kind": "Native",
  "last_check": 0,
  "master_tsig_key_ids": [],
  "masters": [],
  "name": "example.org.",
  "notified_serial": 0,
  "nsec3narrow": false,
  "nsec3param": "",
  "rrsets": [
    {
      "comments": [],
      "name": "example.org.",
      "records": [
        {
          "content": "a.misconfigured.dns.server.invalid. hostmaster.example.org. 2022040501 10800 3600 604800 3600",
          "disabled": false
        }
      ],
      "ttl": 3600,
      "type": "SOA"
    },
    {
      "comments": [],
      "name": "example.org.",
      "records": [
        {
          "content": "ns1.example.org.",
          "disabled": false
        },
        {
          "content": "ns2.example.org.",
          "disabled": false
        }
      ],
      "ttl": 3600,
      "type": "NS"
    }
  ],
  "serial": 2022040501,
  "slave_tsig_key_ids": [],
  "soa_edit": "",
  "soa_edit_api": "DEFAULT",
  "url": "/api/v1/servers/localhost/zones/example.org."
}

Errors

Error code Message Description
403 access_denied Insufficient access level
500 internal_error <Unspecified>
api/dns/acmegetzone.txt · Last modified: 2024/11/07 13:14 by Per Møller

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki