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

Successful response

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

Successful response

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	maxResults, pageToken, name, 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
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 maxResults = '{{ maxResults }}'
AND pageToken = '{{ pageToken }}'
AND name = '{{ name }}'
AND type = '{{ type }}';

INSERT examples

create

Creates a new ResourceRecordSet.

INSERT INTO google.dns.resource_record_sets (
data__name,
data__type,
data__ttl,
data__rrdatas,
data__signatureRrdatas,
data__routingPolicy,
data__kind,
project,
managedZone,
clientOperationId
)
SELECT 
'{{ name }}',
'{{ type }}',
{{ ttl }},
'{{ rrdatas }}',
'{{ signatureRrdatas }}',
'{{ routingPolicy }}',
'{{ kind }}',
'{{ 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: string
      description: Required parameter for the resource_record_sets resource.
    - name: managedZone
      value: string
      description: Required parameter for the resource_record_sets resource.
    - name: name
      value: string
      description: >
        For example, www.example.com.
        
    - name: type
      value: string
      description: >
        The identifier of a supported record type. See the list of Supported DNS record types.
        
    - name: ttl
      value: integer
      description: >
        Number of seconds that this `ResourceRecordSet` can be cached by resolvers.
        
    - name: rrdatas
      value: array
      description: >
        As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
        
    - name: signatureRrdatas
      value: array
      description: >
        As defined in RFC 4034 (section 3.2).
        
    - name: routingPolicy
      value: object
      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).
        
    - name: kind
      value: string
      default: dns#resourceRecordSet
    - name: clientOperationId
      value: string

UPDATE examples

patch

Applies a partial update to an existing ResourceRecordSet.

UPDATE google.dns.resource_record_sets
SET 
data__name = '{{ name }}',
data__type = '{{ type }}',
data__ttl = {{ ttl }},
data__rrdatas = '{{ rrdatas }}',
data__signatureRrdatas = '{{ signatureRrdatas }}',
data__routingPolicy = '{{ routingPolicy }}',
data__kind = '{{ kind }}'
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 }}';