Fixes for Database Backup Snapshot Create

Author: bbiggerr

openapi.yaml

@@ -3611,9 +3611,11 @@ paths:
 
         Requires `read_write` access to the Database.
 
+        Up to 3 snapshot backups for each Database can be stored at a time. If 3 snapshots have been created for a Database, one must be deleted before another can be made.
+
         Backups generated by this command have the type `snapshot`. Snapshot backups may take several minutes to complete, after which they will be accessible to view or restore.
 
-        The Database must have an `active` status to perform this command.
+        The Database must have an `active` status to perform this command. If another backup is in progress, it must complete before a new backup can be initiated.
 
         **Note**: New MongoDB Databases cannot currently be created.
       security:
@@ -3625,30 +3627,7 @@ paths:
         content:
           application/json:
             schema:
-              required:
-              - label
-              type: object
-              properties:
-                label:
-                  type: string
-                  minLength: 3
-                  maxLength: 64
-                  description: |
-                    The label for the Database snapshot backup.
-                    * Must use only letters, numbers, underscores, dashes, and periods.
-                    * Must begin and end with a letter or number.
-                    * Must not include two dashes, underscores, or periods in a row.
-                  example: db-snapshot
-                target:
-                  type: string
-                  enum:
-                  - primary
-                  - secondary
-                  default: primary
-                  description: |
-                    The Database cluster target.
-                    If the Database is a high availability cluster, choosing `secondary` creates a snapshot backup of a replica node.
-                  example: primary
+              $ref: '#/components/schemas/DatabaseBackupSnapshot'
       responses:
         '200':
           description: Database snapshot backup request successful.
@@ -3662,15 +3641,16 @@ paths:
       - lang: Shell
         source: >
           curl -H "Authorization: Bearer $TOKEN" \
+              -H "Content-Type: application/json" \
               -X POST -d '{
-                  "label": "db-snapshot",
+                  "label": "snapshot1",
                   "target": "primary"
               }' \
               https://api.linode.com/v4/databases/mongodb/instances/123/backups/
       - lang: CLI
         source: >
           linode-cli databases mongodb-backup-snapshot 123 \
-            --label db-snapshot \
+            --label snapshot1 \
             --target primary
   /databases/mongodb/instances/{instanceId}/backups/{backupId}:
     x-linode-cli-command: databases
@@ -4399,9 +4379,11 @@ paths:
 
         Requires `read_write` access to the Database.
 
+        Up to 3 snapshot backups for each Database can be stored at a time. If 3 snapshots have been created for a Database, one must be deleted before another can be made.
+
         Backups generated by this command have the type `snapshot`. Snapshot backups may take several minutes to complete, after which they will be accessible to view or restore.
 
-        The Database must have an `active` status to perform this command.
+        The Database must have an `active` status to perform this command. If another backup is in progress, it must complete before a new backup can be initiated.
       security:
       - personalAccessToken: []
       - oauth:
@@ -4411,32 +4393,7 @@ paths:
         content:
           application/json:
             schema:
-              required:
-              - label
-              type: object
-              properties:
-                label:
-                  type: string
-                  minLength: 3
-                  maxLength: 64
-                  description: |
-                    The label for the Database snapshot backup.
-
-                    * Must use only letters, numbers, underscores, dashes, and periods.
-                    * Must begin and end with a letter or number.
-                    * Must not include two dashes, underscores, or periods in a row.
-                  example: db-snapshot
-                target:
-                  type: string
-                  enum:
-                  - primary
-                  - secondary
-                  default: primary
-                  description: |
-                    The Database cluster target.
-
-                    If the Database is a high availability cluster, choosing `secondary` creates a snapshot backup of a replica node.
-                  example: primary
+              $ref: '#/components/schemas/DatabaseBackupSnapshot'
       responses:
         '200':
           description: Database snapshot backup request successful.
@@ -4450,15 +4407,16 @@ paths:
       - lang: Shell
         source: >
           curl -H "Authorization: Bearer $TOKEN" \
+              -H "Content-Type: application/json" \
               -X POST -d '{
-                  "label": "db-snapshot",
+                  "label": "snapshot1",
                   "target": "primary"
               }' \
               https://api.linode.com/v4/databases/mysql/instances/123/backups/
       - lang: CLI
         source: >
           linode-cli databases mysql-backup-snapshot 123 \
-            --label db-snapshot \
+            --label snapshot1 \
             --target primary
   /databases/mysql/instances/{instanceId}/backups/{backupId}:
     x-linode-cli-command: databases
@@ -5176,9 +5134,11 @@ paths:
 
         Requires `read_write` access to the Database.
 
+        Up to 3 snapshot backups for each Database can be stored at a time. If 3 snapshots have been created for a Database, one must be deleted before another can be made.
+
         Backups generated by this command have the type `snapshot`. Snapshot backups may take several minutes to complete, after which they will be accessible to view or restore.
 
-        The Database must have an `active` status to perform this command.
+        The Database must have an `active` status to perform this command. If another backup is in progress, it must complete before a new backup can be initiated.
       security:
       - personalAccessToken: []
       - oauth:
@@ -5188,32 +5148,7 @@ paths:
         content:
           application/json:
             schema:
-              required:
-              - label
-              type: object
-              properties:
-                label:
-                  type: string
-                  minLength: 3
-                  maxLength: 64
-                  description: |
-                    The label for the Database snapshot backup.
-
-                    * Must use only letters, numbers, underscores, dashes, and periods.
-                    * Must begin and end with a letter or number.
-                    * Must not include two dashes, underscores, or periods in a row.
-                  example: db-snapshot
-                target:
-                  type: string
-                  enum:
-                  - primary
-                  - secondary
-                  default: primary
-                  description: |
-                    The Database cluster target.
-
-                    If the Database is a high availability cluster, choosing `secondary` creates a snapshot backup of a replica node.
-                  example: primary
+              $ref: '#/components/schemas/DatabaseBackupSnapshot'
       responses:
         '200':
           description: Database snapshot backup request successful.
@@ -5227,15 +5162,16 @@ paths:
       - lang: Shell
         source: >
           curl -H "Authorization: Bearer $TOKEN" \
+              -H "Content-Type: application/json" \
               -X POST -d '{
-                  "label": "db-snapshot",
+                  "label": "snapshot1",
                   "target": "primary"
               }' \
               https://api.linode.com/v4/databases/postgresql/instances/123/backups/
       - lang: CLI
         source: >
           linode-cli databases postgresql-backup-snapshot 123 \
-            --label db-snapshot \
+            --label snapshot1 \
             --target primary
   /databases/postgresql/instances/{instanceId}/backups/{backupId}:
     x-linode-cli-command: databases
@@ -20059,6 +19995,32 @@ components:
           description: A time value given in a combined date and time format that represents when the database backup was created.
           x-linode-filterable: true
           x-linode-cli-display: 4
+    DatabaseBackupSnapshot:
+      type: object
+      description: Managed Database request object for snapshot backup.
+      required:
+        - label
+      properties:
+        label:
+          type: string
+          minLength: 1
+          maxLength: 30
+          description: |
+            The label for the Database snapshot backup.
+
+            * Must include only ASCII letters or numbers.
+            * Must be unique among other backup labels for this Database.
+          example: db-snapshot
+        target:
+          type: string
+          enum:
+          - primary
+          - secondary
+          default: primary
+          description: |
+            The Database cluster target.
+            If the Database is a high availability cluster, choosing `secondary` creates a snapshot backup of a replica node.
+          example: primary
     DatabaseCredentials:
       type: object
       description: Managed Database object for database credentials.