action combell_get_dns_domain_name_records {
  label: "Get records"
  provider: combell
  method: GET
  path: "/dns/{domainName}/records"
  encoding: json
  input: {
    type: "object"
    properties: {
      domainName: {
        type: "string"
      }
      domain_name: {
        type: "string"
        description: "The domain name."
      }
      record_name: {
        type: "string"
        description: "Filters records matching the record name. This filter only applies to lookups of A, CNAME, TXT, CAA, ALIAS and TLSA records."
      }
      service: {
        type: "string"
        description: "Filters records for the service. This filter only applies to lookups of SRV records."
      }
      skip: {
        type: "integer"
        format: "int32"
        description: "The number of items to skip in the resultset."
      }
      take: {
        type: "integer"
        format: "int32"
        description: "The number of items to return in the resultset. The returned count can be equal or less than this number."
      }
      type: {
        type: "string"
        description: "Filters records matching the type. Most other filters only apply when this filter is specified."
      }
    }
    required: ["domainName", "domain_name"]
    additionalProperties: false
  }
  output: {
    type: "array"
    items: {
      type: "object"
      properties: {
        content: {
          type: "string"
          description: "Variable data depending on the record type.
\n<ul><li>A: the IPv4 address.</li><li>CNAME: canonical name of an alias.</li><li>MX: fully qualified domain name of a mail host.</li><li>SRV: does not apply. Data for the SRV records can be found in specific properties.</li><li>TXT: free form text data.</li><li>CAA: format should match specific values for flag, tag and ca: \"{flag} {tag} {ca}\".
\n        <ul><li>The flag. The values 128 (critical) or 0 (non-critical) are expected, with 0 as the default.</li><li>The tag. A tag specifies which actions an authorized CA can take in terms of issuing SSL/TLS certificates.<br /><ul><li>The value \"issue\": explicitly authorizes a single certificate authority to issue a certificate (any type) for the hostname.</li><li>The value \"issuewild\": explicitly authorizes a single certificate authority to issue a wildcard certificate (and only wildcard) for the hostname.</li><li>The value \"iodef\": specifies a URL to which a certificate authority may report policy violations.</li></ul></li><li>The ca. This is the domain of the CA (Certification Authority) that has the authority to issue certificates for the domain in question. If the value is a semicolon (;), it means that no CA has the authority to issue a certificate for that domain.</li></ul></li><li>ALIAS: canonical name of an alias.</li><li>TLSA: format should match specific values for usage, selector, matching type and data: \"{usage} {selector} {matching_type} {data}\"
\n        <ul><li>The usage. The first field after the TLSA text in the DNS RR, specifies how to verify the certificate.<br /><ul><li>A value of 0 is for what is commonly called CA constraint (and PKIX-TA). The certificate provided when establishing TLS must be issued by the listed root-CA or one of its intermediate CAs, with a valid certification path to a root-CA already trusted by the application doing the verification.</li><li>A value of 1 is for what is commonly called Service certificate constraint (and PKIX-EE). The certificate used must match the TLSA record exactly, and it must also pass PKIX certification path validation to a trusted root-CA.</li><li>A value of 2 is for what is commonly called Trust Anchor Assertion (and DANE-TA). The certificate used has a valid certification path pointing back to the certificate mention in this record, but there is no need for it to pass the PKIX certification path validation to a trusted root-CA.</li><li>A value of 3 is for what is commonly called Domain issued certificate (and DANE-EE). The services uses a self-signed certificate. It is not signed by anyone else, and is exactly this record.</li></ul></li><li>The selector. When connecting to the service and a certificate is received, the selector field specifies which parts of it should be checked.<br /><ul><li>A value of 0 means to select the entire certificate for matching.</li><li>A value of 1 means to select just the public key for certificate matching. Matching the public key is often sufficient, as this is likely to be unique.</li></ul></li><li>The matching type.<br /><ul><li>A type of 0 means the entire information selected is present in the certificate association data.</li><li>A type of 1 means to do a SHA-256 hash of the selected data.</li><li>A type of 2 means to do a SHA-512 hash of the selected data.</li></ul></li><li>The actual data to be matched given the settings of the other fields. This is a long text string of hexadecimal data.</li></ul></li></ul>"
        }
        id: {
          type: "string"
          description: "The id of the record
\nThis value is ignored for creation of new records."
        }
        port: {
          type: "integer"
          format: "int32"
          description: "The port for SRV records.<br />
\nThe value MUST be a positive integer.<br />
\nEditing the value is not possible. You should add a new SRV record and delete the existing record."
        }
        priority: {
          type: "integer"
          format: "int32"
          description: "The priority for MX or SRV records.<br />
\nA lower value means more preferred.<br />
\nThe value MUST be a positive integer less or equal to 9999."
        }
        protocol: {
          type: "string"
          description: "Used for the creation of SRV records. Possible options: TCP, UDP, ...<br />
\nEditing the value is not possible. You should add a new SRV record and delete the existing record."
        }
        record_name: {
          type: "string"
          description: "The name of the record.<br />
\nThis is the host name, alias defined by the record.<br />
\nAn empty record or '@' is equal to the domain name.<br />
\nApplies to A, MX, CNAME, TXT, CAA, ALIAS and TLSA records.<br />
\nWhen type is TLSA the recommended value format is port number, protocol and host: _25._tcp.<br />
\nDoes not apply for SRV records."
        }
        service: {
          type: "string"
          description: "The symbolic name of the desired service for SRV records.<br />
\nEditing the value is not possible. You should add a new SRV record and can delete the existing record."
        }
        target: {
          type: "string"
          description: "The canonical hostname of the machine providing the service for SRV records.<br />
\nEditing the value is not possible. You should add a new SRV record and delete the existing record."
        }
        ttl: {
          type: "integer"
          format: "int32"
          description: "Time to live of the record in seconds.<br />
\nIt defines the time frame that clients can cache the information.<br />
\nThe value MUST be between 60 and 86400. The default value is 3600 (= 1 hour)."
        }
        type: {
          type: "string"
          description: "The type of the record (A, MX, CNAME, SRV, TXT, CAA, ALIAS and TLSA)."
        }
        weight: {
          type: "integer"
          format: "int32"
          description: "The weight for SRV records with the same priority.<br />
\nA higher value means more preferred."
        }
      }
      additionalProperties: false
    }
  }
}