resource_record_sets

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

Overview

Name	resource_record_sets
Type	Resource
Id	google.dns.resource_record_sets

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	For example, www.example.com.
kind	string	(default: dns#resourceRecordSet)
routingPolicy	object	Configures dynamic query responses based on either the geo location of the querying user or a weighted round robin based routing policy. A valid ResourceRecordSet contains only rrdata (for static resolution) or a routing_policy (for dynamic resolution). (id: RRSetRoutingPolicy)
rrdatas	array	As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
signatureRrdatas	array	As defined in RFC 4034 (section 3.2).
ttl	integer (int32)	Number of seconds that this ResourceRecordSet can be cached by resolvers.
type	string	The identifier of a supported record type. See the list of Supported DNS record types.

list

Name	Datatype	Description
name	string	For example, www.example.com.
kind	string	(default: dns#resourceRecordSet)
routingPolicy	object	Configures dynamic query responses based on either the geo location of the querying user or a weighted round robin based routing policy. A valid ResourceRecordSet contains only rrdata (for static resolution) or a routing_policy (for dynamic resolution). (id: RRSetRoutingPolicy)
rrdatas	array	As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
signatureRrdatas	array	As defined in RFC 4034 (section 3.2).
ttl	integer (int32)	Number of seconds that this ResourceRecordSet can be cached by resolvers.
type	string	The identifier of a supported record type. See the list of Supported DNS record types.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	project, managedZone, name, type	clientOperationId	Fetches the representation of an existing ResourceRecordSet.
list	select	project, managedZone	filter, maxResults, name, pageToken, type	Enumerates ResourceRecordSets that you have created but not yet deleted.
create	insert	project, managedZone	clientOperationId	Creates a new ResourceRecordSet.
patch	update	project, managedZone, name, type	clientOperationId	Applies a partial update to an existing ResourceRecordSet.
delete	delete	project, managedZone, name, type	clientOperationId	Deletes a previously created ResourceRecordSet.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
managedZone	string
name	string
project	string
type	string
clientOperationId	string
filter	string
maxResults	integer (int32)
name	string
pageToken	string
type	string

SELECT examples

get

Fetches the representation of an existing ResourceRecordSet.

SELECT
name,
kind,
routingPolicy,
rrdatas,
signatureRrdatas,
ttl,
type
FROM google.dns.resource_record_sets
WHERE project = '{{ project }}' -- required
AND managedZone = '{{ managedZone }}' -- required
AND name = '{{ name }}' -- required
AND type = '{{ type }}' -- required
AND clientOperationId = '{{ clientOperationId }}'
;

list

Enumerates ResourceRecordSets that you have created but not yet deleted.

SELECT
name,
kind,
routingPolicy,
rrdatas,
signatureRrdatas,
ttl,
type
FROM google.dns.resource_record_sets
WHERE project = '{{ project }}' -- required
AND managedZone = '{{ managedZone }}' -- required
AND filter = '{{ filter }}'
AND maxResults = '{{ maxResults }}'
AND name = '{{ name }}'
AND pageToken = '{{ pageToken }}'
AND type = '{{ type }}'
;

INSERT examples

create

Creates a new ResourceRecordSet.

INSERT INTO google.dns.resource_record_sets (
data__kind,
data__name,
data__routingPolicy,
data__rrdatas,
data__signatureRrdatas,
data__ttl,
data__type,
project,
managedZone,
clientOperationId
)
SELECT 
'{{ kind }}',
'{{ name }}',
'{{ routingPolicy }}',
'{{ rrdatas }}',
'{{ signatureRrdatas }}',
{{ ttl }},
'{{ type }}',
'{{ project }}',
'{{ managedZone }}',
'{{ clientOperationId }}'
RETURNING
name,
kind,
routingPolicy,
rrdatas,
signatureRrdatas,
ttl,
type
;

Manifest

# Description fields are for documentation purposes
- name: resource_record_sets
props:
  - name: project
    value: "{{ project }}"
    description: Required parameter for the resource_record_sets resource.
  - name: managedZone
    value: "{{ managedZone }}"
    description: Required parameter for the resource_record_sets resource.
  - name: kind
    value: "{{ kind }}"
    default: dns#resourceRecordSet
  - name: name
    value: "{{ name }}"
    description: |
      For example, www.example.com.
  - name: routingPolicy
    description: |
      Configures dynamic query responses based on either the geo location of the querying user or a weighted round robin based routing policy. A valid `ResourceRecordSet` contains only `rrdata` (for static resolution) or a `routing_policy` (for dynamic resolution).
    value:
      geo:
        enableFencing: {{ enableFencing }}
        items:
          - healthCheckedTargets:
              externalEndpoints:
                - "{{ externalEndpoints }}"
              internalLoadBalancers:
                - ipAddress: "{{ ipAddress }}"
                  ipProtocol: "{{ ipProtocol }}"
                  kind: "{{ kind }}"
                  loadBalancerType: "{{ loadBalancerType }}"
                  networkUrl: "{{ networkUrl }}"
                  port: "{{ port }}"
                  project: "{{ project }}"
                  region: "{{ region }}"
            kind: "{{ kind }}"
            location: "{{ location }}"
            rrdatas: "{{ rrdatas }}"
            signatureRrdatas: "{{ signatureRrdatas }}"
        kind: "{{ kind }}"
      healthCheck: "{{ healthCheck }}"
      kind: "{{ kind }}"
      primaryBackup:
        backupGeoTargets:
          enableFencing: {{ enableFencing }}
          items:
            - healthCheckedTargets:
                externalEndpoints: "{{ externalEndpoints }}"
                internalLoadBalancers: "{{ internalLoadBalancers }}"
              kind: "{{ kind }}"
              location: "{{ location }}"
              rrdatas: "{{ rrdatas }}"
              signatureRrdatas: "{{ signatureRrdatas }}"
          kind: "{{ kind }}"
        kind: "{{ kind }}"
        primaryTargets:
          externalEndpoints:
            - "{{ externalEndpoints }}"
          internalLoadBalancers:
            - ipAddress: "{{ ipAddress }}"
              ipProtocol: "{{ ipProtocol }}"
              kind: "{{ kind }}"
              loadBalancerType: "{{ loadBalancerType }}"
              networkUrl: "{{ networkUrl }}"
              port: "{{ port }}"
              project: "{{ project }}"
              region: "{{ region }}"
        trickleTraffic: {{ trickleTraffic }}
      wrr:
        items:
          - healthCheckedTargets:
              externalEndpoints:
                - "{{ externalEndpoints }}"
              internalLoadBalancers:
                - ipAddress: "{{ ipAddress }}"
                  ipProtocol: "{{ ipProtocol }}"
                  kind: "{{ kind }}"
                  loadBalancerType: "{{ loadBalancerType }}"
                  networkUrl: "{{ networkUrl }}"
                  port: "{{ port }}"
                  project: "{{ project }}"
                  region: "{{ region }}"
            kind: "{{ kind }}"
            rrdatas: "{{ rrdatas }}"
            signatureRrdatas: "{{ signatureRrdatas }}"
            weight: {{ weight }}
        kind: "{{ kind }}"
  - name: rrdatas
    value:
      - "{{ rrdatas }}"
    description: |
      As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
  - name: signatureRrdatas
    value:
      - "{{ signatureRrdatas }}"
    description: |
      As defined in RFC 4034 (section 3.2).
  - name: ttl
    value: {{ ttl }}
    description: |
      Number of seconds that this `ResourceRecordSet` can be cached by resolvers.
  - name: type
    value: "{{ type }}"
    description: |
      The identifier of a supported record type. See the list of Supported DNS record types.
  - name: clientOperationId
    value: "{{ clientOperationId }}"

UPDATE examples

patch

Applies a partial update to an existing ResourceRecordSet.

UPDATE google.dns.resource_record_sets
SET 
data__kind = '{{ kind }}',
data__name = '{{ name }}',
data__routingPolicy = '{{ routingPolicy }}',
data__rrdatas = '{{ rrdatas }}',
data__signatureRrdatas = '{{ signatureRrdatas }}',
data__ttl = {{ ttl }},
data__type = '{{ type }}'
WHERE 
project = '{{ project }}' --required
AND managedZone = '{{ managedZone }}' --required
AND name = '{{ name }}' --required
AND type = '{{ type }}' --required
AND clientOperationId = '{{ clientOperationId}}'
RETURNING
name,
kind,
routingPolicy,
rrdatas,
signatureRrdatas,
ttl,
type;

DELETE examples

delete

Deletes a previously created ResourceRecordSet.

DELETE FROM google.dns.resource_record_sets
WHERE project = '{{ project }}' --required
AND managedZone = '{{ managedZone }}' --required
AND name = '{{ name }}' --required
AND type = '{{ type }}' --required
AND clientOperationId = '{{ clientOperationId }}'
;