feat(sqladmin): update the API

#### sqladmin:v1beta4 The following keys were added: - schemas.BackupConfiguration.properties.backupRetentionSettings.$ref - schemas.BackupConfiguration.properties.backupRetentionSettings.description - schemas.BackupConfiguration.properties.transactionLogRetentionDays.description - schemas.BackupConfiguration.properties.transactionLogRetentionDays.format - schemas.BackupConfiguration.properties.transactionLogRetentionDays.type - schemas.BackupRetentionSettings.description - schemas.BackupRetentionSettings.id - schemas.BackupRetentionSettings.properties.retainedBackups.description - schemas.BackupRetentionSettings.properties.retainedBackups.format - schemas.BackupRetentionSettings.properties.retainedBackups.type - schemas.BackupRetentionSettings.properties.retentionUnit.description - schemas.BackupRetentionSettings.properties.retentionUnit.enum - schemas.BackupRetentionSettings.properties.retentionUnit.enumDescriptions - schemas.BackupRetentionSettings.properties.retentionUnit.type - schemas.BackupRetentionSettings.type The following keys were changed: - schemas.DatabaseInstance.properties.databaseVersion.enum - schemas.DatabaseInstance.properties.databaseVersion.enumDescriptions - schemas.DatabaseInstance.properties.state.description - schemas.DatabaseInstance.properties.state.enumDescriptions - schemas.Flag.properties.appliesTo.items.enum - schemas.Flag.properties.appliesTo.items.enumDescriptions
googleapis · Oct 7, 2020 · 9ac4f68 · 9ac4f68
1 parent 3f67c3e
commit 9ac4f68
Show file tree

Hide file tree

Showing 2 changed files with 68 additions and 10 deletions.
diff --git a/discovery/sqladmin-v1beta4.json b/discovery/sqladmin-v1beta4.json
@@ -1828,7 +1828,7 @@
       }
     }
   },
-  "revision": "20200919",
+  "revision": "20200930",
   "rootUrl": "https://sqladmin.googleapis.com/",
   "schemas": {
     "AclEntry": {
@@ -1882,6 +1882,10 @@
       "description": "Database instance backup configuration.",
       "id": "BackupConfiguration",
       "properties": {
+        "backupRetentionSettings": {
+          "$ref": "BackupRetentionSettings",
+          "description": "Backup retention settings."
+        },
         "binaryLogEnabled": {
           "description": "(MySQL only) Whether binary log is enabled. If backup configuration is disabled, binarylog must be disabled as well.",
           "type": "boolean"
@@ -1909,6 +1913,35 @@
         "startTime": {
           "description": "Start time for the daily backup configuration in UTC timezone in the 24 hour format - *HH:MM*.",
           "type": "string"
+        },
+        "transactionLogRetentionDays": {
+          "description": "The number of days of transaction logs we retain for point in time restore, from 1-7.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "BackupRetentionSettings": {
+      "description": "We currently only support backup retention by specifying the number of backups we will retain.",
+      "id": "BackupRetentionSettings",
+      "properties": {
+        "retainedBackups": {
+          "description": "Depending on the value of retention_unit, this is used to determine if a backup needs to be deleted. If retention_unit is 'COUNT', we will retain this many backups.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "retentionUnit": {
+          "description": "The unit that 'retained_backups' represents.",
+          "enum": [
+            "RETENTION_UNIT_UNSPECIFIED",
+            "COUNT"
+          ],
+          "enumDescriptions": [
+            "Backup retention unit is unspecified, will be treated as COUNT.",
+            "Retention will be by count, eg. \"retain the most recent 7 backups\"."
+          ],
+          "type": "string"
         }
       },
       "type": "object"
@@ -2206,7 +2239,8 @@
             "SQLSERVER_2017_WEB",
             "POSTGRES_10",
             "POSTGRES_12",
-            "MYSQL_8_0"
+            "MYSQL_8_0",
+            "POSTGRES_13"
           ],
           "enumDescriptions": [
             "This is an unknown database version.",
@@ -2222,7 +2256,8 @@
             "The database version is SQL Server 2017 Web.",
             "The database version is PostgreSQL 10.",
             "The database version is PostgreSQL 12.",
-            "The database version is MySQL 8."
+            "The database version is MySQL 8.",
+            "The database version is PostgreSQL 13."
           ],
           "type": "string"
         },
@@ -2348,7 +2383,7 @@
           "description": "The user settings."
         },
         "state": {
-          "description": "The current serving state of the Cloud SQL instance. This can be one of the following. *RUNNABLE*: The instance is running, or is ready to run when accessed. *SUSPENDED*: The instance is not available, for example due to problems with billing. *PENDING_CREATE*: The instance is being created. *MAINTENANCE*: The instance is down for maintenance. *FAILED*: The instance creation failed. *UNKNOWN_STATE*: The state of the instance is unknown.",
+          "description": "The current serving state of the Cloud SQL instance. This can be one of the following. *SQL_INSTANCE_STATE_UNSPECIFIED*: The state of the instance is unknown. *RUNNABLE*: The instance has been stopped by owner. It is not currently running, but it's ready to be restarted. *SUSPENDED*: The instance is not available, for example due to problems with billing. for example due to problems with billing. *PENDING_DELETE*: The instance is being deleted. *PENDING_CREATE*: The instance is being created. *MAINTENANCE*: The instance is down for maintenance. *FAILED*: The instance creation failed.",
           "enum": [
             "SQL_INSTANCE_STATE_UNSPECIFIED",
             "RUNNABLE",
@@ -2360,12 +2395,12 @@
           ],
           "enumDescriptions": [
             "The state of the instance is unknown.",
-            "The instance is running.",
-            "The instance is currently offline, but it may run again in the future.",
+            "The instance has been stopped by owner. It is not currently running, but it's ready to be restarted.",
+            "The instance is not available, for example due to problems with billing.",
             "The instance is being deleted.",
             "The instance is being created.",
             "The instance is down for maintenance.",
-            "The instance failed to be created."
+            "The creation of the instance failed or a fatal error occurred during maintenance."
           ],
           "type": "string"
         },
@@ -2661,7 +2696,8 @@
               "SQLSERVER_2017_WEB",
               "POSTGRES_10",
               "POSTGRES_12",
-              "MYSQL_8_0"
+              "MYSQL_8_0",
+              "POSTGRES_13"
             ],
             "enumDescriptions": [
               "This is an unknown database version.",
@@ -2677,7 +2713,8 @@
               "The database version is SQL Server 2017 Web.",
               "The database version is PostgreSQL 10.",
               "The database version is PostgreSQL 12.",
-              "The database version is MySQL 8."
+              "The database version is MySQL 8.",
+              "The database version is PostgreSQL 13."
             ],
             "type": "string"
           },

