dns_record_sets
Creates, updates, deletes, gets or lists a dns_record_sets
resource.
Overview
Name | dns_record_sets |
Type | Resource |
Id | google.servicenetworking.dns_record_sets |
Fields
The following fields are returned by SELECT
queries:
- list
Successful response
Name | Datatype | Description |
---|---|---|
dnsRecordSets | array | DNS record Set Resource |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
list | select | servicesId | consumerNetwork , zone | Producers can use this method to retrieve a list of available DNS RecordSets available inside the private zone on the tenant host project accessible from their network. |
add | insert | servicesId | Service producers can use this method to add DNS record sets to private DNS zones in the shared producer host project. | |
update | update | servicesId | Service producers can use this method to update DNS record sets from private DNS zones in the shared producer host project. | |
remove | delete | servicesId | Service producers can use this method to remove DNS record sets from private DNS zones in the shared producer host project. |
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 |
---|---|---|
servicesId | string | |
consumerNetwork | string | |
zone | string |
SELECT
examples
- list
Producers can use this method to retrieve a list of available DNS RecordSets available inside the private zone on the tenant host project accessible from their network.
SELECT
dnsRecordSets
FROM google.servicenetworking.dns_record_sets
WHERE servicesId = '{{ servicesId }}' -- required
AND consumerNetwork = '{{ consumerNetwork }}'
AND zone = '{{ zone }}';
INSERT
examples
- add
- Manifest
Service producers can use this method to add DNS record sets to private DNS zones in the shared producer host project.
INSERT INTO google.servicenetworking.dns_record_sets (
data__consumerNetwork,
data__zone,
data__dnsRecordSet,
servicesId
)
SELECT
'{{ consumerNetwork }}',
'{{ zone }}',
'{{ dnsRecordSet }}',
'{{ servicesId }}'
RETURNING
name,
done,
error,
metadata,
response
;
# Description fields are for documentation purposes
- name: dns_record_sets
props:
- name: servicesId
value: string
description: Required parameter for the dns_record_sets resource.
- name: consumerNetwork
value: string
description: >
Required. The network that the consumer is using to connect with services. Must be in the form of projects/{project}/global/networks/{network} {project} is the project number, as in '12345' {network} is the network name.
- name: zone
value: string
description: >
Required. The name of the private DNS zone in the shared producer host project to which the record set will be added.
- name: dnsRecordSet
value: object
description: >
Required. The DNS record set to add.
UPDATE
examples
- update
Service producers can use this method to update DNS record sets from private DNS zones in the shared producer host project.
UPDATE google.servicenetworking.dns_record_sets
SET
data__consumerNetwork = '{{ consumerNetwork }}',
data__zone = '{{ zone }}',
data__existingDnsRecordSet = '{{ existingDnsRecordSet }}',
data__newDnsRecordSet = '{{ newDnsRecordSet }}'
WHERE
servicesId = '{{ servicesId }}' --required
RETURNING
name,
done,
error,
metadata,
response;
DELETE
examples
- remove
Service producers can use this method to remove DNS record sets from private DNS zones in the shared producer host project.
DELETE FROM google.servicenetworking.dns_record_sets
WHERE servicesId = '{{ servicesId }}' --required;