Merge pull request #515 from bbiggerr/volumes-migration-cancel

[New] Volume Migration Cancel

Author: bbiggerr

openapi.yaml

@@ -15717,6 +15717,54 @@ paths:
       - lang: CLI
         source: >
           linode-cli volumes detach 12345
+  /volumes/{volumeId}/migration-cancel:
+    parameters:
+    - name: volumeId
+      in: path
+      description: ID of the Volume to look up.
+      required: true
+      schema:
+        type: integer
+    x-linode-cli-command: volumes
+    post:
+      x-linode-grant: read_write
+      tags:
+      - Volumes
+      summary: Volume Migration Cancel
+      description: |
+        Cancels the customer-initiated migration for the Volume.
+
+        Cancelled migrations are removed from the migration queue, then reset to occur on the original scheduled migration date.
+
+        A Volume migration cannot be cancelled in the following cases:
+          * The migration is already in progress.
+          * The migration was automatically queued on the scheduled date.
+      operationId: cancelVolumeMigration
+      x-linode-cli-action: migration-cancel
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - volumes:read_write
+        - linodes:read_write
+      responses:
+        '200':
+          description: Migration cancelled successfully.
+          content:
+            application/json:
+              schema:
+                type: object
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Content-Type: application/json" \
+              -H "Authorization: Bearer $TOKEN" \
+              -X POST \
+              https://api.linode.com/v4/volumes/12345/migration-cancel
+      - lang: CLI
+        source: >
+          linode-cli volumes migration-cancel 12345
   /volumes/{volumeId}/resize:
     parameters:
     - name: volumeId