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

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

<style>

body, h1, h2, h3, div, span, p, pre, a {

margin: 0;

padding: 0;

border: 0;

font-weight: inherit;

9

font-style: inherit;

10

font-size: 100%;

11

font-family: inherit;

12

vertical-align: baseline;

}

body {

font-size: 13px;

padding: 1em;

}

h1 {

font-size: 26px;

margin-bottom: 1em;

}

h2 {

font-size: 24px;

margin-bottom: 1em;

}

h3 {

font-size: 20px;

margin-bottom: 1em;

margin-top: 1em;

}

pre, code {

line-height: 1.5;

font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;

}

pre {

margin-top: 0.5em;

}

h1, h2, h3, p {

font-family: Arial, sans serif;

}

h1, h2, h3 {

border-bottom: solid #CCC 1px;

}

.toc_element {

margin-top: 0.5em;

}

.firstline {

margin-left: 2 em;

}

.method {

margin-top: 1em;

border: solid 1px #CCC;

padding: 1em;

background: #EEE;

}

.details {

font-weight: bold;

font-size: 14px;

}

</style>

Bu Sun Kim

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

[diff] [blame^]

75

<h1><a href="dns_v1beta2.html">Cloud DNS API</a> . <a href="dns_v1beta2.changes.html">changes</a></h1>

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

76

<h2>Instance Methods</h2>

77

Bu Sun Kim

d059ad8

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

[diff] [blame^]

78

<code><a href="#create">create(project, managedZone, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>

79

<p class="firstline">Atomically update the ResourceRecordSet collection.</p>

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

80

Bu Sun Kim

d059ad8

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

[diff] [blame^]

81

<code><a href="#get">get(project, managedZone, changeId, clientOperationId=None, x__xgafv=None)</a></code></p>

82

<p class="firstline">Fetch the representation of an existing Change.</p>

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

83

Bu Sun Kim

d059ad8

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

[diff] [blame^]

84

<code><a href="#list">list(project, managedZone, maxResults=None, sortBy=None, pageToken=None, sortOrder=None, x__xgafv=None)</a></code></p>

85

<p class="firstline">Enumerate Changes to a ResourceRecordSet collection.</p>

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

86

87

<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>

88

<p class="firstline">Retrieves the next page of results.</p>

89

<h3>Method Details</h3>

90

Bu Sun Kim

d059ad8

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

[diff] [blame^]

91

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

92

<pre>Atomically update the ResourceRecordSet collection.

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

93

94

Args:

Bu Sun Kim

d059ad8

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

[diff] [blame^]

95

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

96

managedZone: string, Identifies the managed zone addressed by this request. Can be the managed

97

zone name or id. (required)

Dan O'Meara

dd49464

2020-05-01 07:42:23 -0700

[diff] [blame]

98

body: object, The request body.

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

99

The object takes the form of:

100

Bu Sun Kim

d059ad8

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

[diff] [blame^]

101

{ # A Change represents a set of ResourceRecordSet additions and deletions

102

# applied atomically to a ManagedZone. ResourceRecordSets within a

103

# ManagedZone are modified by creating a new Change element in the Changes

104

# collection. In turn the Changes collection also records the past

105

# modifications to the ResourceRecordSets in a ManagedZone. The current

106

# state of the ManagedZone is the sum effect of applying all Change

107

# elements in the Changes collection in sequence.

108

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

109

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

110

"status": "A String", # Status of the operation (output only). A status of "done" means that the

111

# request to update the authoritative servers has been sent, but the

112

# servers might not be updated yet.

113

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

114

# is in RFC3339 text format.

115

"kind": "dns#change",

116

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

117

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

118

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

119

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

120

# DNS record types</a>.

121

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

122

"kind": "dns#resourceRecordSet",

123

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

124

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

125

"A String",

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

126

],

Bu Sun Kim

d059ad8

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

[diff] [blame^]

127

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

128

# <a href="/dns/records/json-record">examples</a>.

129

"A String",

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

130

],

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

131

},

Bu Sun Kim

d059ad8

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

[diff] [blame^]

132

],

133

"additions": [ # Which ResourceRecordSets to add?

134

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

135

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

136

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

137

# DNS record types</a>.

138

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

139

"kind": "dns#resourceRecordSet",

140

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

141

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

142

"A String",

143

],

144

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

145

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

}

clientOperationId: string, For mutating operation requests only. An optional identifier

153

specified by the client. Must be unique for operation resources in the

154

Operations collection.

155

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

162

163

{ # A Change represents a set of ResourceRecordSet additions and deletions

164

# applied atomically to a ManagedZone. ResourceRecordSets within a

165

# ManagedZone are modified by creating a new Change element in the Changes

166

# collection. In turn the Changes collection also records the past

167

# modifications to the ResourceRecordSets in a ManagedZone. The current

168

# state of the ManagedZone is the sum effect of applying all Change

169

# elements in the Changes collection in sequence.

170

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

171

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

172

"status": "A String", # Status of the operation (output only). A status of "done" means that the

173

# request to update the authoritative servers has been sent, but the

174

# servers might not be updated yet.

175

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

176

# is in RFC3339 text format.

177

"kind": "dns#change",

178

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

179

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

180

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

181

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

182

# DNS record types</a>.

183

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

184

"kind": "dns#resourceRecordSet",

185

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

186

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

187

"A String",

188

],

