Skip to main content

dns_authorizations

Creates, updates, deletes, gets or lists a dns_authorizations resource.

Overview

Namedns_authorizations
TypeResource
Idgoogle.certificatemanager.dns_authorizations

Fields

NameDatatypeDescription
namestringIdentifier. A user-defined name of the dns authorization. DnsAuthorization names must be unique globally and match pattern projects/*/locations/*/dnsAuthorizations/*.
descriptionstringOptional. One or more paragraphs of text description of a DnsAuthorization.
createTimestringOutput only. The creation timestamp of a DnsAuthorization.
dnsResourceRecordobjectThe structure describing the DNS Resource Record that needs to be added to DNS configuration for the authorization to be usable by certificate.
domainstringRequired. 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.
labelsobjectOptional. Set of labels associated with a DnsAuthorization.
typestringOptional. 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.
updateTimestringOutput only. The last update timestamp of a DnsAuthorization.

Methods

NameAccessible byRequired ParamsDescription
getSELECTdnsAuthorizationsId, locationsId, projectsIdGets details of a single DnsAuthorization.
listSELECTlocationsId, projectsIdLists DnsAuthorizations in a given project and location.
createINSERTlocationsId, projectsIdCreates a new DnsAuthorization in a given project and location.
deleteDELETEdnsAuthorizationsId, locationsId, projectsIdDeletes a single DnsAuthorization.
patchUPDATEdnsAuthorizationsId, locationsId, projectsIdUpdates a DnsAuthorization.

SELECT examples

Lists DnsAuthorizations in a given project and location.

SELECT
name,
description,
createTime,
dnsResourceRecord,
domain,
labels,
type,
updateTime
FROM google.certificatemanager.dns_authorizations
WHERE locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

INSERT example

Use the following StackQL query and manifest file to create a new dns_authorizations resource.

/*+ create */
INSERT INTO google.certificatemanager.dns_authorizations (
locationsId,
projectsId,
name,
labels,
description,
domain,
type
)
SELECT
'{{ locationsId }}',
'{{ projectsId }}',
'{{ name }}',
'{{ labels }}',
'{{ description }}',
'{{ domain }}',
'{{ type }}'
;

UPDATE example

Updates a dns_authorizations resource.

/*+ update */
UPDATE google.certificatemanager.dns_authorizations
SET
name = '{{ name }}',
labels = '{{ labels }}',
description = '{{ description }}',
domain = '{{ domain }}',
type = '{{ type }}'
WHERE
dnsAuthorizationsId = '{{ dnsAuthorizationsId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified dns_authorizations resource.

/*+ delete */
DELETE FROM google.certificatemanager.dns_authorizations
WHERE dnsAuthorizationsId = '{{ dnsAuthorizationsId }}'
AND locationsId = '{{ locationsId }}'
AND projectsId = '{{ projectsId }}';