For a list of methods for this resource, see the end of this page.
Resource representations
A unit of data that is returned by the DNS servers.
{ "kind": "dns#resourceRecordSet", "name": string, "type": string, "ttl": integer, "rrdatas": [ string ], "signatureRrdatas": [ string ], "routingPolicy": { "kind": "dns#rRSetRoutingPolicy", "geo": { "kind": "dns#rRSetRoutingPolicyGeoPolicy", "items": [ { "kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem", "location": string, "rrdatas": [ string ], "signatureRrdatas": [ string ] } ] }, "wrr": { "kind": "dns#rRSetRoutingPolicyWrrPolicy", "items": [ { "kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem", "weight": double, "rrdatas": [ string ], "signatureRrdatas": [ string ] } ] } } }
Property name | Value | Description | Notes |
---|---|---|---|
kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dns#resourceRecordSet" . |
|
name |
string |
For example, www.example.com. | |
routingPolicy |
nested object |
Configures dynamic query responses based on geo location of querying user or a weighted round robin based routing policy. A ResourceRecordSet should only have either rrdata (static) or routing_policy (dynamic). An error is returned otherwise. | |
routingPolicy.geo |
nested object |
||
routingPolicy.geo.items[] |
list |
The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead. | |
routingPolicy.geo.items[].kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem" . |
|
routingPolicy.geo.items[].location |
string |
The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g. "us-east1", "southamerica-east1", "asia-east1", etc. |
|
routingPolicy.geo.items[].rrdatas[] |
list |
||
routingPolicy.geo.items[].signatureRrdatas[] |
list |
DNSSEC generated signatures for the above geo_rrdata. | |
routingPolicy.geo.kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dns#rRSetRoutingPolicyGeoPolicy" . |
|
routingPolicy.kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dns#rRSetRoutingPolicy" . |
|
routingPolicy.wrr |
nested object |
||
routingPolicy.wrr.items[] |
list |
||
routingPolicy.wrr.items[].kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem" . |
|
routingPolicy.wrr.items[].rrdatas[] |
list |
||
routingPolicy.wrr.items[].signatureRrdatas[] |
list |
DNSSEC generated signatures for the above wrr_rrdata. | |
routingPolicy.wrr.items[].weight |
double |
The weight corresponding to this subset of rrdata. When multiple WeightedRoundRobinPolicyItems are configured, the probability of returning an rrset is proportional to its weight relative to the sum of weights configured for all items. This weight must be non-negative. | |
routingPolicy.wrr.kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dns#rRSetRoutingPolicyWrrPolicy" . |
|
rrdatas[] |
list |
As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples. | |
signatureRrdatas[] |
list |
As defined in RFC 4034 (section 3.2). | |
ttl |
integer |
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
- create
- Creates a new ResourceRecordSet.
- delete
- Deletes a previously created ResourceRecordSet.
- get
- Fetches the representation of an existing ResourceRecordSet.
- list
- Enumerates ResourceRecordSets that you have created but not yet deleted.
- patch
- Applies a partial update to an existing ResourceRecordSet.