implement feedback

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

@@ -56,8 +56,11 @@ properties:
     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. Requires `vpc_uuid` to be
-      set.
+      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
@@ -196,3 +199,7 @@ required:
   - region
   - version
   - node_pools
+
+dependentRequired:
+  worker_subnet_uuid:
+    - vpc_uuid

specification/resources/kubernetes/models/cluster_read.yml

@@ -56,7 +56,7 @@ properties:
     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.
+      default subnet for the VPC is used.<br><br>Requires `vpc:read` scope.
 
   ipv4:
     type: string

specification/resources/kubernetes/responses/examples.yml

@@ -8,7 +8,6 @@ kubernetes_clusters_all:
       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:
@@ -271,7 +270,6 @@ kubernetes_updated:
       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:
@@ -401,7 +399,6 @@ kubernetes_clusters_create_basic_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: