Update Secondary Zone Configuration

PUT

https://api.cloudflare.com/client/v4/zones/{identifier}/secondary_dns/incoming

Last modified:2022-12-16 13:48:35

Update secondary zone configuration for incoming zone transfers.

Request

Path Params

identifier

string

required

Body Params application/json

auto_refresh_seconds

number

required

How often should a secondary zone auto refresh regardless of DNS NOTIFY.
Not applicable for primary zones.

Example:

86400

required

Example:

269d8f4853475ca241c4e730be286b20

name

string

required

Zone name.

Example:

www.example.com.

peers

array

required

A list of peer tags.

Example:

["23ff594956f20c2a721606e94745a8aa","00920f38ce07c2e2f4df50b1f61d4194"]

Example

{
    "auto_refresh_seconds": 86400,
    "id": "269d8f4853475ca241c4e730be286b20",
    "name": "www.example.com.",
    "peers": [
        "23ff594956f20c2a721606e94745a8aa",
        "00920f38ce07c2e2f4df50b1f61d4194"
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.cloudflare.com/client/v4/zones//secondary_dns/incoming' \
--header 'Content-Type: application/json' \
--data-raw '{
    "auto_refresh_seconds": 86400,
    "id": "269d8f4853475ca241c4e730be286b20",
    "name": "www.example.com.",
    "peers": [
        "23ff594956f20c2a721606e94745a8aa",
        "00920f38ce07c2e2f4df50b1f61d4194"
    ]
}'

Responses

🟢200Update Secondary Zone Configuration response

application/json

Body

allOf {2}

optional

object (api-response-single)

optional

errors

array [object {2}]

messages

required

Example:

[]

messages

array [object {2}]

messages

required

Example:

[]

result

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

object

optional

result

object

optional

Example

{
    "errors": [],
    "messages": [],
    "result": {
        "auto_refresh_seconds": 86400,
        "checked_time": "2019-10-24T17:09:42.883908+01:00",
        "created_time": "2019-10-24T17:09:42.883908+01:00",
        "id": "269d8f4853475ca241c4e730be286b20",
        "modified_time": "2019-10-24T17:09:42.883908+01:00",
        "name": "www.example.com.",
        "peers": [
            "23ff594956f20c2a721606e94745a8aa",
            "00920f38ce07c2e2f4df50b1f61d4194"
        ],
        "soa_serial": 2019102400
    },
    "success": true
}

🟢200Update Secondary Zone Configuration response failure

Modified at 2022-12-16 13:48:35

Create Secondary Zone Configuration

List TSIGs