diff --git a/src/apis/sqladmin/v1beta4.ts b/src/apis/sqladmin/v1beta4.ts
@@ -181,6 +181,10 @@ export namespace sqladmin_v1beta4 {
    * Database instance backup configuration.
    */
   export interface Schema$BackupConfiguration {
+    /**
+     * Backup retention settings.
+     */
+    backupRetentionSettings?: Schema$BackupRetentionSettings;
     /**
      * (MySQL only) Whether binary log is enabled. If backup configuration is disabled, binarylog must be disabled as well.
      */
@@ -209,6 +213,23 @@ export namespace sqladmin_v1beta4 {
      * Start time for the daily backup configuration in UTC timezone in the 24 hour format - *HH:MM*.
      */
     startTime?: string | null;
+    /**
+     * The number of days of transaction logs we retain for point in time restore, from 1-7.
+     */
+    transactionLogRetentionDays?: number | null;
+  }
+  /**
+   * We currently only support backup retention by specifying the number of backups we will retain.
+   */
+  export interface Schema$BackupRetentionSettings {
+    /**
+     * Depending on the value of retention_unit, this is used to determine if a backup needs to be deleted. If retention_unit is &#39;COUNT&#39;, we will retain this many backups.
+     */
+    retainedBackups?: number | null;
+    /**
+     * The unit that &#39;retained_backups&#39; represents.
+     */
+    retentionUnit?: string | null;
   }
   /**
    * A BackupRun resource.
@@ -502,7 +523,7 @@ export namespace sqladmin_v1beta4 {
      */
     settings?: Schema$Settings;
     /**
-     * The current serving state of the Cloud SQL instance. This can be one of the following. *RUNNABLE*: The instance is running, or is ready to run when accessed. *SUSPENDED*: The instance is not available, for example due to problems with billing. *PENDING_CREATE*: The instance is being created. *MAINTENANCE*: The instance is down for maintenance. *FAILED*: The instance creation failed. *UNKNOWN_STATE*: The state of the instance is unknown.
+     * The current serving state of the Cloud SQL instance. This can be one of the following. *SQL_INSTANCE_STATE_UNSPECIFIED*: The state of the instance is unknown. *RUNNABLE*: The instance has been stopped by owner. It is not currently running, but it&#39;s ready to be restarted. *SUSPENDED*: The instance is not available, for example due to problems with billing. for example due to problems with billing. *PENDING_DELETE*: The instance is being deleted. *PENDING_CREATE*: The instance is being created. *MAINTENANCE*: The instance is down for maintenance. *FAILED*: The instance creation failed.
      */
     state?: string | null;
     /**