Blame - docs/dyn/dns_v1.changes.html - platform/external/python/google-api-python-client

2020-11-25 07:50:41 -0800

[diff] [blame^]

109

"additions": [ # Which ResourceRecordSets to add?

110

{ # A unit of data that will be returned by the DNS servers.

111

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

112

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

117

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

118

"A String",

119

],

120

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

127

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

128

"geoPolicy": {

129

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

130

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

131

{

132

"location": "A 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.

133

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

143

{

144

"location": "A 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.

145

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

154

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

155

"kind": "dns#rRSetRoutingPolicy",

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

156

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

157

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

158

"A String",

159

],

160

"kind": "dns#resourceRecordSet",

161

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

162

"A String",

163

],

164

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

165

"name": "A String", # For example, www.example.com.

166

},

167

],

168

"deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly.

169

{ # A unit of data that will be returned by the DNS servers.

170

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

171

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

176

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

177

"A String",

178

],

179

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

186

},

187

"geoPolicy": {

188

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

189

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

190

{

191

"location": "A 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.

192

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

202

{

203

"location": "A 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.

204

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

},

"kind": "dns#rRSetRoutingPolicy",

215

},

216

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

217

"A String",

218

],

219

"kind": "dns#resourceRecordSet",

220

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

221

"A String",

222

],

223

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

224

"name": "A String", # For example, www.example.com.

225

},

226

],

227

"isServing": True or False, # If the DNS queries for the zone will be served.

228

"id": "A String", # Unique identifier for the resource; defined by the server (output only).

229

"startTime": "A String", # The time that this operation was started by the server (output only). This is in RFC3339 text format.

230

"kind": "dns#change",

231

"status": "A String", # Status of the operation (output only). A status of "done" means that the request to update the authoritative servers has been sent but the servers might not be updated yet.

232

}

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

233

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

234

clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

235

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

242

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

243

{ # A Change represents a set of ResourceRecordSet additions and deletions applied atomically to a ManagedZone. ResourceRecordSets within a ManagedZone are modified by creating a new Change element in the Changes collection. In turn the Changes collection also records the past modifications to the ResourceRecordSets in a ManagedZone. The current state of the ManagedZone is the sum effect of applying all Change elements in the Changes collection in sequence.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

244

"additions": [ # Which ResourceRecordSets to add?

245

{ # A unit of data that will be returned by the DNS servers.

246

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

247

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

252

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

253

"A String",

254

],

255

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

262

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

263

"geoPolicy": {

264

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

265

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

266

{

267

"location": "A 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.

268

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

278

{

279

"location": "A 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.

280

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

289

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

290

"kind": "dns#rRSetRoutingPolicy",

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

291

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

292

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

293

"A String",

294

],

295

"kind": "dns#resourceRecordSet",

296

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

297

"A String",

298

],

299

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

300

"name": "A String", # For example, www.example.com.

301

},

302

],

303

"deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly.

304

{ # A unit of data that will be returned by the DNS servers.

305

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

306

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

311

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

312

"A String",

313

],

314

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

321

},

322

"geoPolicy": {

323

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

324

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

325

{

326

"location": "A 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.

327

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

337

{

338

"location": "A 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.

339

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

},

"kind": "dns#rRSetRoutingPolicy",

350

},

351

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

352

"A String",

353

],

354

"kind": "dns#resourceRecordSet",

355

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

356

"A String",

357

],

358

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

359

"name": "A String", # For example, www.example.com.

360

},

361

],

362

"isServing": True or False, # If the DNS queries for the zone will be served.

363

"id": "A String", # Unique identifier for the resource; defined by the server (output only).

364

"startTime": "A String", # The time that this operation was started by the server (output only). This is in RFC3339 text format.

365

"kind": "dns#change",

366

"status": "A String", # Status of the operation (output only). A status of "done" means that the request to update the authoritative servers has been sent but the servers might not be updated yet.

367

}</pre>

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

</div>

<code class="details" id="get">get(project, managedZone, changeId, clientOperationId=None, x__xgafv=None)</code>

372

<pre>Fetch the representation of an existing Change.

373

374

Args:

375

project: string, Identifies the project addressed by this request. (required)

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

376

managedZone: string, Identifies the managed zone addressed by this request. Can be the managed zone name or ID. (required)

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

377

changeId: string, The identifier of the requested change, from a previous ResourceRecordSetsChangeResponse. (required)

378

clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

379

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

386

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

387

{ # A Change represents a set of ResourceRecordSet additions and deletions applied atomically to a ManagedZone. ResourceRecordSets within a ManagedZone are modified by creating a new Change element in the Changes collection. In turn the Changes collection also records the past modifications to the ResourceRecordSets in a ManagedZone. The current state of the ManagedZone is the sum effect of applying all Change elements in the Changes collection in sequence.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

388

"additions": [ # Which ResourceRecordSets to add?

389

{ # A unit of data that will be returned by the DNS servers.

390

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

391

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

396

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

397

"A String",

398

],

399

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

406

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

407

"geoPolicy": {

408

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

409

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

410

{

411

"location": "A 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.

412

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

422

{

423

"location": "A 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.

424

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

433

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

434

"kind": "dns#rRSetRoutingPolicy",

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

435

},

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

436

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

437

"A String",

438

],

439

"kind": "dns#resourceRecordSet",

440

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

441

"A String",

442

],

443

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

444

"name": "A String", # For example, www.example.com.

445

},

446

],

447

"deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly.

448

{ # A unit of data that will be returned by the DNS servers.

449

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

450

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

455

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

456

"A String",

457

],

458

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

