Updates for DC Get Well Acct Availability (#939)

Author: Vernholio

openapi.yaml

@@ -548,16 +548,17 @@ paths:
     get:
       tags:
       - account
+      parameters:
+      - $ref: '#/components/parameters/pageOffset'
+      - $ref: '#/components/parameters/pageSize'
       summary: Account Availability
       description: |
-        Returns service unavailability for all available regions.
+        Returns a paginated list of the services available to you, for all Linode regions.
 
-        Only authorized Users can access this endpoint.
-
-        *This endpoint is currently in **Beta**, and should not be used for production workloads.*
+        **Note**: Only authorized Users can access this endpoint.
       operationId: getAvailability
       servers:
-      - url: https://api.linode.com/v4beta
+      - url: https://api.linode.com/v4
       security:
       - personalAccessToken: []
       - oauth:
@@ -567,7 +568,7 @@ paths:
       responses:
         '200':
           description: |
-            Returns a paginated list of regions and their unavailable resources.
+            List of regions and the services available in each.
           content:
             application/json:
               schema:
@@ -594,7 +595,7 @@ paths:
     parameters:
       - name: id
         in: path
-        description: The id of the data center.
+        description: The slug for the applicable data center. Run the [GET /regions](/docs/api/regions/#regions-list) operation to view the slug for each data center.
         required: true
         schema:
           type: string
@@ -603,12 +604,12 @@ paths:
       - account
       summary: Region Service Availability
       description: |
-        Returns a single region's service availability.
+        View the available services for your account in a specific region.
 
-        Only authorized Users can access this.
+        **Note**: Only authorized users can access this.
       operationId: getAccountAvailability
       servers:
-      - url: https://api.linode.com/v4beta
+      - url: https://api.linode.com/v4
       security:
       - personalAccessToken: []
       - oauth:
@@ -617,7 +618,7 @@ paths:
       x-linode-grant: read_only
       responses:
         '200':
-          description: Returns an object with a region and the region's unavailable resources.
+          description: The services available in the specified region.
           content:
             application/json:
               schema:
@@ -20846,20 +20847,30 @@ components:
           type: string
           readOnly: true
           description: >
-            Displays the data center represented by a slug.
+            The Akamai cloud computing data center (region), represented by a slug value. You can view a full list of regions and their associated slugs via the [GET /regions](/docs/api/regions/#regions-list) endpoint.
           example: us-east
           x-linode-cli-display: 1
-        unavailable:
+        available:
           type: array
+          items:
+            type: string
           readOnly: true
-          description: >
-            A list of strings of unavailable services.
+          description: |
+            A list of services *available* to your account in the `region`.
           example:
           - "Linodes"
-          - "Block Storage"
+          - "NodeBalancers"
+        unavailable:
+          type: array
           items:
             type: string
-          x-linode-cli-display: 2
+          readOnly: true
+          description: >
+            A list of services *unavailable* to your account in the `region`.
+          example:
+          - "Kubernetes"
+          - "Block Storage"
+          x-linode-cli-display: 3
     AccountSettings:
       type: object
       description: Account Settings object