action linode_get_domains {
  label: "Domains List"
  description: "This is a collection of Domains that you have registered in Linode's DNS Manager.  Linode is not a registrar, and in order for these to work you must own the domains and point your registrar at Linode's nameservers.\n"
  provider: linode
  method: GET
  path: "/domains"
  encoding: json
  output: {
    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."
      }
    }
  }
}