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

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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_v2beta1.html">Cloud DNS API</a> . <a href="dns_v2beta1.changes.html">changes</a></h1>

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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>

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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>

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[diff] [blame]

83

Bu Sun Kim

d059ad8

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

[diff] [blame]

84

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

85

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

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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.

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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.

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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

"additions": [ # Which ResourceRecordSets to add?

110

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

111

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

112

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

113

"A String",

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[diff] [blame]

114

],

Bu Sun Kim

d059ad8

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

[diff] [blame]

115

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

116

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

117

# DNS record types</a>.

118

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

119

"kind": "dns#resourceRecordSet",

120

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

121

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

122

"A String",

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[diff] [blame]

123

],

Bu Sun Kim

6502091

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

[diff] [blame]

124

},

Bu Sun Kim

d059ad8

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

[diff] [blame]

125

],

126

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

127

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

128

# servers might not be updated yet.

129

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

130

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

131

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

132

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

133

"A String",

134

],

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

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

139

"kind": "dns#resourceRecordSet",

140

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

141

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

"A String",

],

},

],

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

147

"kind": "dns#change",

148

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

149

# is in RFC3339 text format.

150

}

151

152

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

"additions": [ # Which ResourceRecordSets to add?

172

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

173

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

174

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

175

"A String",

176

],

177

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

178

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

179

# DNS record types</a>.

180

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

181

"kind": "dns#resourceRecordSet",

182

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

183

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

"A String",

],

},

],

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

189

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

190

# servers might not be updated yet.

191

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

192

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

193

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

194

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

195

"A String",

196

],

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

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

201

"kind": "dns#resourceRecordSet",

202

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

203

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

"A String",

],

},

],

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

209

"kind": "dns#change",

210

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

211

# is in RFC3339 text format.

}</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

"additions": [ # Which ResourceRecordSets to add?

245

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

246

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

247

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

248

"A String",

249

],

250

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

251

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

252

# DNS record types</a>.

253

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

254

"kind": "dns#resourceRecordSet",

255

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

256

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

"A String",

],

},

],

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

262

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

263

# servers might not be updated yet.

264

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

265

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

266

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

267

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

268

"A String",

269

],

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

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

274

"kind": "dns#resourceRecordSet",

275

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

276

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

"A String",

],

},

],

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

282

"kind": "dns#change",

283

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

284

# is in RFC3339 text format.

}</pre>

</div>

<code class="details" id="list">list(project, managedZone, pageToken=None, sortBy=None, maxResults=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

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

297

Use this parameter to continue a previous list request.

298

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

299

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

300

server will decide how many results to return.

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

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

313

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

314

# This is the client_operation_id if the client specified it,

315

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

316

},

317

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

318

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

319

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

320

#

321

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

322

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

323

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

324

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

325

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

326

# page size.

Bu Sun Kim

6502091

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

[diff] [blame]

327

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

Bu Sun Kim

d059ad8

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

[diff] [blame]

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

"additions": [ # Which ResourceRecordSets to add?

338

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

339

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

340

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

341

"A String",

342

],

343

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

344

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

345

# DNS record types</a>.

346

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

347

"kind": "dns#resourceRecordSet",

348

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

349

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

"A String",

],

},

],

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

355

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

356

# servers might not be updated yet.

357

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

358

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

359

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

360

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

361

"A String",

362

],

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

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

367

"kind": "dns#resourceRecordSet",

368

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

369

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

"A String",

],

},

],

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

375

"kind": "dns#change",

376

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

377

# is in RFC3339 text format.

378

},

379

],

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[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

John Asmuth

614db98

2014-04-24 15:46:26 -0400

[diff] [blame]

393

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

</pre>

</div>

</body></html>