managed_zones

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

Overview

Name	managed_zones
Type	Resource
Id	google.dns.managed_zones

Fields

Name	Datatype	Description
id	string	Unique identifier for the resource; defined by the server (output only)
name	string	User assigned name for this resource. Must be unique within the project. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes.
description	string	A mutable string of at most 1024 characters associated with this resource for the user's convenience. Has no effect on the managed zone's function.
cloudLoggingConfig	object	Cloud Logging configurations for publicly visible zones.
creationTime	string	The time that this resource was created on the server. This is in RFC3339 text format. Output only.
dnsName	string	The DNS name of this managed zone, for instance "example.com.".
dnssecConfig	object
forwardingConfig	object
kind	string
labels	object	User labels.
nameServerSet	string	Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet is a set of DNS name servers that all host the same ManagedZones. Most users leave this field unset. If you need to use this field, contact your account team.
nameServers	array	Delegate your managed_zone to these virtual name servers; defined by the server (output only)
peeringConfig	object
privateVisibilityConfig	object
reverseLookupConfig	object
serviceDirectoryConfig	object	Contains information about Service Directory-backed zones.
visibility	string	The zone's visibility: public zones are exposed to the Internet, while private zones are visible only to Virtual Private Cloud resources.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	managedZone, project	Fetches the representation of an existing ManagedZone.
list	SELECT	project	Enumerates ManagedZones that have been created but not yet deleted.
create	INSERT	project	Creates a new ManagedZone.
delete	DELETE	managedZone, project	Deletes a previously created ManagedZone.
patch	UPDATE	managedZone, project	Applies a partial update to an existing ManagedZone.
update	REPLACE	managedZone, project	Updates an existing ManagedZone.

SELECT examples

Enumerates ManagedZones that have been created but not yet deleted.

SELECT
id,
name,
description,
cloudLoggingConfig,
creationTime,
dnsName,
dnssecConfig,
forwardingConfig,
kind,
labels,
nameServerSet,
nameServers,
peeringConfig,
privateVisibilityConfig,
reverseLookupConfig,
serviceDirectoryConfig,
visibility
FROM google.dns.managed_zones
WHERE project = '{{ project }}';

INSERT example

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

All Properties

/*+ create */
INSERT INTO google.dns.managed_zones (
project,
name,
dnsName,
description,
nameServers,
creationTime,
dnssecConfig,
nameServerSet,
visibility,
privateVisibilityConfig,
forwardingConfig,
labels,
peeringConfig,
reverseLookupConfig,
serviceDirectoryConfig,
cloudLoggingConfig
)
SELECT 
'{{ project }}',
'{{ name }}',
'{{ dnsName }}',
'{{ description }}',
'{{ nameServers }}',
'{{ creationTime }}',
'{{ dnssecConfig }}',
'{{ nameServerSet }}',
'{{ visibility }}',
'{{ privateVisibilityConfig }}',
'{{ forwardingConfig }}',
'{{ labels }}',
'{{ peeringConfig }}',
'{{ reverseLookupConfig }}',
'{{ serviceDirectoryConfig }}',
'{{ cloudLoggingConfig }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: name
      value: string
    - name: dnsName
      value: string
    - name: description
      value: string
    - name: id
      value: string
    - name: nameServers
      value:
        - string
    - name: creationTime
      value: string
    - name: dnssecConfig
      value:
        - name: state
          value: string
        - name: defaultKeySpecs
          value:
            - - name: keyType
                value: string
              - name: algorithm
                value: string
              - name: keyLength
                value: integer
              - name: kind
                value: string
        - name: nonExistence
          value: string
        - name: kind
          value: string
    - name: nameServerSet
      value: string
    - name: visibility
      value: string
    - name: privateVisibilityConfig
      value:
        - name: networks
          value:
            - - name: networkUrl
                value: string
              - name: kind
                value: string
        - name: gkeClusters
          value:
            - - name: gkeClusterName
                value: string
              - name: kind
                value: string
        - name: kind
          value: string
    - name: forwardingConfig
      value:
        - name: targetNameServers
          value:
            - - name: ipv4Address
                value: string
              - name: forwardingPath
                value: string
              - name: ipv6Address
                value: string
              - name: kind
                value: string
        - name: kind
          value: string
    - name: labels
      value: object
    - name: peeringConfig
      value:
        - name: targetNetwork
          value:
            - name: networkUrl
              value: string
            - name: deactivateTime
              value: string
            - name: kind
              value: string
        - name: kind
          value: string
    - name: reverseLookupConfig
      value:
        - name: kind
          value: string
    - name: serviceDirectoryConfig
      value:
        - name: namespace
          value:
            - name: namespaceUrl
              value: string
            - name: deletionTime
              value: string
            - name: kind
              value: string
        - name: kind
          value: string
    - name: cloudLoggingConfig
      value:
        - name: enableLogging
          value: boolean
        - name: kind
          value: string
    - name: kind
      value: string

UPDATE example

Updates a managed_zones resource.

/*+ update */
UPDATE google.dns.managed_zones
SET 
name = '{{ name }}',
dnsName = '{{ dnsName }}',
description = '{{ description }}',
nameServers = '{{ nameServers }}',
creationTime = '{{ creationTime }}',
dnssecConfig = '{{ dnssecConfig }}',
nameServerSet = '{{ nameServerSet }}',
visibility = '{{ visibility }}',
privateVisibilityConfig = '{{ privateVisibilityConfig }}',
forwardingConfig = '{{ forwardingConfig }}',
labels = '{{ labels }}',
peeringConfig = '{{ peeringConfig }}',
reverseLookupConfig = '{{ reverseLookupConfig }}',
serviceDirectoryConfig = '{{ serviceDirectoryConfig }}',
cloudLoggingConfig = '{{ cloudLoggingConfig }}'
WHERE 
managedZone = '{{ managedZone }}'
AND project = '{{ project }}';

REPLACE example

Replaces all fields in the specified managed_zones resource.

/*+ update */
REPLACE google.dns.managed_zones
SET 
name = '{{ name }}',
dnsName = '{{ dnsName }}',
description = '{{ description }}',
nameServers = '{{ nameServers }}',
creationTime = '{{ creationTime }}',
dnssecConfig = '{{ dnssecConfig }}',
nameServerSet = '{{ nameServerSet }}',
visibility = '{{ visibility }}',
privateVisibilityConfig = '{{ privateVisibilityConfig }}',
forwardingConfig = '{{ forwardingConfig }}',
labels = '{{ labels }}',
peeringConfig = '{{ peeringConfig }}',
reverseLookupConfig = '{{ reverseLookupConfig }}',
serviceDirectoryConfig = '{{ serviceDirectoryConfig }}',
cloudLoggingConfig = '{{ cloudLoggingConfig }}'
WHERE 
managedZone = '{{ managedZone }}'
AND project = '{{ project }}';

DELETE example

Deletes the specified managed_zones resource.

/*+ delete */
DELETE FROM google.dns.managed_zones
WHERE managedZone = '{{ managedZone }}'
AND project = '{{ project }}';