Blame - docs/dyn/firebasehosting_v1beta1.projects.sites.domains.html - platform/external/python/google-api-python-client

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

[diff] [blame]

78

<code><a href="#close">close()</a></code></p>

79

<p class="firstline">Close httplib2 connections.</p>

80

Bu Sun Kim

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

[diff] [blame]

81

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

82

<p class="firstline">Creates a domain mapping on the specified site.</p>

83

84

<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>

85

<p class="firstline">Deletes the existing domain mapping on the specified site.</p>

86

87

<code><a href="#get">get(name, x__xgafv=None)</a></code></p>

88

<p class="firstline">Gets a domain mapping on the specified site.</p>

89

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

90

<code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>

Bu Sun Kim

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

[diff] [blame]

91

<p class="firstline">Lists the domains for the specified site.</p>

92

93

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

94

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

95

96

<code><a href="#update">update(name, body=None, x__xgafv=None)</a></code></p>

Dmitry Frenkel

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

[diff] [blame]

97

<p class="firstline">Updates the specified domain mapping, creating the mapping as if it does not exist.</p>

Bu Sun Kim

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

[diff] [blame]

98

<h3>Method Details</h3>

99

Dmitry Frenkel

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

[diff] [blame]

100

<code class="details" id="close">close()</code>

101

<pre>Close httplib2 connections.</pre>

</div>

Bu Sun Kim

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

[diff] [blame]

105

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

106

<pre>Creates a domain mapping on the specified site.

107

108

Args:

Dmitry Frenkel

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

[diff] [blame]

109

parent: string, Required. The parent to create the domain association for, in the format: sites/site-name (required)

Bu Sun Kim

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

[diff] [blame]

110

body: object, The request body.

111

The object takes the form of:

112

113

