Require vpc_id when creating an NFS access point.

Align the create request model and examples with cthulhu: every non-default
access point must be pinned to a VPC at creation time.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: sgupta832

specification/resources/nfs/models/access_point_request.yml

@@ -23,12 +23,12 @@ properties:
   vpc_id:
     type: string
     description: |
-      Optional VPC to mount this access point from. When unset (or set to a VPC the share
-      is already attached to), the access point inherits the share's VPC and storage gateway.
-      When set to a different VPC, a storage gateway is provisioned or reused in that VPC.
-    nullable: true
+      Required. The VPC this access point will be pinned to. A storage gateway is
+      provisioned (or reused) in this VPC, and the access point becomes mountable from
+      this VPC regardless of whether the parent share is currently attached to it.
     example: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
 required:
   - name
   - path
   - access_policy
+  - vpc_id

specification/resources/nfs/models/access_point_response.yml

@@ -53,10 +53,10 @@ properties:
   vpc_id:
     type: string
     description: |
-      The VPC this access point is pinned to. When unset, the access point inherits
-      the parent share's VPC(s). When set, the access point is mountable from this
-      specific VPC with its own storage gateway.
-    nullable: true
+      The VPC this access point is pinned to. Every non-default access point owns its
+      own storage gateway in this VPC and is independent of the parent share's VPC
+      lifecycle: it remains mountable from this VPC regardless of whether the share is
+      currently attached to it.
     example: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
 required:
   - id

specification/resources/nfs/nfs_access_point_create.yml

@@ -36,6 +36,7 @@ requestBody:
           value:
             name: "team-a"
             path: "/team-a"
+            vpc_id: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
             access_policy:
               anonuid: 65534
               anongid: 65534

specification/resources/nfs/responses/access_point_create.yml

@@ -22,6 +22,7 @@ content:
             name: "team-a"
             share_id: "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d"
             path: "/team-a"
+            vpc_id: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
             status: "ACCESS_POINT_CREATING"
             is_default: false
             created_at: "2023-01-01T00:00:00Z"

specification/resources/nfs/responses/access_point_delete.yml

@@ -23,6 +23,7 @@ content:
             name: "team-a"
             share_id: "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d"
             path: "/team-a"
+            vpc_id: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
             status: "ACCESS_POINT_DELETED"
             is_default: false
             created_at: "2023-01-01T00:00:00Z"

specification/resources/nfs/responses/access_point_get.yml

@@ -23,6 +23,7 @@ content:
             name: "team-a"
             share_id: "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d"
             path: "/team-a"
+            vpc_id: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
             status: "ACCESS_POINT_ACTIVE"
             is_default: false
             created_at: "2023-01-01T00:00:00Z"

specification/resources/nfs/responses/access_point_list.yml

@@ -23,6 +23,7 @@ content:
               name: "team-a"
               share_id: "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d"
               path: "/team-a"
+              vpc_id: "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
               status: "ACCESS_POINT_ACTIVE"
               is_default: false
               created_at: "2023-01-01T00:00:00Z"