[Release] 4.69.0

README.md

@@ -1,5 +1,7 @@
 # Linode OpenAPI 3
 
+[![Build Status](https://travis-ci.com/linode/linode-api-docs.svg?branch=master)](https://travis-ci.com/linode/linode-api-docs)
+
 This is the Linode API OpenAPI 3 Schema
 
 ## Requirements

openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.1
 info:
-  version: 4.68.0
+  version: 4.69.0
 
   title: Linode API
   description: |
@@ -6241,13 +6241,19 @@ paths:
               - region
               - k8s_version
               - node_pools
-              allOf:
-              - $ref: '#/components/schemas/LKEClusterRequestBody'
-              - properties:
-                  node_pools:
-                    type: array
-                    items:
-                      $ref: '#/components/schemas/LKENodePoolRequestBody'
+              properties:
+                label:
+                  $ref: '#/components/schemas/LKECluster/properties/label'
+                region:
+                  $ref: '#/components/schemas/LKECluster/properties/region'
+                k8s_version:
+                  $ref: '#/components/schemas/LKECluster/properties/k8s_version'
+                tags:
+                  $ref: '#/components/schemas/LKECluster/properties/tags'
+                node_pools:
+                  type: array
+                  items:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody'
       responses:
         '200':
           description: Kubernetes cluster creation has started.
@@ -6268,8 +6274,20 @@ paths:
                   "k8s_version": "1.16",
                   "tags": ["ecomm", "blogs"],
                   "node_pools": [
-                    { "type": "g6-standard-4", "count": 6},
-                    { "type": "g6-standard-8", "count": 3}
+                    {
+                      "type": "g6-standard-4",
+                      "count": 6,
+                      "disks": [
+                        {
+                          "size": 1028,
+                          "type": "ext4"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "g6-standard-8",
+                      "count": 3
+                    }
                   ]
                 }' \
                 https://api.linode.com/v4/lke/clusters
@@ -6279,7 +6297,7 @@ paths:
             --label cluster12345 \
             --region us-central \
             --k8s_version 1.16 \
-            --node_pools.type g6-standard-4 --node_pools.count 6 \
+            --node_pools.type g6-standard-4 --node_pools.count 6 --node_pools.disks '[{"size": 1028, "type": "ext4"}]' \
             --node_pools.type g6-standard-8 --node_pools.count 3 \
             --tags ecomm
   /lke/clusters/{clusterId}:
@@ -6339,7 +6357,7 @@ paths:
             schema:
               properties:
                 label:
-                  $ref: '#/components/schemas/LKEClusterRequestBody/properties/label'
+                  $ref: '#/components/schemas/LKECluster/properties/label'
                 tags:
                     type: array
                     items:
@@ -6362,7 +6380,6 @@ paths:
                   label:
                     $ref: '#/components/schemas/LKECluster/properties/label'
                   tags:
-                    x-linode-filterable: true
                     type: array
                     items:
                       type: string
@@ -6533,7 +6550,18 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/LKENodePool'
+                type: object
+                properties:
+                  type:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/type'
+                  count:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/count'
+                  disks:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/disks'
+                  id:
+                    $ref: '#/components/schemas/LKENodePool/properties/id'
+                  nodes:
+                    $ref: '#/components/schemas/LKENodePool/properties/nodes'
         default:
           $ref: '#/components/responses/ErrorResponse'
       x-code-samples:
@@ -6543,14 +6571,21 @@ paths:
                 -H "Authorization: Bearer $TOKEN" \
                 -X POST -d '{
                   "type": "g6-standard-4",
-                  "count": 6
+                  "count": 6,
+                  "disks": [
+                        {
+                          "size": 1028,
+                          "type": "ext4"
+                        }
+                      ]
                 }' \
                 https://api.linode.com/v4/lke/clusters/12345/pools
       - lang: CLI
         source: >
           linode-cli lke pool-create 12345 \
             --type g6-standard-4 \
             --count 6 \
+            --disks '[{"size": 1028, "type": "ext4"}]'
   /lke/clusters/{clusterId}/pools/{poolId}:
     parameters:
     - name: clusterId
@@ -6584,7 +6619,18 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/LKENodePool'
+                type: object
+                properties:
+                  type:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/type'
+                  count:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/count'
+                  disks:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/disks'
+                  id:
+                    $ref: '#/components/schemas/LKENodePool/properties/id'
+                  nodes:
+                    $ref: '#/components/schemas/LKENodePool/properties/nodes'
       x-code-samples:
       - lang: Shell
         source: >
@@ -6621,7 +6667,18 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/LKENodePool'
+                type: object
+                properties:
+                  type:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/type'
+                  count:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/count'
+                  disks:
+                    $ref: '#/components/schemas/LKENodePoolRequestBody/properties/disks'
+                  id:
+                    $ref: '#/components/schemas/LKENodePool/properties/id'
+                  nodes:
+                    $ref: '#/components/schemas/LKENodePool/properties/nodes'
       x-code-samples:
       - lang: Shell
         source: >
@@ -14001,6 +14058,7 @@ components:
             The tag portion of a CAA record. It is invalid to set this on
             other record types.
           example: null
+          x-linode-filterable: true
         created:
           type: string
           format: date-time
@@ -14071,7 +14129,7 @@ components:
           - dns_record_update
           - dns_zone_create
           - dns_zone_delete
-          - dnz_zone_import
+          - dns_zone_import
           - dns_zone_update
           - host_reboot
           - image_delete
@@ -14159,6 +14217,7 @@ components:
             The action that caused this Event. New actions may be added in the future.
           example: ticket_create
           x-linode-cli-display: 3
+          x-linode-filterable: true
         created:
           type: string
           readOnly: true
@@ -15922,55 +15981,9 @@ components:
             The number of GPUs this Linode Type offers.
           example: 0
           x-linode-cli-display: 11
-    LKEClusterRequestBody:
-      type: object
-      description: A Kubernetes cluster.
-      properties:
-        label:
-          type: string
-          description: >
-            This Kubernetes cluster's unique label for display purposes only.
-
-            Labels have the following constraints:
-
-              * Must start with an alpha character
-              * Must only consist of alphanumeric characters and dashes (`-`)
-              * Must not contain two dashes in a row
-          minLength: 3
-          maxLength: 32
-          # Kubernetes does NOT allow underscores in resource names and we are
-          # passing this name to Kubernetes. Thus the following pattern:
-          pattern: '[a-zA-Z0-9-]{3, 32}'
-          example: lkecluster12345
-        region:
-          type: string
-          description: This Kubernetes cluster's location.
-          example: us-central
-        k8s_version:
-          type: string
-          description: >
-            The desired Kubernetes version for this Kubernetes cluster in the format of <major>.<minor>,
-            and the latest supported patch version will be deployed.
-          example: "1.16"
-        tags:
-          type: array
-          description: >
-            An array of tags applied to the Kubernetes cluster. Tags are for organizational purposes only.
-          items:
-            type: string
-          example:
-          - ecomm
-          - blogs
-      required:
-      - label
-      - region
-      - k8s_version
     LKECluster:
       type: object
-      # Note that LKECluster inherits all properties of
-      # LKEClusterRequestBody and then overrides some of the sub-properties
-      allOf:
-      - $ref: '#/components/schemas/LKEClusterRequestBody'
+      description: A Kubernetes cluster.
       properties:
         id:
           type: integer
@@ -15990,19 +16003,47 @@ components:
           description: When this Kubernetes cluster was updated.
           example: "2019-09-13T21:24:16Z"
           readOnly: true
-        # Note that these properties override some of the sub-properties from
-        # LKEClusterRequestBody but otherwise inherit all of the original
-        # sub-properties.
         label:
+          type: string
+          description: >
+            This Kubernetes cluster's unique label for display purposes only.
+
+            Labels have the following constraints:
+
+              * UTF-8 characters will be returned by the API using escape
+                sequences of their Unicode code points. For example, the
+                Japanese character *か* is 3 bytes in UTF-8 (`0xE382AB`). Its
+                Unicode code point is 2 bytes (`0x30AB`). APIv4 supports this
+                character and the API will return it as the escape sequence
+                using six 1 byte characters which represent 2 bytes of Unicode
+                code point (`"\u30ab"`).
+              * 4 byte UTF-8 characters are not supported.
+              * If the label is entirely composed of UTF-8 characters, the API
+                response will return the code points using up to 193 1 byte
+                characters.
+          minLength: 1
+          maxLength: 32
           x-linode-cli-display: 2
           example: lkecluster12345
         region:
-          readOnly: true
+          type: string
+          description: This Kubernetes cluster's location.
           x-linode-cli-display: 3
           example: us-central
         k8s_version:
+          type: string
+          description: >
+            The desired Kubernetes version for this Kubernetes cluster in the format of <major>.<minor>,
+            and the latest supported patch version will be deployed.
           example: "1.16"
         tags:
+          x-linode-filterable: true
+          type: array
+          description: >
+            An array of tags applied to the Kubernetes cluster.
+            Tags are for organizational purposes only.
+          items:
+            type: string
           example:
           - ecomm
           - blogs
@@ -16015,19 +16056,53 @@ components:
         type:
           type: string
           description: A Linode Type for all of the nodes in the Node Pool.
-          example: "g6-standard-4"
+          example: g6-standard-4
         count:
           type: integer
           description: The number of nodes in the Node Pool.
           minimum: 1
           maximum: 100
           example: 6
+        disks:
+          type: array
+          description: >
+            This Node Pool's custom disk layout. Each item in this array will create a new disk
+            partition for each node in this Node Pool.
+
+              * The custom disk layout is applied to each node in this Node Pool.
+              * The maximum number of custom disk partitions that can be configured is 7.
+              * Once the requested disk paritions are allocated, the remaining disk space is allocated to the node's boot disk.
+              * A Node Pool's custom disk layout is immutable over the lifetime of the Node Pool.
+
+            **Note**: If this field is omitted, the node will have a default disk layout consisting of a single partition.
+            A custom layout is only required for specific use cases.
+          items:
+            type: object
+            description: >
+              The values to assign to each partition in this Node Pool's custom disk layout.
+            properties:
+              size:
+                description: >
+                  The size of this custom disk partition in MB.
+
+                    * The size of this disk partition must not exceed the capacity of the node's plan type.
+                type: integer
+                example: 1024
+              type:
+                description: >
+                  This custom disk partition's filesystem type.
+                type: string
+                enum:
+                - raw
+                - ext4
+                example: ext-4
     LKENodePool:
       # Note that LKENodePool inherits all properties of
       # LKENodePoolRequestBody and then overrides some of the sub-properties
       type: object
       allOf:
       - $ref: '#/components/schemas/LKENodePoolRequestBody'
+      - type: object
       description: >
         The set of Node Pools which are members of the Kubernetes cluster.
         Node Pools consist of a Linode type, the number of Linodes to