Merge pull request #860 from bbiggerr/region-price-tiers

Region-specific prices

Author: bbiggerr

openapi.yaml

@@ -2848,6 +2848,8 @@ paths:
           description: Returns a single Transfer object.
           content:
             application/json:
+              x-linode-cli-subtables:
+              - region_transfers
               schema:
                 $ref: '#/components/schemas/Transfer'
         default:
@@ -3188,7 +3190,7 @@ paths:
                     "global": {
                       "add_linodes": true,
                       "add_nodebalancers": false,
-                      "add_databases": true;
+                      "add_databases": true,
                       "add_domains": true,
                       "add_longview": false,
                       "add_stackscripts": true,
@@ -8439,22 +8441,20 @@ paths:
     post:
       x-linode-grant: read_write
       summary: DC Migration/Pending Host Migration Initiate
-      description: >
+      description: |
         Initiate a pending host migration that has been scheduled by Linode or
         initiate a cross data center (DC) migration.  A list of pending migrations,
         if any, can be accessed from [GET /account/notifications](/docs/api/account/#notifications-list).
         When the migration begins, your Linode will be shutdown if not already off.
         If the migration initiated the shutdown, it will reboot the Linode when completed.
 
-
         To initiate a cross DC migration, you must pass a `region` parameter to the
         request body specifying the target data center region.
         You can view a list of all available regions and their feature capabilities
-        from [GET /regions](/docs/api/regions/#regions-list). If your Linode has a DC migration already queued
+        from [GET /regions](/docs/api/regions/#regions-list). See our [Pricing Page](https://www.linode.com/pricing/) for Region-specific pricing, which applies after migration is complete. If your Linode has a DC migration already queued
         or you have initiated a previously scheduled migration, you will not be able to initiate
         a DC migration until it has completed.
 
-
         **Note:** Next Generation Network (NGN) data centers do not support IPv6 `/116` pools or IP Failover.
         If you have these features enabled on your Linode and attempt to migrate to an NGN data center,
         the migration will not initiate. If a Linode cannot be migrated because of an incompatibility,
@@ -9645,6 +9645,8 @@ paths:
           description: A single Linode Type.
           content:
             application/json:
+              x-linode-cli-subtables:
+              - region_prices
               schema:
                 $ref: '#/components/schemas/LinodeType'
         default:
@@ -10748,7 +10750,7 @@ paths:
           curl -H "Content-Type: application/json" \
                 -H "Authorization: Bearer $TOKEN" \
                 -X POST -d '{
-                  "kubeconfig": true;
+                  "kubeconfig": true,
                   "servicetoken": true
                 }' \
                 https://api.linode.com/v4/lke/clusters/12345/regenerate
@@ -21890,6 +21892,18 @@ components:
           description: The amount of the Invoice after taxes in US Dollars.
           example: 132.50
           x-linode-cli-display: 6
+        billing_source:
+          type: string
+          enum:
+          - akamai
+          - linode
+          readOnly: true
+          description: |
+            `akamai`: This Invoice was generated according to the terms of an agreement between the customer and Akamai.
+
+            `linode`: This Invoice was generated according to the default terms, prices, and discounts.
+          example: linode
+          x-linode-cli-display: 3.5
     InvoiceItem:
       type: object
       description: An InvoiceItem object.
@@ -21950,6 +21964,16 @@ components:
           readOnly: true
           description: The monthly service fee in US Dollars for this Item.
           example: 5.05
+        region:
+          type: string
+          readOnly: true
+          nullable: true
+          description: |
+            The ID of the applicable Region associated with this Invoice Item.
+
+            `null` if there is no applicable Region.
+          example: us-west
+          x-linode-cli-display: 7
     IPAddress:
       type: object
       description: >
@@ -23341,8 +23365,10 @@ components:
         price:
           type: object
           readOnly: true
-          description: >
-            Cost in US dollars, broken down into hourly and monthly charges.
+          description: |
+            The default cost of provisioning this Linode Type. Prices are in US dollars, broken down into hourly and monthly charges.
+
+            Certain Regions have different prices from the default. For Region-specific prices, see `region_prices`.
           properties:
             hourly:
               type: number
@@ -23354,6 +23380,23 @@ components:
               description: Cost (in US dollars) per month.
               example: 20
               x-linode-cli-display: 10
+        region_prices:
+          type: array
+          items:
+            type: object
+            properties:
+              id:
+                type: string
+                description: The Region ID for these prices.
+                example: us-east
+              hourly:
+                type: number
+                description: Cost (in US dollars) per hour for this Region.
+                example: 0.036
+              monthly:
+                type: number
+                description: Cost (in US dollars) per month for this Region.
+                example: 24
         addons:
           type: object
           readOnly: true
@@ -23369,7 +23412,10 @@ components:
               properties:
                 price:
                   type: object
-                  description: Cost of enabling Backups for this Linode Type.
+                  description: |
+                    The default cost of enabling Backups for this Linode Type. Prices are in US dollars, broken down into hourly and monthly charges.
+
+                    Certain Regions have different prices from the default. For Region-specific prices, see `region_prices`.
                   properties:
                     hourly:
                       type: number
@@ -23381,6 +23427,23 @@ components:
                       description: >
                         The cost (in US dollars) per month to add Backups service.
                       example: 5
+                region_prices:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                        description: The Region ID for these prices.
+                        example: us-east
+                      hourly:
+                        type: number
+                        description: Cost (in US dollars) per hour to add Backups service in this Region.
+                        example: 0.0096
+                      monthly:
+                        type: number
+                        description: Cost (in US dollars) per month to add Backups service in this Region.
+                        example: 6
         network_out:
           x-linode-filterable: true
           type: integer
@@ -23429,7 +23492,7 @@ components:
           description: >
             The number of GPUs this Linode Type offers.
           example: 0
-          x-linode-cli-display: 11
+          x-linode-cli-display: 6.5
     LKECluster:
       type: object
       description: A Kubernetes cluster.
@@ -26381,14 +26444,15 @@ components:
           example: null
     Transfer:
       type: object
-      description: >
-        An object representing your network utilization for the current month,
-        in Gigabytes.
+      description: |
+        An object representing your network utilization for the current month, in Gigabytes.
+
+        Certain Regions have separate utilization quotas and rates. For Region-specific network utilization data, see `region_transfers`.
       properties:
         billable:
           type: integer
           readOnly: true
-          description: >
+          description: |
             The amount of your transfer pool that is billable this billing cycle.
           example: 0
           x-linode-cli-display: 3
@@ -26406,6 +26470,33 @@ components:
             The amount of network usage you have used this billing cycle.
           example: 2
           x-linode-cli-display: 2
+        region_transfers:
+          type: array
+          items:
+            type: object
+            properties:
+              id:
+                type: string
+                description: The Region ID for this network utilization data.
+                example: us-east
+              billable:
+                type: integer
+                readOnly: true
+                description: |
+                  The amount of your transfer pool that is billable this billing cycle for this Region.
+                example: 0
+              quota:
+                type: integer
+                readOnly: true
+                description: >
+                  The amount of network usage allowed this billing cycle for this Region.
+                example: 5010
+              used:
+                type: integer
+                readOnly: true
+                description: >
+                  The amount of network usage you have used this billing cycle for this Region.
+                example: 1
     Tag:
       type: object
       description: >