Merge pull request #299 from linode/release-4.70.0

Release 4.70.0

Author: hzoppetti

openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.1
 info:
-  version: 4.69.0
+  version: 4.70.0
 
   title: Linode API
   description: |
@@ -84,7 +84,7 @@ info:
     | 4.  The login server redirects the user to the specificed redirect URL with a temporary authorization `code` (exchange code) in the URL. | 4.  The login server redirects the user back to your application with an OAuth `access_token` embedded in the redirect URL's hash. This is temporary and expires in two hours. No `refresh_token` is issued. Therefore, once the `access_token` expires, a new one will need to be issued by having the user log in again. |
     | 5.  The application issues a POST request (*see below*) to the login server with the exchange code, `client_id`, and the client application's `client_secret`. | |
     | 6.  The login server responds to the client application with a new OAuth `access_token` and `refresh_token`. The `access_token` is set to expire in two hours. | |
-    | 7.  The `refresh_token` can be used by contacting the login server with the `client_id`, `client_secret`, and `refresh_token` to get a new OAuth `access_token` and `refresh_token`. The new `access_token` is good for another two hours, and the new `refresh_token`, can be used to extend the session again by this same method. | |
+    | 7.  The `refresh_token` can be used by contacting the login server with the `client_id`, `client_secret`, `grant_type`, and `refresh_token` to get a new OAuth `access_token` and `refresh_token`. The new `access_token` is good for another two hours, and the new `refresh_token`, can be used to extend the session again by this same method. | |
 
     ### OAuth Private Workflow - Additional Details
 
@@ -103,6 +103,7 @@ info:
 
     | PARAMETER | DESCRIPTION |
     |-----------|-------------|
+    | grant_type | The grant type you're using for renewal.  Currently only the string "refresh_token" is accepted. |
     | client_id | Your app's client ID. |
     | client_secret | Your app's client secret. |
     | code | The code you just received from the redirect. |
@@ -4630,15 +4631,7 @@ paths:
                   description: >
                     The new root password for the OS installed on this Disk.
 
-                    The password must contain at least two of these four
-                    character classes:
-
-                      * lowercase letters
-                      * uppercase letters
-                      * numbers
-                      * punctuation
-                  minLength: 6
-                  maxLength: 128
+                    The password must meet the complexity strength validation requirements for a strong password.
                   example: another@complex^Password123
       responses:
         '200':
@@ -5095,7 +5088,7 @@ paths:
     x-linode-cli-command: linodes
     post:
       x-linode-grant: read_write
-      summary: Initiate Pending Host Migration/DC Migration
+      summary: Initiate DC Migration/Pending Host Migration
       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,
@@ -6649,10 +6642,12 @@ paths:
       tags:
       - Linode Kubernetes Engine (LKE)
       summary: Update Node Pool
-      description: >
-        Updates a Node Pool. When a Node Pool's count are
-        changed, the nodes in that pool will be replaced in a rolling
-        fashion.
+      description: |
+        Updates a Node Pool's count.
+
+        Linodes will be created or deleted to match changes to the Node Pool's count.
+
+        **Any local storage on deleted Linodes (such as "hostPath" and "emptyDir" volumes, or "local" PersistentVolumes) will be erased.**
       requestBody:
         description: The fields to update
         content:
@@ -6726,6 +6721,52 @@ paths:
       - lang: CLI
         source: >
           linode-cli lke pool-delete 12345 456
+  /lke/clusters/{clusterId}/pools/{poolId}/recycle:
+    parameters:
+    - name: clusterId
+      in: path
+      description: ID of the Kubernetes cluster this Node Pool is attached to.
+      required: true
+      schema:
+        type: integer
+    - name: poolId
+      in: path
+      description: ID of the Node Pool to be recycled.
+      required: true
+      schema:
+        type: integer
+    x-linode-cli-command: lke
+    post:
+      operationId: postLKEClusterPoolRecycle
+      x-linode-cli-action: pool-recycle
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - lke:read_write
+      tags:
+      - Linode Kubernetes Engine (LKE)
+      summary: Recycle Node Pool
+      description: |
+        Recycles a Node Pool for the designated Kubernetes Cluster. All Linodes within the Node Pool will be deleted
+        and replaced with new Linodes on a rolling basis, which may take several minutes. Replacement Nodes are
+        installed with the latest available patch for the Cluster's Kubernetes Version.
+
+        **Any local storage on deleted Linodes (such as "hostPath" and "emptyDir" volumes, or "local" PersistentVolumes) will be erased.**
+      responses:
+        '200':
+          description: Node Pool has been recycled.
+        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/lke/clusters/12345/pools/456/recycle
+      - lang: CLI
+        source: >
+          linode-cli lke pool-recycle 12345 456
   /lke/clusters/{clusterId}/api-endpoints:
     parameters:
     - name: clusterId
@@ -7593,8 +7634,6 @@ paths:
                     example: johndoe
                   password:
                     type: string
-                    minLength: 0
-                    maxLength: 5000
                     description: >
                       The password to use when accessing the Managed Service.
                     example: s3cur3P@ssw0rd
@@ -7750,8 +7789,6 @@ paths:
                   example: johndoe
                 password:
                   type: string
-                  minLength: 0
-                  maxLength: 5000
                   description: >
                     The password to use when accessing the Managed Service.
                   example: s3cur3P@ssw0rd
@@ -13780,20 +13817,10 @@ components:
           writeOnly: true
           example: aComplexP@ssword
           description: |
-            This will set the root user's password on the newly-created Linode.
-            The root password must conform to the following constraints:
-
-              * May only use alphanumerics, punctuation, spaces, and tabs.
-              * Must contain at least two of the following characters classes:
-                * Upper-case letters
-                * Lower-case letters
-                * Digits
-                * Punctuation
+            This will set the root user's password on the newly-created Linode. Linode passwords have the following constraints:
+
               * Must meet a password strength score requirement that is calculated internally by the API.
                 If the strength requirement is not met, you will receive a `Password does not meet strength requirement` error.
-          minLength: 6
-          maxLength: 128
-          pattern: ^(((?=.*[a-z])(?=.*[A-Z]))|((?=.*[a-z])(?=.*[0-9]))|((?=.*[A-Z])(?=.*[0-9]))|((?=.*[a-z])(?=.*[!"#$%&'()*+,-.\/:;<=>?@\[\]^_`{|}~\\]))|((?=.*[A-Z])(?=.*[!"#$%&'()*+,-.\/:;<=>?@\[\]^_`{|}~\\]))|((?=.*[0-9])(?=.*[!"#$%&'()*+,-.\/:;<=>?@\[\]^_`{|}~\\])))
         stackscript_id:
           type: integer
           example: 10079