{ # The intended behavior and status information of a domain.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

114

"domainName": "A String", # Required. The domain name of the association.

115

"status": "A String", # Output only. Additional status of the domain association.

116

"site": "A String", # Required. The site name of the association.

117

"updateTime": "A String", # Output only. The time at which the domain was last updated.

118

"domainRedirect": { # Defines the behavior of a domain-level redirect. Domain redirects preserve the path of the redirect but replace the requested domain with the one specified in the redirect configuration. # If set, the domain should redirect with the provided parameters.

119

"domainName": "A String", # Required. The domain name to redirect to.

120

"type": "A String", # Required. The redirect status code.

121

},

122

"provisioning": { # The current certificate provisioning status information for a domain. # Output only. Information about the provisioning of certificates and the health of the DNS resolution for the domain.

123

"certChallengeHttp": { # Represents an HTTP certificate challenge. # The HTTP challenge for generating a certificate.

124

"path": "A String", # The URL path on which to serve the specified token to satisfy the certificate challenge.

125

"token": "A String", # The token to serve at the specified URL path to satisfy the certificate challenge.

Bu Sun Kim

673ec5c

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

[diff] [blame]

126

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

127

"expectedIps": [ # The list of IPs to which the domain is expected to resolve.

128

"A String",

129

],

130

"dnsFetchTime": "A String", # The time at which the last DNS fetch occurred.

131

"dnsStatus": "A String", # The DNS record match status as of the last DNS fetch.

132

"discoveredIps": [ # The IPs found at the last DNS fetch.

133

"A String",

134

],

135

"certChallengeDiscoveredTxt": [ # The TXT records (for the certificate challenge) that were found at the last DNS fetch.

136

"A String",

137

],

138

"certStatus": "A String", # The certificate provisioning status; updated when Firebase Hosting provisions an SSL certificate for the domain.

139

"certChallengeDns": { # Represents a DNS certificate challenge. # The DNS challenge for generating a certificate.

140

"domainName": "A String", # The domain name upon which the DNS challenge must be satisfied.

141

"token": "A String", # The value that must be present as a TXT record on the domain name to satisfy the challenge.

Yoshi Automation Bot

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

[diff] [blame]

142

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

143

},

144

}

Yoshi Automation Bot

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

[diff] [blame]

145

146

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

153

154

{ # The intended behavior and status information of a domain.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

155

"domainName": "A String", # Required. The domain name of the association.

156

"status": "A String", # Output only. Additional status of the domain association.

157

"site": "A String", # Required. The site name of the association.

158

"updateTime": "A String", # Output only. The time at which the domain was last updated.

159

"domainRedirect": { # Defines the behavior of a domain-level redirect. Domain redirects preserve the path of the redirect but replace the requested domain with the one specified in the redirect configuration. # If set, the domain should redirect with the provided parameters.

160

"domainName": "A String", # Required. The domain name to redirect to.

161

"type": "A String", # Required. The redirect status code.

162

},

163

"provisioning": { # The current certificate provisioning status information for a domain. # Output only. Information about the provisioning of certificates and the health of the DNS resolution for the domain.

164

"certChallengeHttp": { # Represents an HTTP certificate challenge. # The HTTP challenge for generating a certificate.

165

"path": "A String", # The URL path on which to serve the specified token to satisfy the certificate challenge.

166

"token": "A String", # The token to serve at the specified URL path to satisfy the certificate challenge.

Yoshi Automation Bot

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

[diff] [blame]

167

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

168

"expectedIps": [ # The list of IPs to which the domain is expected to resolve.

169

"A String",

170

],

171

"dnsFetchTime": "A String", # The time at which the last DNS fetch occurred.

172

"dnsStatus": "A String", # The DNS record match status as of the last DNS fetch.

173

"discoveredIps": [ # The IPs found at the last DNS fetch.

174

"A String",

175

],

176

"certChallengeDiscoveredTxt": [ # The TXT records (for the certificate challenge) that were found at the last DNS fetch.

177

"A String",

178

],

179

"certStatus": "A String", # The certificate provisioning status; updated when Firebase Hosting provisions an SSL certificate for the domain.

180

"certChallengeDns": { # Represents a DNS certificate challenge. # The DNS challenge for generating a certificate.

181

"domainName": "A String", # The domain name upon which the DNS challenge must be satisfied.

182

"token": "A String", # The value that must be present as a TXT record on the domain name to satisfy the challenge.

Yoshi Automation Bot

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

[diff] [blame]

183

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

184

},

185

}</pre>

Bu Sun Kim

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

[diff] [blame]

</div>

<code class="details" id="delete">delete(name, x__xgafv=None)</code>

190

<pre>Deletes the existing domain mapping on the specified site.

191

192

Args:

193

name: string, Required. The name of the domain association to delete. (required)

194

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

201

Dmitry Frenkel

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

[diff] [blame]

202

{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.

Bu Sun Kim

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

[diff] [blame]

}</pre>

</div>

<code class="details" id="get">get(name, x__xgafv=None)</code>

208

<pre>Gets a domain mapping on the specified site.

209

210

Args:

211

name: string, Required. The name of the domain configuration to get. (required)

212

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

219

220

{ # The intended behavior and status information of a domain.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

221

"domainName": "A String", # Required. The domain name of the association.

222

"status": "A String", # Output only. Additional status of the domain association.

223

"site": "A String", # Required. The site name of the association.

224

"updateTime": "A String", # Output only. The time at which the domain was last updated.

225

"domainRedirect": { # Defines the behavior of a domain-level redirect. Domain redirects preserve the path of the redirect but replace the requested domain with the one specified in the redirect configuration. # If set, the domain should redirect with the provided parameters.

226

"domainName": "A String", # Required. The domain name to redirect to.

227

"type": "A String", # Required. The redirect status code.

228

},

229

"provisioning": { # The current certificate provisioning status information for a domain. # Output only. Information about the provisioning of certificates and the health of the DNS resolution for the domain.

230

"certChallengeHttp": { # Represents an HTTP certificate challenge. # The HTTP challenge for generating a certificate.

231

"path": "A String", # The URL path on which to serve the specified token to satisfy the certificate challenge.

232

"token": "A String", # The token to serve at the specified URL path to satisfy the certificate challenge.

Bu Sun Kim

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

[diff] [blame]

233

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

234

"expectedIps": [ # The list of IPs to which the domain is expected to resolve.

235

"A String",

236

],

237

"dnsFetchTime": "A String", # The time at which the last DNS fetch occurred.

238

"dnsStatus": "A String", # The DNS record match status as of the last DNS fetch.

239

"discoveredIps": [ # The IPs found at the last DNS fetch.

240

"A String",

241

],

242

"certChallengeDiscoveredTxt": [ # The TXT records (for the certificate challenge) that were found at the last DNS fetch.

243

"A String",

244

],

245

"certStatus": "A String", # The certificate provisioning status; updated when Firebase Hosting provisions an SSL certificate for the domain.

246

"certChallengeDns": { # Represents a DNS certificate challenge. # The DNS challenge for generating a certificate.

247

"domainName": "A String", # The domain name upon which the DNS challenge must be satisfied.

248

"token": "A String", # The value that must be present as a TXT record on the domain name to satisfy the challenge.

Bu Sun Kim

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

[diff] [blame]

249

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

250

},

251

}</pre>

Bu Sun Kim

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

[diff] [blame]

</div>

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

255

<code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>

Bu Sun Kim

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

[diff] [blame]

256

<pre>Lists the domains for the specified site.

257

258

Args:

Dmitry Frenkel

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

[diff] [blame]

259

parent: string, Required. The parent for which to list domains, in the format: sites/ site-name (required)

Yoshi Automation Bot

b6971b0

2020-11-26 17:16:03 -0800

[diff] [blame]

260

pageSize: integer, The page size to return. Defaults to 50.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

261

pageToken: string, The next_page_token from a previous request, if provided.

Bu Sun Kim

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

[diff] [blame]

262

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

269

270

{ # The response to listing Domains.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

271

"nextPageToken": "A String", # The pagination token, if more results exist.

Bu Sun Kim

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

[diff] [blame]

272

"domains": [ # The list of domains, if any exist.

273

{ # The intended behavior and status information of a domain.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

274

"domainName": "A String", # Required. The domain name of the association.

275

"status": "A String", # Output only. Additional status of the domain association.

276

"site": "A String", # Required. The site name of the association.

277

"updateTime": "A String", # Output only. The time at which the domain was last updated.

278

"domainRedirect": { # Defines the behavior of a domain-level redirect. Domain redirects preserve the path of the redirect but replace the requested domain with the one specified in the redirect configuration. # If set, the domain should redirect with the provided parameters.

279

"domainName": "A String", # Required. The domain name to redirect to.

280

"type": "A String", # Required. The redirect status code.

Bu Sun Kim

673ec5c

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

[diff] [blame]

281

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

282

"provisioning": { # The current certificate provisioning status information for a domain. # Output only. Information about the provisioning of certificates and the health of the DNS resolution for the domain.

283

"certChallengeHttp": { # Represents an HTTP certificate challenge. # The HTTP challenge for generating a certificate.

284

"path": "A String", # The URL path on which to serve the specified token to satisfy the certificate challenge.

285

"token": "A String", # The token to serve at the specified URL path to satisfy the certificate challenge.

286

},

287

"expectedIps": [ # The list of IPs to which the domain is expected to resolve.

288

"A String",

289

],

290

"dnsFetchTime": "A String", # The time at which the last DNS fetch occurred.

291

"dnsStatus": "A String", # The DNS record match status as of the last DNS fetch.

292

"discoveredIps": [ # The IPs found at the last DNS fetch.

293

"A String",

294

],

295

"certChallengeDiscoveredTxt": [ # The TXT records (for the certificate challenge) that were found at the last DNS fetch.

296

"A String",

297

],

298

"certStatus": "A String", # The certificate provisioning status; updated when Firebase Hosting provisions an SSL certificate for the domain.

299

"certChallengeDns": { # Represents a DNS certificate challenge. # The DNS challenge for generating a certificate.

300

"domainName": "A String", # The domain name upon which the DNS challenge must be satisfied.

301

"token": "A String", # The value that must be present as a TXT record on the domain name to satisfy the challenge.

302

},

303

},

304

},

Bu Sun Kim

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

[diff] [blame]

],

}</pre>

</div>

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

311

<pre>Retrieves the next page of results.

312

313

Args:

314

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

315

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

316

317

Returns:

318

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

319

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

</pre>

</div>

<code class="details" id="update">update(name, body=None, x__xgafv=None)</code>

Dmitry Frenkel

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

[diff] [blame]

325

<pre>Updates the specified domain mapping, creating the mapping as if it does not exist.

Bu Sun Kim

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

[diff] [blame]

326

327

Args:

Dmitry Frenkel

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

[diff] [blame]

328

name: string, Required. The name of the domain association to update or create, if an association doesn't already exist. (required)

Bu Sun Kim

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

[diff] [blame]

329

body: object, The request body.

330

The object takes the form of:

331

332

{ # The intended behavior and status information of a domain.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

333

"domainName": "A String", # Required. The domain name of the association.

334

"status": "A String", # Output only. Additional status of the domain association.

335

"site": "A String", # Required. The site name of the association.

336

"updateTime": "A String", # Output only. The time at which the domain was last updated.

337

"domainRedirect": { # Defines the behavior of a domain-level redirect. Domain redirects preserve the path of the redirect but replace the requested domain with the one specified in the redirect configuration. # If set, the domain should redirect with the provided parameters.

338

"domainName": "A String", # Required. The domain name to redirect to.

339

"type": "A String", # Required. The redirect status code.

340

},

341

"provisioning": { # The current certificate provisioning status information for a domain. # Output only. Information about the provisioning of certificates and the health of the DNS resolution for the domain.

342

"certChallengeHttp": { # Represents an HTTP certificate challenge. # The HTTP challenge for generating a certificate.

343

"path": "A String", # The URL path on which to serve the specified token to satisfy the certificate challenge.

344

"token": "A String", # The token to serve at the specified URL path to satisfy the certificate challenge.

Bu Sun Kim

673ec5c

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

[diff] [blame]

345

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

346

"expectedIps": [ # The list of IPs to which the domain is expected to resolve.

347

"A String",

348

],

349

"dnsFetchTime": "A String", # The time at which the last DNS fetch occurred.

350

"dnsStatus": "A String", # The DNS record match status as of the last DNS fetch.

351

"discoveredIps": [ # The IPs found at the last DNS fetch.

352

"A String",

353

],

354

"certChallengeDiscoveredTxt": [ # The TXT records (for the certificate challenge) that were found at the last DNS fetch.

355

"A String",

356

],

357

"certStatus": "A String", # The certificate provisioning status; updated when Firebase Hosting provisions an SSL certificate for the domain.

358

"certChallengeDns": { # Represents a DNS certificate challenge. # The DNS challenge for generating a certificate.

359

"domainName": "A String", # The domain name upon which the DNS challenge must be satisfied.

360

"token": "A String", # The value that must be present as a TXT record on the domain name to satisfy the challenge.

Yoshi Automation Bot

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

[diff] [blame]

361

},

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

362

},

363

}

Yoshi Automation Bot

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

[diff] [blame]

364

365

x__xgafv: string, V1 error format.

Allowed values

1 - v1 error format

2 - v2 error format

Returns:

An object of the form:

372

373

{ # The intended behavior and status information of a domain.

Yoshi Automation Bot

2020-12-09 08:56:03 -0800

[diff] [blame^]

374

"domainName": "A String", # Required. The domain name of the association.

375

"status": "A String", # Output only. Additional status of the domain association.

376

"site": "A String", # Required. The site name of the association.

377

"updateTime": "A String", # Output only. The time at which the domain was last updated.

378

"domainRedirect": { # Defines the behavior of a domain-level redirect. Domain redirects preserve the path of the redirect but replace the requested domain with the one specified in the redirect configuration. # If set, the domain should redirect with the provided parameters.

379

"domainName": "A String", # Required. The domain name to redirect to.

380

"type": "A String", # Required. The redirect status code.

381

},

382

"provisioning": { # The current certificate provisioning status information for a domain. # Output only. Information about the provisioning of certificates and the health of the DNS resolution for the domain.

383

"certChallengeHttp": { # Represents an HTTP certificate challenge. # The HTTP challenge for generating a certificate.

384

"path": "A String", # The URL path on which to serve the specified token to satisfy the certificate challenge.

385

"token": "A String", # The token to serve at the specified URL path to satisfy the certificate challenge.

Yoshi Automation Bot