Skip to content

Commit cef24d8

Browse files
feat(sqladmin): update the api
#### sqladmin:v1 The following keys were deleted: - resources.projects.resources.instances.methods.generateEphemeralCert (Total Keys: 14) - resources.projects.resources.instances.methods.get (Total Keys: 29) - resources.projects.resources.instances.resources.createEphemeral.methods.create (Total Keys: 14) - schemas.Database (Total Keys: 8) - schemas.InstanceReference (Total Keys: 4) The following keys were added: - resources.backupRuns.methods.delete (Total Keys: 17) - resources.backupRuns.methods.get (Total Keys: 17) - resources.backupRuns.methods.insert (Total Keys: 14) - resources.backupRuns.methods.list (Total Keys: 18) - resources.connect.methods.generateEphemeralCert (Total Keys: 14) - resources.connect.methods.get (Total Keys: 16) - resources.databases.methods.delete (Total Keys: 16) - resources.databases.methods.get (Total Keys: 16) - resources.databases.methods.insert (Total Keys: 14) - resources.databases.methods.list (Total Keys: 13) - resources.databases.methods.patch (Total Keys: 17) - resources.databases.methods.update (Total Keys: 17) - resources.flags.methods.list (Total Keys: 9) - resources.instances.methods.addServerCa (Total Keys: 13) - resources.instances.methods.clone (Total Keys: 14) - resources.instances.methods.delete (Total Keys: 13) - resources.instances.methods.demoteMaster (Total Keys: 14) - resources.instances.methods.export (Total Keys: 14) - resources.instances.methods.failover (Total Keys: 14) - resources.instances.methods.get (Total Keys: 13) - resources.instances.methods.import (Total Keys: 14) - resources.instances.methods.insert (Total Keys: 11) - resources.instances.methods.listServerCas (Total Keys: 13) - resources.instances.methods.patch (Total Keys: 14) - resources.instances.methods.promoteReplica (Total Keys: 13) - resources.instances.methods.resetSslConfig (Total Keys: 13) - resources.instances.methods.restart (Total Keys: 13) - resources.instances.methods.restoreBackup (Total Keys: 14) - resources.instances.methods.rotateServerCa (Total Keys: 14) - resources.instances.methods.startReplica (Total Keys: 13) - resources.instances.methods.stopReplica (Total Keys: 13) - resources.instances.methods.truncateLog (Total Keys: 14) - resources.instances.methods.update (Total Keys: 14) - resources.operations.methods.get (Total Keys: 13) - resources.operations.methods.list (Total Keys: 17) - resources.projects.resources.instances.methods.rescheduleMaintenance (Total Keys: 14) - resources.projects.resources.instances.methods.startExternalSync (Total Keys: 17) - resources.projects.resources.instances.methods.verifyExternalSyncSettings (Total Keys: 17) - resources.sslCerts.methods.createEphemeral (Total Keys: 14) - resources.sslCerts.methods.delete (Total Keys: 16) - resources.sslCerts.methods.get (Total Keys: 16) - resources.sslCerts.methods.insert (Total Keys: 14) - resources.sslCerts.methods.list (Total Keys: 13) - resources.tiers.methods.list (Total Keys: 10) - resources.users.methods.delete (Total Keys: 17) - resources.users.methods.insert (Total Keys: 14) - resources.users.methods.list (Total Keys: 32) - resources.users.methods.update (Total Keys: 18) - schemas.BackupContext (Total Keys: 5) - schemas.BackupRun (Total Keys: 28) - schemas.BinLogCoordinates (Total Keys: 6) - schemas.CloneContext (Total Keys: 9) - schemas.Database (Total Keys: 15) - schemas.DemoteMasterConfiguration (Total Keys: 4) - schemas.DemoteMasterContext (Total Keys: 6) - schemas.DemoteMasterMySqlReplicaConfiguration (Total Keys: 8) - schemas.ExportContext (Total Keys: 17) - schemas.FailoverContext (Total Keys: 5) - schemas.Flag (Total Keys: 23) - schemas.ImportContext (Total Keys: 16) - schemas.InstancesCloneRequest (Total Keys: 3) - schemas.InstancesDemoteMasterRequest (Total Keys: 3) - schemas.InstancesExportRequest (Total Keys: 3) - schemas.InstancesFailoverRequest (Total Keys: 3) - schemas.InstancesImportRequest (Total Keys: 3) - schemas.InstancesListServerCasResponse (Total Keys: 6) - schemas.InstancesRestoreBackupRequest (Total Keys: 3) - schemas.InstancesRotateServerCaRequest (Total Keys: 3) - schemas.InstancesTruncateLogRequest (Total Keys: 3) - schemas.LocationPreference.properties.followGaeApplication.type (Total Keys: 1) - schemas.Operation (Total Keys: 37) - schemas.Reschedule (Total Keys: 5) - schemas.RestoreBackupContext (Total Keys: 7) - schemas.RotateServerCaContext (Total Keys: 4) - schemas.Settings.properties.authorizedGaeApplications (Total Keys: 2) - schemas.SqlExternalSyncSettingError (Total Keys: 5) - schemas.SqlInstancesRescheduleMaintenanceRequestBody (Total Keys: 3) - schemas.SqlInstancesVerifyExternalSyncSettingsResponse (Total Keys: 7) - schemas.SqlServerDatabaseDetails (Total Keys: 5) - schemas.SqlServerUserDetails (Total Keys: 5) - schemas.SslCert.properties.selfLink.type (Total Keys: 1) - schemas.SslCertDetail (Total Keys: 4) - schemas.SslCertsInsertRequest (Total Keys: 3) - schemas.SslCertsInsertResponse (Total Keys: 6) - schemas.SslCertsListResponse (Total Keys: 5) - schemas.Tier (Total Keys: 15) - schemas.TruncateLogContext (Total Keys: 4) - schemas.User (Total Keys: 16) The following keys were changed: - resources.instances.methods.list.id (Total Keys: 1)
1 parent 3b2c0fa commit cef24d8

