add worker_subnet_uuid to kubernetes docs (#1175)

* add worker_subnet_uuid to kubernetes docs

* implement feedback

---------

Co-authored-by: Harsh Maru <38807407+harshmaru7@users.noreply.github.com>

Author: d-honeybadger

specification/resources/kubernetes/examples/curl/kubernetes_create_cluster.yml

@@ -3,6 +3,5 @@ source: |-
   curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-    -d '{"name": "prod-cluster-01","region": "nyc1","version": "1.14.1\
-    -do.4","tags": ["production","web-team"],"node_pools": [{"size": "s-1vcpu-2gb","count": 3,"name": "frontend-pool","tags": ["frontend"],"labels": {"service": "frontend", "priority": "high"}},{"size": "c-4","count": 2,"name": "backend-pool"}]}' \
+    -d '{"name": "prod-cluster-01","region": "nyc1","version": "1.14.1-do.4","vpc_uuid": "c33931f2-a26a-4e61-b85c-4e95a2ec431b","worker_subnet_uuid": "cbd79771-23eb-49be-b5ea-59cc56222622","tags": ["production","web-team"],"node_pools": [{"size": "s-1vcpu-2gb","count": 3,"name": "frontend-pool","tags": ["frontend"],"labels": {"service": "frontend", "priority": "high"}},{"size": "c-4","count": 2,"name": "backend-pool"}]}' \
     "https://api.digitalocean.com/v2/kubernetes/clusters"

specification/resources/kubernetes/models/cluster.yml

@@ -50,6 +50,18 @@ properties:
     description: A string specifying the UUID of the VPC to which the
       Kubernetes cluster is assigned.<br><br>Requires `vpc:read` scope.
 
+  worker_subnet_uuid:
+    type: string
+    format: uuid
+    example: cbd79771-23eb-49be-b5ea-59cc56222622
+    description: |
+      The UUID of the VPC subnet to attach worker nodes to. When omitted on
+      create, the default subnet for the VPC is used. This value cannot be changed
+      after the cluster is created.
+
+      `vpc_uuid` must also be set.
+      <br><br>Requires `vpc:read` scope.
+
   ipv4:
     type: string
     readOnly: true

specification/resources/kubernetes/models/cluster_read.yml

@@ -50,6 +50,14 @@ properties:
     description: A string specifying the UUID of the VPC to which the
       Kubernetes cluster is assigned.<br><br>Requires `vpc:read` scope.
 
+  worker_subnet_uuid:
+    type: string
+    format: uuid
+    example: cbd79771-23eb-49be-b5ea-59cc56222622
+    description: |
+      The UUID of the VPC subnet worker nodes are attached to. When unset, the
+      default subnet for the VPC is used.<br><br>Requires `vpc:read` scope.
+
   ipv4:
     type: string
     readOnly: true

specification/resources/kubernetes/responses/examples.yml

@@ -140,6 +140,7 @@ kubernetes_single:
       cluster_subnet: 10.244.0.0/16
       service_subnet: 10.245.0.0/16
       vpc_uuid: c33931f2-a26a-4e61-b85c-4e95a2ec431b
+      worker_subnet_uuid: cbd79771-23eb-49be-b5ea-59cc56222622
       ipv4: 68.183.121.157
       endpoint: https://bd5f5959-5e1e-4205-a714-a914373942af.k8s.ondigitalocean.com
       tags:
@@ -492,6 +493,7 @@ kubernetes_clusters_multi_pool_response:
       cluster_subnet: 10.244.0.0/16
       service_subnet: 10.245.0.0/16
       vpc_uuid: c33931f2-a26a-4e61-b85c-4e95a2ec431b
+      worker_subnet_uuid: cbd79771-23eb-49be-b5ea-59cc56222622
       ipv4: ''
       endpoint: ''
       tags: