Versions

Manage multiple versions of your DNS zones.

List versions of a DNS zone

GET

https://api.scaleway.com

/domain/v2beta1/dns-zones/{dns_zone}/versions

Retrieve a list of a DNS zone's versions.
The maximum version count is 100. If the count reaches this limit, the oldest version will be deleted after each new modification.

List versions of a DNS zone › path Parameters

dns_zone

string · required

List versions of a DNS zone › query Parameters

page

integer · int32

Page number to return, from the paginated results.

page_size

integer · uint32

Maximum number of DNS zones versions per page.

List versions of a DNS zone › Responses

200

scaleway.domain.v2beta1.ListDNSZoneVersionsResponse

total_count

integer · uint32

Total number of DNS zones versions.

scaleway.domain.v2beta1.DNSZoneVersion[]

List records from a given version of a specific DNS zone

GET

https://api.scaleway.com

/domain/v2beta1/dns-zones/version/{dns_zone_version_id}

Retrieve a list of records from a specific DNS zone version.

List records from a given version of a specific DNS zone › path Parameters

dns_zone_version_id

string · required

(UUID format)

List records from a given version of a specific DNS zone › query Parameters

page

integer · int32

Page number to return, from the paginated results.

page_size

integer · uint32

Maximum number of DNS zones versions records per page.

List records from a given version of a specific DNS zone › Responses

200

scaleway.domain.v2beta1.ListDNSZoneVersionRecordsResponse

total_count

integer · uint32

Total number of DNS zones versions records.

scaleway.domain.v2beta1.Record[]

GET/domain/v2beta1/dns-zones/version/{dns_zone_version_id}

curl -X GET \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/domain/v2beta1/dns-zones/version/{dns_zone_version_id}"

Example Responses

{
  "total_count": 0,
  "records": [
    {
      "data": "data",
      "name": "name",
      "priority": 0,
      "ttl": 0,
      "type": "unknown",
      "comment": "comment",
      "geo_ip_config": {
        "matches": [
          {
            "countries": [
              "string"
            ],
            "continents": [
              "string"
            ],
            "data": "data"
          }
        ],
        "default": "default"
      },
      "http_service_config": {
        "ips": [
          "1.2.3.4"
        ],
        "must_contain": "must_contain",
        "url": "url",
        "user_agent": "user_agent",
        "strategy": "random"
      },
      "weighted_config": {
        "weighted_ips": [
          {
            "ip": "1.2.3.4",
            "weight": 0
          }
        ]
      },
      "view_config": {
        "views": [
          {
            "subnet": "subnet",
            "data": "data"
          }
        ]
      },
      "id": "id",
      "updated_at": "2022-03-22T12:34:56.123456Z"
    }
  ]
}

json

application/json

Access differences from a specific DNS zone version

GET

https://api.scaleway.com

/domain/v2beta1/dns-zones/version/{dns_zone_version_id}/diff

Access a previous DNS zone version to see the differences from another specific version.

Access differences from a specific DNS zone version › path Parameters

dns_zone_version_id

string · required

(UUID format)

Access differences from a specific DNS zone version › Responses

200

scaleway.domain.v2beta1.GetDNSZoneVersionDiffResponse

scaleway.domain.v2beta1.RecordChange[]

GET/domain/v2beta1/dns-zones/version/{dns_zone_version_id}/diff

curl -X GET \
  -H "X-Auth-Token: $SCW_SECRET_KEY" \
  "https://api.scaleway.com/domain/v2beta1/dns-zones/version/{dns_zone_version_id}/diff"

Example Responses

