Merge pull request #377 from linode/release-4.83.0

Release 4.83.0

Author: bbiggerr

openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.1
 info:
-  version: 4.82.0
+  version: 4.83.0
 
   title: Linode API
   description: |
@@ -6517,6 +6517,20 @@ paths:
                     description: >
                       An array of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.
                       To delete a tag, exclude it from your `tags` array.
+                k8s_version:
+                    type: string
+                    description: >
+                      The desired Kubernetes version for this Kubernetes cluster in the format of
+                      <major>.<minor>. New and recycled Nodes in this cluster will be installed with the
+                      latest available patch for the Cluster's Kubernetes version.
+
+
+                      When upgrading the Kubernetes version, only the next latest minor version following the current
+                      version can be deployed. For example, a cluster with Kubernetes version 1.16 can be upgraded to
+                      version 1.17, but not directly to 1.18.
+
+
+                      The Kubernetes version of a cluster can not be downgraded.
       responses:
         '200':
           description: Returns a single Kubernetes cluster.
@@ -6554,6 +6568,7 @@ paths:
                 -X PUT -d '{
                   "label": "lkecluster54321"
                   "tags" : ["ecomm", "blog", "prod", "monitoring"]
+                  "k8s_version": "1.17"
                 }' \
                 https://api.linode.com/v4/lke/clusters/12345
       - lang: CLI
@@ -6726,6 +6741,50 @@ paths:
           linode-cli lke pool-create 12345 \
             --type g6-standard-4 \
             --count 6
+  /lke/clusters/{clusterId}/recycle:
+    parameters:
+    - name: clusterId
+      in: path
+      description: ID of the Kubernetes cluster to be recycled.
+      required: true
+      schema:
+        type: integer
+    x-linode-cli-command: lke
+    post:
+      operationId: postLKEClusterRecycle
+      x-linode-cli-action: cluster-recycle
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - lke:read_write
+      tags:
+      - Linode Kubernetes Engine (LKE)
+      summary: Kubernetes Cluster Recycle
+      description: |
+        Recycles a designated Kubernetes Cluster. All Linodes within the Cluster 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: Recycle request succeeded and is in progress.
+          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 \
+                https://api.linode.com/v4/lke/clusters/12345/recycle
+      - lang: CLI
+        source: >
+          linode-cli lke cluster-recycle 12345
   /lke/clusters/{clusterId}/pools/{poolId}:
     parameters:
     - name: clusterId
@@ -6901,7 +6960,7 @@ paths:
         **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.
+          description: Recycle request succeeded and is in progress.
           content:
             application/json:
               schema:
@@ -6918,6 +6977,132 @@ paths:
       - lang: CLI
         source: >
           linode-cli lke pool-recycle 12345 456
+  /lke/clusters/{clusterID}/nodes/{nodeId}:
+    parameters:
+    - name: clusterId
+      in: path
+      description: ID of the Kubernetes cluster containing the Node.
+      required: true
+      schema:
+        type: integer
+    - name: nodeId
+      in: path
+      description: ID of the Node to look up.
+      required: true
+      schema:
+        type: string
+    x-linode-cli-command: lke
+    get:
+      operationId: getLKEClusterNode
+      x-linode-cli-action: node-view
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - lke:read_write
+      tags:
+      - Linode Kubernetes Engine (LKE)
+      summary: Node View
+      description: >
+        Returns the values for a specified node object.
+      responses:
+        '200':
+          description: Returns the values of a node object in the form that it appears currently in the node pool array.
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: object
+                    description: >
+                      The selected node in the cluster.
+                    properties:
+                      id:
+                        type: string
+                        readOnly: true
+                        description: >
+                          The Node's ID.
+                        example: "12345-6aa78910bc"
+                      instance_id:
+                        type: integer
+                        description: >
+                          The Linode's ID. If no Linode is currently provisioned for this Node, this is `null`.
+                        example: 123456
+                      status:
+                        type: string
+                        description: >
+                          The creation status of this Node. This status is distinct from this Node's readiness as a
+                          Kubernetes Node Object as determined by the command `kubectl get nodes`.
+
+
+                          `not_ready` indicates that the Linode is still being created.
+
+
+                          `ready` indicates that the Linode has successfully been created and is running Kubernetes software.
+                        enum:
+                        - ready
+                        - not_ready
+                        example: ready
+        default:
+          $ref: '#/components/responses/ErrorResponse'
+      x-code-samples:
+      - lang: Shell
+        source: >
+          curl -H "Authorization: Bearer $TOKEN" \
+                https://api.linode.com/v4/lke/clusters/12345/nodes/12345-6aa78910bc
+      - lang: CLI
+        source: >
+          linode-cli lke node-view 123456 12345-6aa78910bc
+  /lke/clusters/{clusterId}/nodes/{nodeId}/recycle:
+    parameters:
+    - name: clusterId
+      in: path
+      description: ID of the Kubernetes cluster containing the Node.
+      required: true
+      schema:
+        type: integer
+    - name: nodeId
+      in: path
+      description: ID of the Node to be recycled.
+      required: true
+      schema:
+        type: string
+    x-linode-cli-command: lke
+    post:
+      operationId: postLKEClusterNodeRecycle
+      x-linode-cli-action: pool-recycle
+      security:
+      - personalAccessToken: []
+      - oauth:
+        - lke:read_write
+      tags:
+      - Linode Kubernetes Engine (LKE)
+      summary: Node Recycle
+      description: |
+        Recycles an individual Node in the designated Kubernetes Cluster. The Node will be deleted
+        and replaced with a new Linode, which may take a few 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: Recycle request succeeded and is in progress.
+          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 \
+                https://api.linode.com/v4/lke/clusters/12345/nodes/12345-6aa78910bc/recycle
+      - lang: CLI
+        source: >
+          linode-cli lke node-recycle 12345 12345-6aa78910bc
   /lke/clusters/{clusterId}/api-endpoints:
     parameters:
     - name: clusterId
@@ -6976,7 +7161,7 @@ paths:
                 https://api.linode.com/v4/lke/clusters/12345/api-endpoints
       - lang: CLI
         source: >
-          linode-cli lke api-endpoint-list 12345
+          linode-cli lke api-endpoints-list 12345
   /lke/clusters/{clusterId}/kubeconfig:
     parameters:
     - name: clusterId
@@ -14167,7 +14352,7 @@ paths:
         source: >
           curl -H "Content-Type: application/json" \
               -H "Authorization: Bearer $TOKEN" \
-              -X PUT -d '{
+              -X POST -d '{
                 "label": "my-volume"
               }' \
               https://api.linode.com/v4/volumes/12345