ResourceRecordSets

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.