blob: 914435e730344f839843c91c1ea3d61c94707c85 [file] [log] [blame]
Bu Sun Kim673ec5c2020-11-16 11:05:03 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="dns_v1beta2.html">Cloud DNS API</a> . <a href="dns_v1beta2.projects.html">projects</a> . <a href="dns_v1beta2.projects.managedZones.html">managedZones</a> . <a href="dns_v1beta2.projects.managedZones.rrsets.html">rrsets</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
81 <code><a href="#create">create(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Create a new ResourceRecordSet.</p>
83<p class="toc_element">
84 <code><a href="#delete">delete(project, managedZone, name, type, clientOperationId=None, x__xgafv=None)</a></code></p>
85<p class="firstline">Delete a previously created ResourceRecordSet.</p>
86<p class="toc_element">
87 <code><a href="#get">get(project, managedZone, name, type, clientOperationId=None, x__xgafv=None)</a></code></p>
88<p class="firstline">Fetch the representation of an existing ResourceRecordSet.</p>
89<p class="toc_element">
90 <code><a href="#patch">patch(project, managedZone, name, type, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
91<p class="firstline">Apply a partial update to an existing ResourceRecordSet.</p>
92<h3>Method Details</h3>
93<div class="method">
94 <code class="details" id="close">close()</code>
95 <pre>Close httplib2 connections.</pre>
96</div>
97
98<div class="method">
99 <code class="details" id="create">create(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)</code>
100 <pre>Create a new ResourceRecordSet.
101
102Args:
103 project: string, Identifies the project addressed by this request. (required)
104 managedZone: string, Identifies the managed zone addressed by this request. Can be the managed zone name or ID. (required)
105 body: object, The request body.
106 The object takes the form of:
107
108{ # A unit of data that will be returned by the DNS servers.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800109 &quot;kind&quot;: &quot;dns#resourceRecordSet&quot;,
110 &quot;name&quot;: &quot;A String&quot;, # For example, www.example.com.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700111 &quot;routingPolicy&quot;: { # A RRSetRoutingPolicy represents ResourceRecordSet data that will be returned dynamically with the response varying based on configured properties such as geolocation or by weighted random selection. # 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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800112 &quot;geoPolicy&quot;: {
113 &quot;failovers&quot;: [ # If the health check for the primary target for a geo location returns an unhealthy status, the failover target is returned instead. This failover configuration is not mandatory. If a failover is not provided, the primary target won&#x27;t be healthchecked - we&#x27;ll return the primarily configured rrdata irrespective of whether it is healthy or not.
114 {
115 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
116 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
117 &quot;rrdatas&quot;: [
118 &quot;A String&quot;,
119 ],
120 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
121 &quot;A String&quot;,
122 ],
123 },
124 ],
125 &quot;items&quot;: [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.
126 {
127 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
128 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
129 &quot;rrdatas&quot;: [
130 &quot;A String&quot;,
131 ],
132 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
133 &quot;A String&quot;,
134 ],
135 },
136 ],
137 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicy&quot;,
138 },
139 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicy&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800140 &quot;wrrPolicy&quot;: {
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800141 &quot;items&quot;: [
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800142 {
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800143 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem&quot;,
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800144 &quot;rrdatas&quot;: [
145 &quot;A String&quot;,
146 ],
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800147 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above wrr_rrdata.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800148 &quot;A String&quot;,
149 ],
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800150 &quot;weight&quot;: 3.14, # 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 should be a decimal in the range [0,1].
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800151 },
152 ],
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800153 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicy&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800154 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700155 },
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800156 &quot;rrdatas&quot;: [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
157 &quot;A String&quot;,
158 ],
159 &quot;signatureRrdatas&quot;: [ # As defined in RFC 4034 (section 3.2).
160 &quot;A String&quot;,
161 ],
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800162 &quot;ttl&quot;: 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.
163 &quot;type&quot;: &quot;A String&quot;, # The identifier of a supported record type. See the list of Supported DNS record types.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700164}
165
166 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
167 x__xgafv: string, V1 error format.
168 Allowed values
169 1 - v1 error format
170 2 - v2 error format
171
172Returns:
173 An object of the form:
174
175 { # A unit of data that will be returned by the DNS servers.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800176 &quot;kind&quot;: &quot;dns#resourceRecordSet&quot;,
177 &quot;name&quot;: &quot;A String&quot;, # For example, www.example.com.
178 &quot;routingPolicy&quot;: { # A RRSetRoutingPolicy represents ResourceRecordSet data that will be returned dynamically with the response varying based on configured properties such as geolocation or by weighted random selection. # 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.
179 &quot;geoPolicy&quot;: {
180 &quot;failovers&quot;: [ # If the health check for the primary target for a geo location returns an unhealthy status, the failover target is returned instead. This failover configuration is not mandatory. If a failover is not provided, the primary target won&#x27;t be healthchecked - we&#x27;ll return the primarily configured rrdata irrespective of whether it is healthy or not.
181 {
182 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
183 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
184 &quot;rrdatas&quot;: [
185 &quot;A String&quot;,
186 ],
187 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
188 &quot;A String&quot;,
189 ],
190 },
191 ],
192 &quot;items&quot;: [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.
193 {
194 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
195 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
196 &quot;rrdatas&quot;: [
197 &quot;A String&quot;,
198 ],
199 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
200 &quot;A String&quot;,
201 ],
202 },
203 ],
204 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicy&quot;,
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700205 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800206 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicy&quot;,
207 &quot;wrrPolicy&quot;: {
208 &quot;items&quot;: [
209 {
210 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem&quot;,
211 &quot;rrdatas&quot;: [
212 &quot;A String&quot;,
213 ],
214 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above wrr_rrdata.
215 &quot;A String&quot;,
216 ],
217 &quot;weight&quot;: 3.14, # 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 should be a decimal in the range [0,1].
218 },
219 ],
220 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicy&quot;,
221 },
222 },
223 &quot;rrdatas&quot;: [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
224 &quot;A String&quot;,
225 ],
226 &quot;signatureRrdatas&quot;: [ # As defined in RFC 4034 (section 3.2).
227 &quot;A String&quot;,
228 ],
229 &quot;ttl&quot;: 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.
230 &quot;type&quot;: &quot;A String&quot;, # The identifier of a supported record type. See the list of Supported DNS record types.
231}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700232</div>
233
234<div class="method">
235 <code class="details" id="delete">delete(project, managedZone, name, type, clientOperationId=None, x__xgafv=None)</code>
236 <pre>Delete a previously created ResourceRecordSet.
237
238Args:
239 project: string, Identifies the project addressed by this request. (required)
240 managedZone: string, Identifies the managed zone addressed by this request. Can be the managed zone name or ID. (required)
241 name: string, Fully qualified domain name. (required)
242 type: string, RRSet type. (required)
243 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
244 x__xgafv: string, V1 error format.
245 Allowed values
246 1 - v1 error format
247 2 - v2 error format
248
249Returns:
250 An object of the form:
251
252 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800253}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700254</div>
255
256<div class="method">
257 <code class="details" id="get">get(project, managedZone, name, type, clientOperationId=None, x__xgafv=None)</code>
258 <pre>Fetch the representation of an existing ResourceRecordSet.
259
260Args:
261 project: string, Identifies the project addressed by this request. (required)
262 managedZone: string, Identifies the managed zone addressed by this request. Can be the managed zone name or ID. (required)
263 name: string, Fully qualified domain name. (required)
264 type: string, RRSet type. (required)
265 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
266 x__xgafv: string, V1 error format.
267 Allowed values
268 1 - v1 error format
269 2 - v2 error format
270
271Returns:
272 An object of the form:
273
274 { # A unit of data that will be returned by the DNS servers.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800275 &quot;kind&quot;: &quot;dns#resourceRecordSet&quot;,
276 &quot;name&quot;: &quot;A String&quot;, # For example, www.example.com.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700277 &quot;routingPolicy&quot;: { # A RRSetRoutingPolicy represents ResourceRecordSet data that will be returned dynamically with the response varying based on configured properties such as geolocation or by weighted random selection. # 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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800278 &quot;geoPolicy&quot;: {
279 &quot;failovers&quot;: [ # If the health check for the primary target for a geo location returns an unhealthy status, the failover target is returned instead. This failover configuration is not mandatory. If a failover is not provided, the primary target won&#x27;t be healthchecked - we&#x27;ll return the primarily configured rrdata irrespective of whether it is healthy or not.
280 {
281 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
282 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
283 &quot;rrdatas&quot;: [
284 &quot;A String&quot;,
285 ],
286 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
287 &quot;A String&quot;,
288 ],
289 },
290 ],
291 &quot;items&quot;: [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.
292 {
293 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
294 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
295 &quot;rrdatas&quot;: [
296 &quot;A String&quot;,
297 ],
298 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
299 &quot;A String&quot;,
300 ],
301 },
302 ],
303 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicy&quot;,
304 },
305 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicy&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800306 &quot;wrrPolicy&quot;: {
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800307 &quot;items&quot;: [
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800308 {
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800309 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem&quot;,
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800310 &quot;rrdatas&quot;: [
311 &quot;A String&quot;,
312 ],
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800313 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above wrr_rrdata.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800314 &quot;A String&quot;,
315 ],
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800316 &quot;weight&quot;: 3.14, # 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 should be a decimal in the range [0,1].
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800317 },
318 ],
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800319 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicy&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800320 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700321 },
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800322 &quot;rrdatas&quot;: [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
323 &quot;A String&quot;,
324 ],
325 &quot;signatureRrdatas&quot;: [ # As defined in RFC 4034 (section 3.2).
326 &quot;A String&quot;,
327 ],
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800328 &quot;ttl&quot;: 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.
329 &quot;type&quot;: &quot;A String&quot;, # The identifier of a supported record type. See the list of Supported DNS record types.
330}</pre>
331</div>
332
333<div class="method">
334 <code class="details" id="patch">patch(project, managedZone, name, type, body=None, clientOperationId=None, x__xgafv=None)</code>
335 <pre>Apply a partial update to an existing ResourceRecordSet.
336
337Args:
338 project: string, Identifies the project addressed by this request. (required)
339 managedZone: string, Identifies the managed zone addressed by this request. Can be the managed zone name or ID. (required)
340 name: string, Fully qualified domain name. (required)
341 type: string, RRSet type. (required)
342 body: object, The request body.
343 The object takes the form of:
344
345{ # A unit of data that will be returned by the DNS servers.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800346 &quot;kind&quot;: &quot;dns#resourceRecordSet&quot;,
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800347 &quot;name&quot;: &quot;A String&quot;, # For example, www.example.com.
348 &quot;routingPolicy&quot;: { # A RRSetRoutingPolicy represents ResourceRecordSet data that will be returned dynamically with the response varying based on configured properties such as geolocation or by weighted random selection. # 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.
349 &quot;geoPolicy&quot;: {
350 &quot;failovers&quot;: [ # If the health check for the primary target for a geo location returns an unhealthy status, the failover target is returned instead. This failover configuration is not mandatory. If a failover is not provided, the primary target won&#x27;t be healthchecked - we&#x27;ll return the primarily configured rrdata irrespective of whether it is healthy or not.
351 {
352 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
353 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
354 &quot;rrdatas&quot;: [
355 &quot;A String&quot;,
356 ],
357 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
358 &quot;A String&quot;,
359 ],
360 },
361 ],
362 &quot;items&quot;: [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.
363 {
364 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
365 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
366 &quot;rrdatas&quot;: [
367 &quot;A String&quot;,
368 ],
369 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
370 &quot;A String&quot;,
371 ],
372 },
373 ],
374 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicy&quot;,
375 },
376 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicy&quot;,
377 &quot;wrrPolicy&quot;: {
378 &quot;items&quot;: [
379 {
380 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem&quot;,
381 &quot;rrdatas&quot;: [
382 &quot;A String&quot;,
383 ],
384 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above wrr_rrdata.
385 &quot;A String&quot;,
386 ],
387 &quot;weight&quot;: 3.14, # 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 should be a decimal in the range [0,1].
388 },
389 ],
390 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicy&quot;,
391 },
392 },
393 &quot;rrdatas&quot;: [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
394 &quot;A String&quot;,
395 ],
396 &quot;signatureRrdatas&quot;: [ # As defined in RFC 4034 (section 3.2).
397 &quot;A String&quot;,
398 ],
399 &quot;ttl&quot;: 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.
400 &quot;type&quot;: &quot;A String&quot;, # The identifier of a supported record type. See the list of Supported DNS record types.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700401}
402
403 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
404 x__xgafv: string, V1 error format.
405 Allowed values
406 1 - v1 error format
407 2 - v2 error format
408
409Returns:
410 An object of the form:
411
412 { # A unit of data that will be returned by the DNS servers.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800413 &quot;kind&quot;: &quot;dns#resourceRecordSet&quot;,
414 &quot;name&quot;: &quot;A String&quot;, # For example, www.example.com.
415 &quot;routingPolicy&quot;: { # A RRSetRoutingPolicy represents ResourceRecordSet data that will be returned dynamically with the response varying based on configured properties such as geolocation or by weighted random selection. # 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.
416 &quot;geoPolicy&quot;: {
417 &quot;failovers&quot;: [ # If the health check for the primary target for a geo location returns an unhealthy status, the failover target is returned instead. This failover configuration is not mandatory. If a failover is not provided, the primary target won&#x27;t be healthchecked - we&#x27;ll return the primarily configured rrdata irrespective of whether it is healthy or not.
418 {
419 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
420 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
421 &quot;rrdatas&quot;: [
422 &quot;A String&quot;,
423 ],
424 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
425 &quot;A String&quot;,
426 ],
427 },
428 ],
429 &quot;items&quot;: [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.
430 {
431 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem&quot;,
432 &quot;location&quot;: &quot;A String&quot;, # The geo-location granularity is a GCP region. This location string should correspond to a GCP region. e.g &quot;us-east1&quot;, &quot;southamerica-east1&quot;, &quot;asia-east1&quot;, etc.
433 &quot;rrdatas&quot;: [
434 &quot;A String&quot;,
435 ],
436 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above geo_rrdata.
437 &quot;A String&quot;,
438 ],
439 },
440 ],
441 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyGeoPolicy&quot;,
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700442 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800443 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicy&quot;,
444 &quot;wrrPolicy&quot;: {
445 &quot;items&quot;: [
446 {
447 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem&quot;,
448 &quot;rrdatas&quot;: [
449 &quot;A String&quot;,
450 ],
451 &quot;signatureRrdatas&quot;: [ # DNSSEC generated signatures for the above wrr_rrdata.
452 &quot;A String&quot;,
453 ],
454 &quot;weight&quot;: 3.14, # 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 should be a decimal in the range [0,1].
455 },
456 ],
457 &quot;kind&quot;: &quot;dns#rRSetRoutingPolicyWrrPolicy&quot;,
458 },
459 },
460 &quot;rrdatas&quot;: [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.
461 &quot;A String&quot;,
462 ],
463 &quot;signatureRrdatas&quot;: [ # As defined in RFC 4034 (section 3.2).
464 &quot;A String&quot;,
465 ],
466 &quot;ttl&quot;: 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.
467 &quot;type&quot;: &quot;A String&quot;, # The identifier of a supported record type. See the list of Supported DNS record types.
468}</pre>
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700469</div>
470
471</body></html>