Add POST /networking/ips/assign

Author: bbiggerr

openapi.yaml

@@ -10185,20 +10185,121 @@ paths:
           linode-cli networking ip-update \
             97.107.143.141 \
             --rdns "test.example.org"
-  /networking/ipv4/assign:
+  /networking/ips/assign:
     x-linode-cli-command: networking
     post:
       x-linode-grant: read_write
       tags:
       - Networking
       summary: Linodes Assign IPs
+      description: |
+        Assign multiple IPv4 addresses and/or IPv6 ranges to multiple Linodes in one Region. This allows
+        swapping, shuffling, or otherwise reorganizing IPs to your Linodes.
+
+        The following restrictions apply:
+        * All Linodes involved must have at least one public IPv4 address after assignment.
+        * Linodes may have no more than one assigned private IPv4 address.
+        * Linodes may have no more than one assigned IPv6 range.
+      operationId: assignIPs
+      x-linode-cli-action: ip-assign
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - ips:read_write
+        - linodes:read_write
+      requestBody:
+        description: >
+          Information about what IPv4 address or IPv6 range to assign, and to which Linode.
+        required: true
+        content:
+          application/json:
+            schema:
+              required:
+              - region
+              - assignments
+              properties:
+                region:
+                  type: string
+                  description: >
+                    The ID of the Region in which these assignments are to take
+                    place. All IPs and Linodes must exist in this Region.
+                  example: us-east
+                assignments:
+                  type: array
+                  description: >
+                    The list of assignments to make. You must have read_write
+                    access to all IPs being assigned and all Linodes being
+                    assigned to in order for the assignments to succeed.
+                  items:
+                    type: object
+                    properties:
+                      address:
+                        type: string
+                        format: ip
+                        description: |
+                          The IPv4 address or IPv6 range for this assignment.
+                          * Must be an IPv4 address or an IPv6 range you can access in the Region specified.
+                          * IPv6 ranges must include a subnet prefix and prefix length of `/56` or `/64`, for example: `2001:db8:3c4d:15::/64`.
+                          * May be a public or private address.
+                        example: 12.34.56.78
+                      linode_id:
+                        type: integer
+                        description: >
+                          The ID of the Linode to assign this address to. The IP's
+                          previous Linode will lose this address, and must end up
+                          with at least one public address and no more than one
+                          private address once all assignments have been made.
+                        example: 123
+      responses:
+        '200':
+          description: All assignments completed 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 -d '{
+                "region": "us-east",
+                "assignments": [
+                  {
+                    "address": "12.34.56.100",
+                    "linode_id": 123
+                  },
+                  {
+                    "address": "2001:db8:3c4d:15::/64",
+                    "linode_id": 234
+                  }
+                ]
+              }' \
+              https://api.linode.com/v4/networking/ipvs/assign
+      - lang: CLI
+        source: >
+          linode-cli networking ip-assign \
+            --region us-east \
+            --assignments.address 2001:db8:3c4d:15::/64 \
+            --assignments.linode_id 123
+  /networking/ipv4/assign:
+    x-linode-cli-command: networking
+    post:
+      x-linode-grant: read_write
+      tags:
+      - Networking
+      summary: Linodes Assign IPv4s
       description: >
-        Assign multiple IPs to multiple Linodes in one Region. This allows
+        Assign multiple IPv4s to multiple Linodes in one Region. This allows
         swapping, shuffling, or otherwise reorganizing IPv4 Addresses to your
         Linodes.  When the assignment is finished, all Linodes must end up with
         at least one public IPv4 and no more than one private IPv4.
+
+        To assign IPv6 ranges or to use the CLI, see the Linodes Assign IPs ([POST /networking/ips/assign](/docs/api/networking/#linodes-assign-ips)) endpoint.
       operationId: assignIPs
-      x-linode-cli-action: ip-assign
+      x-linode-cli-skip: true
       security:
       - personalAccessToken: []
       - oauth:
@@ -10274,14 +10375,6 @@ paths:
                 ]
               }' \
               https://api.linode.com/v4/networking/ipv4/assign
-      - lang: CLI
-        source: >
-          linode-cli networking ip-assign \
-            --region us-east \
-            --assignments \
-              '{"address": "12.34.56.100", "linode_id": 123}' \
-            --assignments \
-              '{"23.45.67.200", "linode_id": 234}'
   /networking/ipv4/share:
     x-linode-cli-command: networking
     post: