Domain Create

{
  "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"
      ]
    }
  }
}