189

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

190

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

"additions": [ # Which ResourceRecordSets to add?

196

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

197

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

198

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

199

# DNS record types</a>.

200

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

201

"kind": "dns#resourceRecordSet",

202

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

203

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

204

"A String",

205

],

206

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

207

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

}</pre>

</div>

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

217

<pre>Fetch the representation of an existing Change.

218

219

Args:

220

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

221

managedZone: string, Identifies the managed zone addressed by this request. Can be the managed

222

zone name or id. (required)

223

changeId: string, The identifier of the requested change, from a previous

224

ResourceRecordSetsChangeResponse. (required)

225

clientOperationId: string, For mutating operation requests only. An optional identifier

226

specified by the client. Must be unique for operation resources in the

227

Operations collection.

228

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

235

236

{ # A Change represents a set of ResourceRecordSet additions and deletions

237

# applied atomically to a ManagedZone. ResourceRecordSets within a

238

# ManagedZone are modified by creating a new Change element in the Changes

239

# collection. In turn the Changes collection also records the past

240

# modifications to the ResourceRecordSets in a ManagedZone. The current

241

# state of the ManagedZone is the sum effect of applying all Change

242

# elements in the Changes collection in sequence.

243

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

244

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

245

"status": "A String", # Status of the operation (output only). A status of "done" means that the

246

# request to update the authoritative servers has been sent, but the

247

# servers might not be updated yet.

248

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

249

# is in RFC3339 text format.

250

"kind": "dns#change",

251

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

252

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

253

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

254

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

255

# DNS record types</a>.

256

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

257

"kind": "dns#resourceRecordSet",

258

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

259

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

260

"A String",

261

],

262

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

263

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

"additions": [ # Which ResourceRecordSets to add?

269

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

270

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

271

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

272

# DNS record types</a>.

273

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

274

"kind": "dns#resourceRecordSet",

275

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

276

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

277

"A String",

278

],

279

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

280

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

}</pre>

</div>

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

290

<pre>Enumerate Changes to a ResourceRecordSet collection.

291

292

Args:

293

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

294

managedZone: string, Identifies the managed zone addressed by this request. Can be the managed

295

zone name or id. (required)

296

maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the

297

server will decide how many results to return.

298

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

299

pageToken: string, Optional. A tag returned by a previous list request that was truncated.

300

Use this parameter to continue a previous list request.

301

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

302

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

309

310

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

311

# collection.

312

"nextPageToken": "A String", # The presence of this field indicates that there exist more results

313

# following your last page of results in pagination order. To fetch them,

314

# make another list request using this value as your pagination token.

315

#

316

# In this way you can retrieve the complete contents of even very large

317

# collections one page at a time. However, if the contents of the collection

318

# change between the first and last paginated list request, the set of all

319

# elements returned will be an inconsistent view of the collection. There is

320

# no way to retrieve a "snapshot" of collections larger than the maximum

321

# page size.

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

322

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

Bu Sun Kim

d059ad8

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

[diff] [blame^]

323

"header": { # Elements common to every response.

324

"operationId": "A String", # For mutating operation requests that completed successfully.

325

# This is the client_operation_id if the client specified it,

326

# otherwise it is generated by the server (output only).

327

},

328

"changes": [ # The requested changes.

329

{ # A Change represents a set of ResourceRecordSet additions and deletions

330

# applied atomically to a ManagedZone. ResourceRecordSets within a

331

# ManagedZone are modified by creating a new Change element in the Changes

332

# collection. In turn the Changes collection also records the past

333

# modifications to the ResourceRecordSets in a ManagedZone. The current

334

# state of the ManagedZone is the sum effect of applying all Change

335

# elements in the Changes collection in sequence.

336

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

337

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

338

"status": "A String", # Status of the operation (output only). A status of "done" means that the

339

# request to update the authoritative servers has been sent, but the

340

# servers might not be updated yet.

341

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

342

# is in RFC3339 text format.

343

"kind": "dns#change",

344

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

345

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

346

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

347

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

348

# DNS record types</a>.

349

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

350

"kind": "dns#resourceRecordSet",

351

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

352

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

353

"A String",

354

],

355

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

356

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

"additions": [ # Which ResourceRecordSets to add?

362

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

363

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

364

# <a href="/dns/docs/overview#supported_dns_record_types">Supported

365

# DNS record types</a>.

366

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

367

"kind": "dns#resourceRecordSet",

368

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

369

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

370

"A String",

371

],

372

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

373

# <a href="/dns/records/json-record">examples</a>.

"A String",

],

},

],

},

],

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

}</pre>

</div>

<code class="details" id="list_next">list_next(previous_request, previous_response)</code>

385

<pre>Retrieves the next page of results.

386

387

Args:

388

previous_request: The request for the previous page. (required)

389

previous_response: The response from the request for the previous page. (required)

390

391

Returns:

Bu Sun Kim

6502091

2020-05-20 12:08:20 -0700

[diff] [blame]

392

A request object that you can call 'execute()' on to request the next

Bu Sun Kim

715bd7f

2019-06-14 16:50:42 -0700

[diff] [blame]

393

page. Returns None if there are no more items in the collection.

</pre>

</div>

</body></html>