16 files changed

+8846
-814
lines changed

docs/dyn/sqladmin_v1.backupRuns.html

Lines changed: 419 additions & 0 deletions
Large diffs are not rendered by default.

docs/dyn/sqladmin_v1.connect.html

Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,172 @@
1+
<html><body>
2+
<style>
3+
4+
body, h1, h2, h3, div, span, p, pre, a {
5+
margin: 0;
6+
padding: 0;
7+
border: 0;
8+
font-weight: inherit;
9+
font-style: inherit;
10+
font-size: 100%;
11+
font-family: inherit;
12+
vertical-align: baseline;
13+
}
14+
15+
body {
16+
font-size: 13px;
17+
padding: 1em;
18+
}
19+
20+
h1 {
21+
font-size: 26px;
22+
margin-bottom: 1em;
23+
}
24+
25+
h2 {
26+
font-size: 24px;
27+
margin-bottom: 1em;
28+
}
29+
30+
h3 {
31+
font-size: 20px;
32+
margin-bottom: 1em;
33+
margin-top: 1em;
34+
}
35+
36+
pre, code {
37+
line-height: 1.5;
38+
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39+
}
40+
41+
pre {
42+
margin-top: 0.5em;
43+
}
44+
45+
h1, h2, h3, p {
46+
font-family: Arial, sans serif;
47+
}
48+
49+
h1, h2, h3 {
50+
border-bottom: solid #CCC 1px;
51+
}
52+
53+
.toc_element {
54+
margin-top: 0.5em;
55+
}
56+
57+
.firstline {
58+
margin-left: 2 em;
59+
}
60+
61+
.method {
62+
margin-top: 1em;
63+
border: solid 1px #CCC;
64+
padding: 1em;
65+
background: #EEE;
66+
}
67+
68+
.details {
69+
font-weight: bold;
70+
font-size: 14px;
71+
}
72+
73+
</style>
74+
75+
<h1><a href="sqladmin_v1.html">Cloud SQL Admin API</a> . <a href="sqladmin_v1.connect.html">connect</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#close">close()</a></code></p>
79+
<p class="firstline">Close httplib2 connections.</p>
80+
<p class="toc_element">
81+
<code><a href="#generateEphemeralCert">generateEphemeralCert(project, instance, body=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance. Users may use the certificate to authenticate as themselves when connecting to the database.</p>
83+
<p class="toc_element">
84+
<code><a href="#get">get(project, instance, readTime=None, x__xgafv=None)</a></code></p>
85+
<p class="firstline">Retrieves connect settings about a Cloud SQL instance.</p>
86+
<h3>Method Details</h3>
87+
<div class="method">
88+
<code class="details" id="close">close()</code>
89+
<pre>Close httplib2 connections.</pre>
90+
</div>
91+
92+
<div class="method">
93+
<code class="details" id="generateEphemeralCert">generateEphemeralCert(project, instance, body=None, x__xgafv=None)</code>
94+
<pre>Generates a short-lived X509 certificate containing the provided public key and signed by a private key specific to the target instance. Users may use the certificate to authenticate as themselves when connecting to the database.
95+
96+
Args:
97+
project: string, Project ID of the project that contains the instance. (required)
98+
instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
99+
body: object, The request body.
100+
The object takes the form of:
101+
102+
{ # Ephemeral certificate creation request.
103+
&quot;access_token&quot;: &quot;A String&quot;, # Optional. Access token to include in the signed certificate.
104+
&quot;public_key&quot;: &quot;A String&quot;, # PEM encoded public key to include in the signed certificate.
105+
&quot;readTime&quot;: &quot;A String&quot;, # Optional. Optional snapshot read timestamp to trade freshness for performance.
106+
}
107+
108+
x__xgafv: string, V1 error format.
109+
Allowed values
110+
1 - v1 error format
111+
2 - v2 error format
112+
113+
Returns:
114+
An object of the form:
115+
116+
{ # Ephemeral certificate creation request.
117+
&quot;ephemeralCert&quot;: { # SslCerts Resource # Generated cert
118+
&quot;cert&quot;: &quot;A String&quot;, # PEM representation.
119+
&quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
120+
&quot;commonName&quot;: &quot;A String&quot;, # User supplied name. Constrained to [a-zA-Z.-_ ]+.
121+
&quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**
122+
&quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
123+
&quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
124+
&quot;kind&quot;: &quot;A String&quot;, # This is always sql#sslCert.
125+
&quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
126+
&quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
127+
},
128+
}</pre>
129+
</div>
130+
131+
<div class="method">
132+
<code class="details" id="get">get(project, instance, readTime=None, x__xgafv=None)</code>
133+
<pre>Retrieves connect settings about a Cloud SQL instance.
134+
135+
Args:
136+
project: string, Project ID of the project that contains the instance. (required)
137+
instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
138+
readTime: string, Optional. Optional snapshot read timestamp to trade freshness for performance.
139+
x__xgafv: string, V1 error format.
140+
Allowed values
141+
1 - v1 error format
142+
2 - v2 error format
143+
144+
Returns:
145+
An object of the form:
146+
147+
{ # Connect settings retrieval response.
148+
&quot;backendType&quot;: &quot;A String&quot;, # **SECOND_GEN**: Cloud SQL database instance. **EXTERNAL**: A database server that is not managed by Google. This property is read-only; use the **tier** property in the **settings** object to determine the database type.
149+
&quot;databaseVersion&quot;: &quot;A String&quot;, # The database engine type and version. The **databaseVersion** field cannot be changed after instance creation. MySQL instances: **MYSQL_8_0**, **MYSQL_5_7** (default), or **MYSQL_5_6**. PostgreSQL instances: **POSTGRES_9_6**, **POSTGRES_10**, **POSTGRES_11** or **POSTGRES_12** (default). SQL Server instances: **SQLSERVER_2017_STANDARD** (default), **SQLSERVER_2017_ENTERPRISE**, **SQLSERVER_2017_EXPRESS**, or **SQLSERVER_2017_WEB**.
150+
&quot;ipAddresses&quot;: [ # The assigned IP addresses for the instance.
151+
{ # Database instance IP Mapping.
152+
&quot;ipAddress&quot;: &quot;A String&quot;, # The IP address assigned.
153+
&quot;timeToRetire&quot;: &quot;A String&quot;, # The due time for this IP to be retired in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**. This field is only available when the IP is scheduled to be retired.
154+
&quot;type&quot;: &quot;A String&quot;, # The type of this IP address. A **PRIMARY** address is a public address that can accept incoming connections. A **PRIVATE** address is a private address that can accept incoming connections. An **OUTGOING** address is the source address of connections originating from the instance, if supported.
155+
},
156+
],
157+
&quot;kind&quot;: &quot;A String&quot;, # This is always `sql#connectSettings`.
158+
&quot;serverCaCert&quot;: { # SslCerts Resource # SSL configuration.
159+
&quot;cert&quot;: &quot;A String&quot;, # PEM representation.
160+
&quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
161+
&quot;commonName&quot;: &quot;A String&quot;, # User supplied name. Constrained to [a-zA-Z.-_ ]+.
162+
&quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**
163+
&quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
164+
&quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
165+
&quot;kind&quot;: &quot;A String&quot;, # This is always sql#sslCert.
166+
&quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
167+
&quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
168+
},
169+
}</pre>
170+
</div>
171+
172+
</body></html>

0 commit comments

Comments
 (0)