DNSSEC | Sections Test

Retrieve a DNSSEC key

get

Get DNSSEC keys for your DNS zone.

Authorizations

Path parameters

zoneIdstring · uuidRequired

The ID (UUID) of the DNS zone.

Responses

200

Success case, dnssec keys returned.

application/json

400

### Bad Request The request send to the API was malformed.

application/json

401

### Unauthorized The request is missing authorization information or the authorization information provided are expired.

application/json

403

### Not Allowed The user issuing the request does not have the needed permissions.

application/json

404

### Not Found The resource that was requested could not be found.

application/json

500

### Internal Server Error An internal error occurred. We apologize for the inconvenience!

application/json

get

GET /zones/{zoneId}/keys HTTP/1.1
Host: dns.de-fra.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "98277a78-a6a2-4672-ac9a-a68ca0a8d67a",
  "type": "dnsseckeys",
  "href": "<RESOURCE-URI>",
  "metadata": {
    "zoneId": "a363f30c-4c0c-4552-9a07-298d87f219bf",
    "items": [
      {
        "keyTag": 49057,
        "digestAlgorithmMnemonic": "SHA-1",
        "digest": "CF58B511B2D8EF99263704A112703586E542E4FA",
        "keyData": {
          "flags": 257,
          "pubKey": "AwEAAY6wMNhHk/0+sV44EK4Hj/1f89gQeUC9f49mElA jMWUIHlBviGuzgr0Bvwf/JSk82aWjnVgdI/JJ0Onaqp7Nt66HZVH t/1GT4PG1cceWBYzWREYF8RMoSts/4Ol9YOPc2EHdKfycESD4dAEO ZtlkV07hAFRG0TzaGg+k48MQr8njn/oagThSmeHCfRtCvzgJDicPYXR H4fdoKZCv5v41Qgxd0ZjmbQxB8ls8ZXdVC2iQ2E6pQ3WcTRu8zM 6Xv0BHBGChYiSsTNZB8dHVgL/1CRUGiNRFJEkHvcXWeC2/HSnZJYLU cC/lYmBstn/yD432EkgSIbVDOdxdk0b/ARIrbLc="
        },
        "composedKeyData": "257 3 8 AwEAAY6wMNhHk...RIrbLc="
      }
    ]
  },
  "properties": {
    "keyParameters": {
      "algorithm": "RSASHA256"
    },
    "nsecParameters": {
      "nsecMode": "NSEC3"
    }
  }
}

Create a DNSSEC key

post

Enable DNSSEC keys and create associated DNSKEY records for your DNS zone.

Authorizations

Path parameters

zoneIdstring · uuidRequired

The ID (UUID) of the DNS zone.

Body

Responses

202

Successful operation.

application/json

400

### Bad Request The request send to the API was malformed.

application/json

401

### Unauthorized The request is missing authorization information or the authorization information provided are expired.

application/json

403

### Not Allowed The user issuing the request does not have the needed permissions.

application/json

404

### Not Found The resource that was requested could not be found.

application/json

409

### Conflict Error You can only have one DNSSEC per zone, and this zone already has one in place.

application/json

500

### Internal Server Error An internal error occurred. We apologize for the inconvenience!

application/json

post

POST /zones/{zoneId}/keys HTTP/1.1
Host: dns.de-fra.ionos.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 182

{
  "properties": {
    "keyParameters": {
      "algorithm": "RSASHA256",
      "kskBits": 4096,
      "zskBits": 2048
    },
    "nsecParameters": {
      "nsecMode": "NSEC3",
      "nsec3Iterations": 21,
      "nsec3SaltBits": 128
    },
    "validity": 120
  }
}

{
  "properties": {
    "keyParameters": {
      "algorithm": "RSASHA256",
      "kskBits": 4096,
      "zskBits": 2048
    },
    "nsecParameters": {
      "nsecMode": "NSEC3",
      "nsec3Iterations": 21,
      "nsec3SaltBits": 128
    },
    "validity": 120
  },
  "id": "98277a78-a6a2-4672-ac9a-a68ca0a8d67a",
  "type": "dnsseckeys",
  "href": "<RESOURCE-URI>"
}

Delete a DNSSEC key

delete

Disable DNSSEC keys and remove associated DNSKEY records for your DNS zone.

Authorizations

Path parameters

zoneIdstring · uuidRequired

The ID (UUID) of the DNS zone.

Responses

202

Successful operation.

application/json

Responseobject

400

### Bad Request The request send to the API was malformed.

application/json

401

### Unauthorized The request is missing authorization information or the authorization information provided are expired.

application/json

403

### Not Allowed The user issuing the request does not have the needed permissions.

application/json

404

### Not Found The resource that was requested could not be found.

application/json

500

### Internal Server Error An internal error occurred. We apologize for the inconvenience!

application/json

delete

DELETE /zones/{zoneId}/keys HTTP/1.1
Host: dns.de-fra.ionos.com
Authorization: YOUR_API_KEY
Accept: */*

{}