Domains List

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "A domain zonefile in our DNS system.  You must own the domain name and tell your registrar to use Linode's nameservers in order for a domain in our system to be treated as authoritative.\n",
        "properties": {
          "axfr_ips": {
            "type": "array",
            "description": "The list of IPs that may perform a zone transfer for this Domain. The total combined length of all data within this array cannot exceed 1000 characters.\n\n**Note**: This is potentially dangerous, and should be set to an empty list unless you intend to use it.\n",
            "items": {
              "type": "string",
              "format": "ip"
            }
          },
          "description": {
            "type": "string",
            "description": "A description for this Domain. This is for display purposes only.\n"
          },
          "domain": {
            "type": "string",
            "description": "The domain this Domain represents. Domain labels cannot be longer than 63 characters and must conform to [RFC1035](https://tools.ietf.org/html/rfc1035). Domains must be unique on Linode's platform, including across different Linode accounts; there cannot be two Domains representing the same domain.\n"
          },
          "expire_sec": {
            "type": "integer",
            "description": "The amount of time in seconds that may pass before this Domain is no longer\nauthoritative.\n\n* Valid values are\n0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.\n\n* Any other value is rounded up to the nearest valid value.\n\n* A value of 0 is equivalent to the default value of 1209600.\n"
          },
          "group": {
            "type": "string",
            "description": "The group this Domain belongs to.  This is for display purposes only.\n"
          },
          "id": {
            "type": "integer",
            "description": "This Domain's unique ID"
          },
          "master_ips": {
            "type": "array",
            "description": "The IP addresses representing the master DNS for this Domain. At least one value is required for `type` slave Domains. The total combined length of all data within this array cannot exceed 1000 characters.\n",
            "items": {
              "type": "string",
              "format": "ip"
            }
          },
          "refresh_sec": {
            "type": "integer",
            "description": "The amount of time in seconds before this Domain should be refreshed.\n\n* Valid values are\n0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.\n\n* Any other value is rounded up to the nearest valid value.\n\n* A value of 0 is equivalent to the default value of 14400.\n"
          },
          "retry_sec": {
            "type": "integer",
            "description": "The interval, in seconds, at which a failed refresh should be retried.\n\n* Valid values are\n0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.\n\n* Any other value is rounded up to the nearest valid value.\n\n* A value of 0 is equivalent to the default value of 14400.\n"
          },
          "soa_email": {
            "type": "string",
            "format": "email",
            "description": "Start of Authority email address. This is required for `type` master Domains.\n"
          },
          "status": {
            "type": "string",
            "description": "Used to control whether this Domain is currently being rendered.\n",
            "enum": [
              "disabled",
              "active"
            ]
          },
          "tags": {
            "type": "array",
            "description": "An array of tags applied to this object.  Tags are for organizational purposes only.\n",
            "items": {
              "type": "string"
            }
          },
          "ttl_sec": {
            "type": "integer",
            "description": "\"Time to Live\" - the amount of time in seconds that this Domain's records may be cached by resolvers or other domain servers.\n* Valid values are 0, 300, 3600, 7200, 14400, 28800, 57600, 86400, 172800, 345600, 604800, 1209600, and 2419200.\n* Any other value is rounded up to the nearest valid value.\n* A value of 0 is equivalent to the default value of 86400.\n"
          },
          "type": {
            "type": "string",
            "description": "Whether this Domain represents the authoritative source of information for the domain it describes (\"master\"), or whether it is a read-only copy of a master (\"slave\").\n",
            "enum": [
              "master",
              "slave"
            ]
          }
        }
      }
    },
    "page": {
      "type": "integer",
      "description": "The current [page](/docs/api/#pagination)."
    },
    "pages": {
      "type": "integer",
      "description": "The total number of [pages](/docs/api/#pagination)."
    },
    "results": {
      "type": "integer",
      "description": "The total number of results."
    }
  }
}