Skip to content

Commit e204b50

Browse files
feat(sqladmin)!: update the API
BREAKING CHANGE: This release has breaking changes. #### sqladmin:v1beta4 The following keys were deleted: - resources.instances.methods.delete.parameters.enableFinalBackup.description - resources.instances.methods.delete.parameters.enableFinalBackup.location - resources.instances.methods.delete.parameters.enableFinalBackup.type - resources.instances.methods.delete.parameters.finalBackupDescription.description - resources.instances.methods.delete.parameters.finalBackupDescription.location - resources.instances.methods.delete.parameters.finalBackupDescription.type - resources.operations.methods.list.parameters.filter.description - resources.operations.methods.list.parameters.filter.location - resources.operations.methods.list.parameters.filter.type - schemas.BackupContext.properties.name.description - schemas.BackupContext.properties.name.type - schemas.InstancesRestoreBackupRequest.properties.backup.description - schemas.InstancesRestoreBackupRequest.properties.backup.type - schemas.InstancesRestoreBackupRequest.properties.restoreInstanceSettings.$ref - schemas.InstancesRestoreBackupRequest.properties.restoreInstanceSettings.description - schemas.OperationsListResponse.properties.warnings.description - schemas.OperationsListResponse.properties.warnings.items.$ref - schemas.OperationsListResponse.properties.warnings.type The following keys were added: - schemas.PscAutoConnectionConfig.description - schemas.PscAutoConnectionConfig.id - schemas.PscAutoConnectionConfig.properties.consumerNetwork.description - schemas.PscAutoConnectionConfig.properties.consumerNetwork.type - schemas.PscAutoConnectionConfig.properties.consumerNetworkStatus.description - schemas.PscAutoConnectionConfig.properties.consumerNetworkStatus.type - schemas.PscAutoConnectionConfig.properties.consumerProject.description - schemas.PscAutoConnectionConfig.properties.consumerProject.type - schemas.PscAutoConnectionConfig.properties.ipAddress.description - schemas.PscAutoConnectionConfig.properties.ipAddress.type - schemas.PscAutoConnectionConfig.properties.status.description - schemas.PscAutoConnectionConfig.properties.status.type - schemas.PscAutoConnectionConfig.type - schemas.PscConfig.properties.pscAutoConnections.description - schemas.PscConfig.properties.pscAutoConnections.items.$ref - schemas.PscConfig.properties.pscAutoConnections.type The following keys were changed: - resources.instances.methods.RotateServerCertificate.description - resources.instances.methods.addServerCa.description - resources.instances.methods.addServerCertificate.description - resources.instances.methods.rotateServerCa.description - schemas.BackupRun.properties.backupKind.enumDescriptions - schemas.ConnectSettings.properties.serverCaMode.enumDescriptions - schemas.IpConfiguration.properties.serverCaMode.enumDescriptions - schemas.Operation.properties.operationType.enum - schemas.Operation.properties.operationType.enumDeprecated - schemas.Operation.properties.operationType.enumDescriptions #### sqladmin:v1 The following keys were deleted: - resources.instances.methods.delete.parameters.enableFinalBackup.description - resources.instances.methods.delete.parameters.enableFinalBackup.location - resources.instances.methods.delete.parameters.enableFinalBackup.type - resources.instances.methods.delete.parameters.finalBackupDescription.description - resources.instances.methods.delete.parameters.finalBackupDescription.location - resources.instances.methods.delete.parameters.finalBackupDescription.type - resources.instances.methods.delete.parameters.finalBackupExpiryTime.description - resources.instances.methods.delete.parameters.finalBackupExpiryTime.format - resources.instances.methods.delete.parameters.finalBackupExpiryTime.location - resources.instances.methods.delete.parameters.finalBackupExpiryTime.type - resources.instances.methods.delete.parameters.finalBackupTtlDays.description - resources.instances.methods.delete.parameters.finalBackupTtlDays.format - resources.instances.methods.delete.parameters.finalBackupTtlDays.location - resources.instances.methods.delete.parameters.finalBackupTtlDays.type - resources.operations.methods.list.parameters.filter.description - resources.operations.methods.list.parameters.filter.location - resources.operations.methods.list.parameters.filter.type - schemas.BackupContext.properties.name.description - schemas.BackupContext.properties.name.type - schemas.InstancesRestoreBackupRequest.properties.backup.description - schemas.InstancesRestoreBackupRequest.properties.backup.type - schemas.InstancesRestoreBackupRequest.properties.restoreInstanceSettings.$ref - schemas.InstancesRestoreBackupRequest.properties.restoreInstanceSettings.description - schemas.OperationsListResponse.properties.warnings.description - schemas.OperationsListResponse.properties.warnings.items.$ref - schemas.OperationsListResponse.properties.warnings.type The following keys were added: - schemas.PscAutoConnectionConfig.description - schemas.PscAutoConnectionConfig.id - schemas.PscAutoConnectionConfig.properties.consumerNetwork.description - schemas.PscAutoConnectionConfig.properties.consumerNetwork.type - schemas.PscAutoConnectionConfig.properties.consumerNetworkStatus.description - schemas.PscAutoConnectionConfig.properties.consumerNetworkStatus.type - schemas.PscAutoConnectionConfig.properties.consumerProject.description - schemas.PscAutoConnectionConfig.properties.consumerProject.type - schemas.PscAutoConnectionConfig.properties.ipAddress.description - schemas.PscAutoConnectionConfig.properties.ipAddress.type - schemas.PscAutoConnectionConfig.properties.status.description - schemas.PscAutoConnectionConfig.properties.status.type - schemas.PscAutoConnectionConfig.type - schemas.PscConfig.properties.pscAutoConnections.description - schemas.PscConfig.properties.pscAutoConnections.items.$ref - schemas.PscConfig.properties.pscAutoConnections.type The following keys were changed: - resources.instances.methods.RotateServerCertificate.description - resources.instances.methods.addServerCa.description - resources.instances.methods.addServerCertificate.description - resources.instances.methods.rotateServerCa.description - schemas.BackupRun.properties.backupKind.enumDescriptions - schemas.IpConfiguration.properties.serverCaMode.enumDescriptions - schemas.Operation.properties.operationType.enum - schemas.Operation.properties.operationType.enumDeprecated - schemas.Operation.properties.operationType.enumDescriptions
1 parent ea8eb9a commit e204b50

