Add GET networking/ipv6/ranges/{range}

Author: bbiggerr

openapi.yaml

@@ -10323,7 +10323,7 @@ paths:
         the primary Linode becomes unresponsive. This means that requests to the primary Linode's IP address can be
         automatically rerouted to secondary Linodes at the configured shared IP addresses.
 
-        IP failover requires configuration of a failover service (such as [Keepalived](/docs/guides/ip-failover-keepalived#configuring-ip-sharing))
+        IP failover requires configuration of a failover service (such as [Keepalived](/docs/guides/ip-failover-keepalived))
         within the internal system of the primary Linode.
 
         **Note**: IPv6 range sharing has limited availability in certain regions. Please contact customer support for
@@ -10360,20 +10360,20 @@ paths:
                   items:
                     type: string
                     format: ip
-                    example: 192.0.2.1
                   description: |
                     A list of secondary Linode IPs to share with the primary Linode.
                     * Can include both IPv4 addresses and IPv6 ranges (omit /56 and /64 prefix lengths)
                     * Can include both private and public IPv4 addresses.
                     * You must have access to all of these addresses and they must be in the same Region as the primary
                     Linode.
+                    * Enter an empty array to remove all shared IP addresses.
       responses:
         '200':
-          description: IP Address allocated successfully.
+          description: IP Address sharing successful.
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/IPAddress'
+                type: object
         default:
           $ref: '#/components/responses/ErrorResponse'
       x-code-samples:
@@ -10388,7 +10388,7 @@ paths:
                   "192.0.2.2"
                 ]
               }' \
-              https://api.linode.com/v4/networking/ips/share
+              https://api.linode.com/v4beta2/networking/ips/share
       - lang: CLI
         source: >
           linode-cli networking ip-share \
@@ -10495,7 +10495,7 @@ paths:
       x-linode-grant: read_write
       tags:
       - Networking
-      summary: IP Sharing Configure
+      summary: IPv4 Sharing Configure
       description: >
         Configure shared IPs.  A shared IP may be brought up on a Linode other
         than the one it lists in its response.  This can be used to allow one
@@ -10770,12 +10770,42 @@ paths:
           type: string
           format: ipv6
     x-linode-cli-command: networking
+    get:
+      tags:
+      - Networking
+      summary: IPv6 Range View
+      description: |
+        View IPv6 range information.
+      operationId: getIPv6Range
+      x-linode-cli-action: v6-range-view
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - ips:read
+      responses:
+        '200':
+          description: Returns IPv6 range information.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/IPv6RangeBGP'
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" https://api.linode.com/v4/networking/ipv6/ranges/2001:0db8::
+      - lang: CLI
+        source: >
+          linode-cli networking v6-range-view 2001:0db8::
     delete:
       tags:
       - Networking
       summary: IPv6 Range Delete
       description: |
         Removes this IPv6 range from your account and disconnects the range from any assigned Linodes.
+
+        **Note:** Shared IPv6 ranges cannot be deleted at this time. Please contact Customer Support for assistance.
       operationId: deleteIPv6Range
       x-linode-cli-action: v6-range-delete
       security:
@@ -18550,6 +18580,45 @@ components:
             The last address in this block of IPv6 addresses.
           example: '2600:3c01::ffff:ffff:ffff:ffff'
           nullable: true
+    IPv6RangeBGP:
+      type: object
+      description: >
+        An object representing an IPv6 range.
+      properties:
+        range:
+          type: string
+          description: >
+            The IPv6 range of addresses in this pool.
+          example: '2600:3c01::'
+          readOnly: true
+          x-linode-cli-display: 1
+        prefix:
+          type: integer
+          description: >
+            The prefix length of the address, denoting how many addresses can be
+            assigned from this range calculated as 2 <sup>128-prefix</sup>.
+          example: 64
+          x-linode-cli-display: 2
+        region:
+          type: string
+          description: >
+            The region for this range of IPv6 addresses.
+          example: us-east
+          readOnly: true
+          x-linode-cli-display: 3
+        is_bgp:
+          type: boolean
+          description: >
+            Whether this IPv6 range is shared.
+          example: false
+        linodes:
+          type: array
+          items:
+            type: integer
+          example:
+          - 123
+          description: >
+            A list of Linodes targeted by this IPv6 range. Includes Linodes with IP sharing.
     Kernel:
       type: object
       description: Linux kernel object