{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-certificate-manager/json-schema/google-cloud-certificate-manager-dns-authorization-schema.json",
  "title": "DnsAuthorization",
  "description": "A DnsAuthorization resource describes a way to perform domain authorization for certificate issuance.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-certificate-manager-certificatemanager-projects-api-openapi.yml#/components/schemas/DnsAuthorization",
  "properties": {
    "labels": {
      "description": "Optional. Set of labels associated with a DnsAuthorization.",
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "name": {
      "description": "Identifier. A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern `projects/*/locations/*/dnsAuthorizations/*`.",
      "type": "string"
    },
    "dnsResourceRecord": {
      "$ref": "#/$defs/DnsResourceRecord",
      "description": "Output only. DNS Resource Record that needs to be added to DNS configuration."
    },
    "tags": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
      "type": "object"
    },
    "description": {
      "description": "Optional. One or more paragraphs of text description of a DnsAuthorization.",
      "type": "string"
    },
    "updateTime": {
      "description": "Output only. The last update timestamp of a DnsAuthorization.",
      "readOnly": true,
      "format": "google-datetime",
      "type": "string"
    },
    "domain": {
      "description": "Required. Immutable. A domain that is being authorized. A DnsAuthorization resource covers a single domain and its wildcard, e.g. authorization for `example.com` can be used to issue certificates for `example.com` and `*.example.com`.",
      "type": "string"
    },
    "type": {
      "type": "string",
      "description": "Optional. Immutable. Type of DnsAuthorization. If unset during resource creation the following default will be used: - in location `global`: FIXED_RECORD, - in other locations: PER_PROJECT_RECORD.",
      "enum": [
        "TYPE_UNSPECIFIED",
        "FIXED_RECORD",
        "PER_PROJECT_RECORD"
      ]
    },
    "createTime": {
      "readOnly": true,
      "description": "Output only. The creation timestamp of a DnsAuthorization.",
      "type": "string",
      "format": "google-datetime"
    }
  },
  "type": "object",
  "$defs": {
    "DnsResourceRecord": {
      "description": "The structure describing the DNS Resource Record that needs to be added to DNS configuration for the authorization to be usable by certificate.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Output only. Fully qualified name of the DNS Resource Record. e.g. `_acme-challenge.example.com`",
          "readOnly": true
        },
        "type": {
          "readOnly": true,
          "description": "Output only. Type of the DNS Resource Record. Currently always set to \"CNAME\".",
          "type": "string"
        },
        "data": {
          "description": "Output only. Data of the DNS Resource Record.",
          "type": "string",
          "readOnly": true
        }
      },
      "type": "object"
    }
  }
}