{
  "changes": [
    {
      "add": {
        "records": [
          {
            "data": "data",
            "name": "name",
            "priority": 0,
            "ttl": 0,
            "type": "unknown",
            "comment": "comment",
            "geo_ip_config": {
              "matches": [
                {
                  "countries": [
                    "string"
                  ],
                  "continents": [
                    "string"
                  ],
                  "data": "data"
                }
              ],
              "default": "default"
            },
            "http_service_config": {
              "ips": [
                "1.2.3.4"
              ],
              "must_contain": "must_contain",
              "url": "url",
              "user_agent": "user_agent",
              "strategy": "random"
            },
            "weighted_config": {
              "weighted_ips": [
                {
                  "ip": "1.2.3.4",
                  "weight": 0
                }
              ]
            },
            "view_config": {
              "views": [
                {
                  "subnet": "subnet",
                  "data": "data"
                }
              ]
            },
            "id": "id",
            "updated_at": "2022-03-22T12:34:56.123456Z"
          }
        ]
      },
      "set": {
        "id": "6170692e-7363-616c-6577-61792e636f6d",
        "id_fields": {
          "name": "name",
          "type": "unknown",
          "data": "data",
          "ttl": 0
        },
        "records": [
          {
            "data": "data",
            "name": "name",
            "priority": 0,
            "ttl": 0,
            "type": "unknown",
            "comment": "comment",
            "geo_ip_config": {
              "matches": [
                {
                  "countries": [
                    "string"
                  ],
                  "continents": [
                    "string"
                  ],
                  "data": "data"
                }
              ],
              "default": "default"
            },
            "http_service_config": {
              "ips": [
                "1.2.3.4"
              ],
              "must_contain": "must_contain",
              "url": "url",
              "user_agent": "user_agent",
              "strategy": "random"
            },
            "weighted_config": {
              "weighted_ips": [
                {
                  "ip": "1.2.3.4",
                  "weight": 0
                }
              ]
            },
            "view_config": {
              "views": [
                {
                  "subnet": "subnet",
                  "data": "data"
                }
              ]
            },
            "id": "id",
            "updated_at": "2022-03-22T12:34:56.123456Z"
          }
        ]
      },
      "delete": {
        "id": "6170692e-7363-616c-6577-61792e636f6d",
        "id_fields": {
          "name": "name",
          "type": "unknown",
          "data": "data",
          "ttl": 0
        }
      },
      "clear": {}
    }
  ]
}

json

application/json

Restore a DNS zone version

POST

https://api.scaleway.com

/domain/v2beta1/dns-zones/version/{dns_zone_version_id}/restore

Restore and activate a version of a specific DNS zone.

Restore a DNS zone version › path Parameters

dns_zone_version_id

string · required

(UUID format)

Restore a DNS zone version › Request Body

Restore a DNS zone version › Responses

200

scaleway.domain.v2beta1.RestoreDNSZoneVersionResponse

Records Imports / Exports

List versions of a DNS zone

GET

https://api.scaleway.com

/domain/v2beta1/dns-zones/{dns_zone}/versions

Retrieve a list of a DNS zone's versions.
The maximum version count is 100. If the count reaches this limit, the oldest version will be deleted after each new modification.

List versions of a DNS zone › path Parameters

dns_zone

string · required

List versions of a DNS zone › query Parameters

page

integer · int32

Page number to return, from the paginated results.

page_size

integer · uint32

Maximum number of DNS zones versions per page.

List versions of a DNS zone › Responses

200

scaleway.domain.v2beta1.ListDNSZoneVersionsResponse

total_count

integer · uint32

Total number of DNS zones versions.

scaleway.domain.v2beta1.DNSZoneVersion[]

List records from a given version of a specific DNS zone

GET

https://api.scaleway.com

/domain/v2beta1/dns-zones/version/{dns_zone_version_id}

Retrieve a list of records from a specific DNS zone version.

List records from a given version of a specific DNS zone › path Parameters

dns_zone_version_id

string · required

(UUID format)

List records from a given version of a specific DNS zone › query Parameters

page

integer · int32

Page number to return, from the paginated results.

page_size

integer · uint32

Maximum number of DNS zones versions records per page.

List records from a given version of a specific DNS zone › Responses

200

scaleway.domain.v2beta1.ListDNSZoneVersionRecordsResponse

total_count

integer · uint32

Total number of DNS zones versions records.

scaleway.domain.v2beta1.Record[]

Access differences from a specific DNS zone version

GET

https://api.scaleway.com

/domain/v2beta1/dns-zones/version/{dns_zone_version_id}/diff

Access a previous DNS zone version to see the differences from another specific version.

Access differences from a specific DNS zone version › path Parameters

dns_zone_version_id

string · required

(UUID format)

Access differences from a specific DNS zone version › Responses

200

scaleway.domain.v2beta1.GetDNSZoneVersionDiffResponse

scaleway.domain.v2beta1.RecordChange[]

Restore a DNS zone version

POST

https://api.scaleway.com

/domain/v2beta1/dns-zones/version/{dns_zone_version_id}/restore

Restore and activate a version of a specific DNS zone.

Restore a DNS zone version › path Parameters

dns_zone_version_id

string · required

(UUID format)

Restore a DNS zone version › Request Body

Restore a DNS zone version › Responses

200

scaleway.domain.v2beta1.RestoreDNSZoneVersionResponse