File tree

4 files changed

+151
-175
lines changed

4 files changed

+151
-175
lines changed

discovery/sqladmin-v1.json

Lines changed: 42 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -641,7 +641,7 @@
641641
]
642642
},
643643
"RotateServerCertificate": {
644-
"description": "Rotates the server certificate version to one previously added with the addServerCertificate method. For instances not using Certificate Authority Service (CAS) server CA, please use RotateServerCa instead.",
644+
"description": "Rotates the server certificate version to one previously added with the addServerCertificate method. For instances not using Certificate Authority Service (CAS) server CA, use RotateServerCa instead.",
645645
"flatPath": "v1/projects/{project}/instances/{instance}/rotateServerCertificate",
646646
"httpMethod": "POST",
647647
"id": "sql.instances.RotateServerCertificate",
@@ -711,7 +711,7 @@
711711
]
712712
},
713713
"addServerCa": {
714-
"description": "Adds a new trusted Certificate Authority (CA) version for the specified instance. Required to prepare for a certificate rotation. If a CA version was previously added but never used in a certificate rotation, this operation replaces that version. There cannot be more than one CA version waiting to be rotated in. For instances that have enabled Certificate Authority Service (CAS) based server CA, please use AddServerCertificate to add a new server certificate.",
714+
"description": "Adds a new trusted Certificate Authority (CA) version for the specified instance. Required to prepare for a certificate rotation. If a CA version was previously added but never used in a certificate rotation, this operation replaces that version. There cannot be more than one CA version waiting to be rotated in. For instances that have enabled Certificate Authority Service (CAS) based server CA, use AddServerCertificate to add a new server certificate.",
715715
"flatPath": "v1/projects/{project}/instances/{instance}/addServerCa",
716716
"httpMethod": "POST",
717717
"id": "sql.instances.addServerCa",
@@ -743,7 +743,7 @@
743743
]
744744
},
745745
"addServerCertificate": {
746-
"description": "Add a new trusted server certificate version for the specified instance using Certificate Authority Service (CAS) server CA. Required to prepare for a certificate rotation. If a server certificate version was previously added but never used in a certificate rotation, this operation replaces that version. There cannot be more than one certificate version waiting to be rotated in. For instances not using CAS server CA, please use AddServerCa instead.",
746+
"description": "Add a new trusted server certificate version for the specified instance using Certificate Authority Service (CAS) server CA. Required to prepare for a certificate rotation. If a server certificate version was previously added but never used in a certificate rotation, this operation replaces that version. There cannot be more than one certificate version waiting to be rotated in. For instances not using CAS server CA, use AddServerCa instead.",
747747
"flatPath": "v1/projects/{project}/instances/{instance}/addServerCertificate",
748748
"httpMethod": "POST",
749749
"id": "sql.instances.addServerCertificate",
@@ -819,28 +819,6 @@
819819
"instance"
820820
],
821821
"parameters": {
822-
"enableFinalBackup": {
823-
"description": "Flag to opt-in for final backup. By default, it is turned off.",
824-
"location": "query",
825-
"type": "boolean"
826-
},
827-
"finalBackupDescription": {
828-
"description": "Optional. The description of the final backup.",
829-
"location": "query",
830-
"type": "string"
831-
},
832-
"finalBackupExpiryTime": {
833-
"description": "Optional. Final Backup expiration time. Timestamp in UTC of when this resource is considered expired.",
834-
"format": "google-datetime",
835-
"location": "query",
836-
"type": "string"
837-
},
838-
"finalBackupTtlDays": {
839-
"description": "Optional. Retention period of the final backup.",
840-
"format": "int64",
841-
"location": "query",
842-
"type": "string"
843-
},
844822
"instance": {
845823
"description": "Cloud SQL instance ID. This does not include the project ID.",
846824
"location": "path",
@@ -1408,7 +1386,7 @@
14081386
]
14091387
},
14101388
"rotateServerCa": {
1411-
"description": "Rotates the server certificate to one signed by the Certificate Authority (CA) version previously added with the addServerCA method. For instances that have enabled Certificate Authority Service (CAS) based server CA, please use RotateServerCertificate to rotate the server certificate.",
1389+
"description": "Rotates the server certificate to one signed by the Certificate Authority (CA) version previously added with the addServerCA method. For instances that have enabled Certificate Authority Service (CAS) based server CA, use RotateServerCertificate to rotate the server certificate.",
14121390
"flatPath": "v1/projects/{project}/instances/{instance}/rotateServerCa",
14131391
"httpMethod": "POST",
14141392
"id": "sql.instances.rotateServerCa",
@@ -1691,11 +1669,6 @@
16911669
"project"
16921670
],
16931671
"parameters": {
1694-
"filter": {
1695-
"description": "Optional. A filter string that follows the rules of EBNF grammar (https://google.aip.dev/assets/misc/ebnf-filtering.txt). Cloud SQL provides filters for status, operationType, and startTime.",
1696-
"location": "query",
1697-
"type": "string"
1698-
},
16991672
"instance": {
17001673
"description": "Cloud SQL instance ID. This does not include the project ID.",
17011674
"location": "query",
@@ -2393,7 +2366,7 @@
23932366
}
23942367
}
23952368
},
2396-
"revision": "20240925",
2369+
"revision": "20241004",
23972370
"rootUrl": "https://sqladmin.googleapis.com/",
23982371
"schemas": {
23992372
"AclEntry": {
@@ -2583,10 +2556,6 @@
25832556
"kind": {
25842557
"description": "This is always `sql#backupContext`.",
25852558
"type": "string"
2586-
},
2587-
"name": {
2588-
"description": "The name of the backup. Format: projects/{project}/backups/{backup}",
2589-
"type": "string"
25902559
}
25912560
},
25922561
"type": "object"
@@ -2654,8 +2623,8 @@
26542623
],
26552624
"enumDescriptions": [
26562625
"This is an unknown BackupKind.",
2657-
"The snapshot based backups",
2658-
"Physical backups"
2626+
"Snapshot-based backups.",
2627+
"Physical backups."
26592628
],
26602629
"type": "string"
26612630
},
@@ -4628,17 +4597,9 @@
46284597
"description": "Database instance restore backup request.",
46294598
"id": "InstancesRestoreBackupRequest",
46304599
"properties": {
4631-
"backup": {
4632-
"description": "The name of the backup to restore from in following format: projects/{project-id}/backups/{backup-uid} Only one of restore_backup_context or backup can be passed to the input.",
4633-
"type": "string"
4634-
},
46354600
"restoreBackupContext": {
46364601
"$ref": "RestoreBackupContext",
46374602
"description": "Parameters required to perform the restore backup operation."
4638-
},
4639-
"restoreInstanceSettings": {
4640-
"$ref": "DatabaseInstance",
4641-
"description": "Optional. Restore instance settings overrides the instance settings stored as part of the backup. Instance's major database version cannot be changed and the disk size can only be increased. This feature is only available for restores to new instances using the backup name."
46424603
}
46434604
},
46444605
"type": "object"
@@ -4719,7 +4680,7 @@
47194680
"GOOGLE_MANAGED_CAS_CA"
47204681
],
47214682
"enumDescriptions": [
4722-
"CA mode is unknown.",
4683+
"CA mode is unspecified. It is effectively the same as `GOOGLE_MANAGED_INTERNAL_CA`.",
47234684
"Google-managed self-signed internal CA.",
47244685
"Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS)."
47254686
],
@@ -5037,7 +4998,6 @@
50374998
"AUTO_RESTART",
50384999
"REENCRYPT",
50395000
"SWITCHOVER",
5040-
"UPDATE_BACKUP",
50415001
"ACQUIRE_SSRS_LEASE",
50425002
"RELEASE_SSRS_LEASE",
50435003
"RECONFIGURE_OLD_PRIMARY",
@@ -5089,7 +5049,6 @@
50895049
false,
50905050
false,
50915051
false,
5092-
false,
50935052
true,
50945053
true,
50955054
false,
@@ -5135,7 +5094,6 @@
51355094
"Performs auto-restart of an HA-enabled Cloud SQL database for auto recovery.",
51365095
"Re-encrypts CMEK instances with latest key version.",
51375096
"Switches the roles of the primary and replica pair. The target instance should be the replica.",
5138-
"Update a backup.",
51395097
"Acquire a lease for the setup of SQL Server Reporting Services (SSRS).",
51405098
"Release a lease for the setup of SQL Server Reporting Services (SSRS).",
51415099
"Reconfigures old primary after a promote replica operation. Effect of a promote operation to the old primary is executed in this operation, asynchronously from the promote replica operation executed to the replica.",
@@ -5288,13 +5246,6 @@
52885246
"nextPageToken": {
52895247
"description": "The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.",
52905248
"type": "string"
5291-
},
5292-
"warnings": {
5293-
"description": "List of warnings that occurred while handling the request.",
5294-
"items": {
5295-
"$ref": "ApiWarning"
5296-
},
5297-
"type": "array"
52985249
}
52995250
},
53005251
"type": "object"
@@ -5374,6 +5325,33 @@
53745325
},
53755326
"type": "object"
53765327
},
5328+
"PscAutoConnectionConfig": {
5329+
"description": "Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.",
5330+
"id": "PscAutoConnectionConfig",
5331+
"properties": {
5332+
"consumerNetwork": {
5333+
"description": "The consumer network of this consumer endpoint. This must be a resource path that includes both the host project and the network name. For example, `projects/project1/global/networks/network1`. The consumer host project of this network might be different from the consumer service project.",
5334+
"type": "string"
5335+
},
5336+
"consumerNetworkStatus": {
5337+
"description": "The connection policy status of the consumer network.",
5338+
"type": "string"
5339+
},
5340+
"consumerProject": {
5341+
"description": "This is the project ID of consumer service project of this consumer endpoint. Optional. This is only applicable if consumer_network is a shared vpc network.",
5342+
"type": "string"
5343+
},
5344+
"ipAddress": {
5345+
"description": "The IP address of the consumer endpoint.",
5346+
"type": "string"
5347+
},
5348+
"status": {
5349+
"description": "The connection status of the consumer endpoint.",
5350+
"type": "string"
5351+
}
5352+
},
5353+
"type": "object"
5354+
},
53775355
"PscConfig": {
53785356
"description": "PSC settings for a Cloud SQL instance.",
53795357
"id": "PscConfig",
@@ -5385,6 +5363,13 @@
53855363
},
53865364
"type": "array"
53875365
},
5366+
"pscAutoConnections": {
5367+
"description": "Optional. The list of settings for requested Private Service Connect consumer endpoints that can be used to connect to this Cloud SQL instance.",
5368+
"items": {
5369+
"$ref": "PscAutoConnectionConfig"
5370+
},
5371+
"type": "array"
5372+
},
53885373
"pscEnabled": {
53895374
"description": "Whether PSC connectivity is enabled for this instance.",
53905375
"type": "boolean"

0 commit comments

Comments
 (0)