465

},

466

"geoPolicy": {

467

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

468

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

469

{

470

"location": "A 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.

471

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

481

{

482

"location": "A 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.

483

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

},

"kind": "dns#rRSetRoutingPolicy",

494

},

495

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

496

"A String",

497

],

498

"kind": "dns#resourceRecordSet",

499

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

500

"A String",

501

],

502

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

503

"name": "A String", # For example, www.example.com.

504

},

505

],

506

"isServing": True or False, # If the DNS queries for the zone will be served.

507

"id": "A String", # Unique identifier for the resource; defined by the server (output only).

508

"startTime": "A String", # The time that this operation was started by the server (output only). This is in RFC3339 text format.

509

"kind": "dns#change",

510

"status": "A String", # Status of the operation (output only). A status of "done" means that the request to update the authoritative servers has been sent but the servers might not be updated yet.

511

}</pre>

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

</div>

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

515

<code class="details" id="list">list(project, managedZone, maxResults=None, sortBy=None, pageToken=None, sortOrder=None, x__xgafv=None)</code>

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

516

<pre>Enumerate Changes to a ResourceRecordSet collection.

517

518

Args:

519

project: string, Identifies the project addressed by this request. (required)

Bu Sun Kim

2020-11-16 11:05:03 -0700

[diff] [blame]

520

managedZone: string, Identifies the managed zone addressed by this request. Can be the managed zone name or ID. (required)

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

521

maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the server will decide how many results to return.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

522

sortBy: string, Sorting criterion. The only supported value is change sequence.

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

523

Allowed values

524

changeSequence -

Yoshi Automation Bot

c2228be

2020-11-24 15:48:03 -0800

[diff] [blame]

525

pageToken: string, Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

526

sortOrder: string, Sorting order direction: 'ascending' or 'descending'.

Bu Sun Kim

2020-07-22 17:02:09 -0700

[diff] [blame]

527

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

534

Dmitry Frenkel

2020-10-06 16:46:05 -0700

[diff] [blame]

535

{ # The response to a request to enumerate Changes to a ResourceRecordSets collection.

Yoshi Automation Bot

2020-11-25 07:50:41 -0800

[diff] [blame^]

536

"kind": "dns#changesListResponse", # Type of resource.

537

"changes": [ # The requested changes.

538

{ # A Change represents a set of ResourceRecordSet additions and deletions applied atomically to a ManagedZone. ResourceRecordSets within a ManagedZone are modified by creating a new Change element in the Changes collection. In turn the Changes collection also records the past modifications to the ResourceRecordSets in a ManagedZone. The current state of the ManagedZone is the sum effect of applying all Change elements in the Changes collection in sequence.

539

"additions": [ # Which ResourceRecordSets to add?

540

{ # A unit of data that will be returned by the DNS servers.

541

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

542

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

547

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

548

"A String",

549

],

550

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

557

},

558

"geoPolicy": {

559

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

560

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

561

{

562

"location": "A 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.

563

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

573

{

574

"location": "A 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.

575

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

},

"kind": "dns#rRSetRoutingPolicy",

586

},

587

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

588

"A String",

589

],

590

"kind": "dns#resourceRecordSet",

591

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

592

"A String",

593

],

594

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

595

"name": "A String", # For example, www.example.com.

596

},

597

],

598

"deletions": [ # Which ResourceRecordSets to remove? Must match existing data exactly.

599

{ # A unit of data that will be returned by the DNS servers.

600

"type": "A String", # The identifier of a supported record type. See the list of Supported DNS record types.

601

"routingPolicy": { # 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.

"wrrPolicy": {

"items": [

{

"kind": "dns#rRSetRoutingPolicyWrrPolicyWrrPolicyItem",

606

"signatureRrdatas": [ # DNSSEC generated signatures for the above wrr_rrdata.

607

"A String",

608

],

609

"weight": 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].

"rrdatas": [

"A String",

],

},

],

"kind": "dns#rRSetRoutingPolicyWrrPolicy",

616

},

617

"geoPolicy": {

618

"kind": "dns#rRSetRoutingPolicyGeoPolicy",

619

"items": [ # The primary geo routing configuration. If there are multiple items with the same location, an error is returned instead.

620

{

621

"location": "A 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.

622

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

"failovers": [ # 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't be healthchecked - we'll return the primarily configured rrdata irrespective of whether it is healthy or not.

632

{

633

"location": "A 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.

634

"kind": "dns#rRSetRoutingPolicyGeoPolicyGeoPolicyItem",

"rrdatas": [

"A String",

],

"signatureRrdatas": [ # DNSSEC generated signatures for the above geo_rrdata.

"A String",

],

},

],

},

"kind": "dns#rRSetRoutingPolicy",

645

},

646

"signatureRrdatas": [ # As defined in RFC 4034 (section 3.2).

647

"A String",

648

],

649

"kind": "dns#resourceRecordSet",

650

"rrdatas": [ # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see examples.

651

"A String",

652

],

653

"ttl": 42, # Number of seconds that this ResourceRecordSet can be cached by resolvers.

654

"name": "A String", # For example, www.example.com.

655

},

656

],

657

"isServing": True or False, # If the DNS queries for the zone will be served.

658

"id": "A String", # Unique identifier for the resource; defined by the server (output only).

659

"startTime": "A String", # The time that this operation was started by the server (output only). This is in RFC3339 text format.

660

"kind": "dns#change",

661

"status": "A String", # Status of the operation (output only). A status of "done" means that the request to update the authoritative servers has been sent but the servers might not be updated yet.

662

},

663

],

Bu Sun Kim