MNFS-163: Added NFS APIs (#1096)

* MNFS-163: Added NFS APIs

* Fixed lint issue

* Added curl examples

* Fixes from review

* Updated size_gib to be >=

* Formatting fixes, fix region and size_gib message

* Fixed formatting

* Fixed formatting again

* Fix share id naming in example

* Updated vpc_id as required, removed unwanted \n

* Added region as query param to list endpoint

* Removed user_id

* Added missing endpoint with query param to openapi spec

* Fixed vpc_id, query param

* Added region query param to get and delete endpoints

---------

Co-authored-by: SSharma-10 <shivanisharma@digitalocean.com>

Author: sreeram-venkitesh

specification/DigitalOcean-public.v2.yaml

@@ -363,6 +363,11 @@ tags:
       policies based on these metrics. The Monitoring API can help you gain insight into how your apps are performing
       and consuming resources.
 
+  - name: NFS
+    description: |-
+      NFS lets you create fully managed, POSIX-compliant network file storage that delivers secure, 
+      high-performance shared storage right inside your VPC. This enables seamless data sharing across Droplets in a VPC.
+
   - name: Partner Network Connect
     description: |-
       Partner Network Connect lets you establish high-bandwidth, low-latency
@@ -1614,6 +1619,20 @@ paths:
     delete:
       $ref: "resources/monitoring/monitoring_delete_sink.yml"
 
+  /v2/nfs:
+    post:
+      $ref: "resources/nfs/nfs_create.yml"
+
+    get:
+      $ref: "resources/nfs/nfs_list.yml"
+
+  /v2/nfs/{nfs_id}:
+    get:
+      $ref: "resources/nfs/nfs_get.yml"
+
+    delete:
+      $ref: "resources/nfs/nfs_delete.yml"
+
   /v2/partner_network_connect/attachments:
     get:
       $ref: "resources/partner_network_connect/partner_attachment_list.yml"

specification/resources/nfs/examples/curl/nfs_create.yml

@@ -0,0 +1,7 @@
+lang: cURL
+source: |-
+  curl -X POST \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    -d '{"name": "sammy-share-drive", "size_gib": 1024, "region": "atl1", "vpc_ids": ["796c6fe3-2a1d-4da2-9f3e-38239827dc91"]}' \
+    "https://api.digitalocean.com/v2/nfs"

specification/resources/nfs/examples/curl/nfs_delete.yml

@@ -0,0 +1,6 @@
+lang: cURL
+source: |-
+  curl -X DELETE \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    "https://api.digitalocean.com/v2/nfs/{share_id}?region=atl1"

specification/resources/nfs/examples/curl/nfs_get.yml

@@ -0,0 +1,6 @@
+lang: cURL
+source: |-
+  curl -X GET \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    "https://api.digitalocean.com/v2/nfs/{share_id}?region=atl1"

specification/resources/nfs/examples/curl/nfs_list.yml

@@ -0,0 +1,6 @@
+lang: cURL
+source: |-
+  curl -X GET \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    "https://api.digitalocean.com/v2/nfs?region=atl1"

specification/resources/nfs/models/nfs_create_response.yml

@@ -0,0 +1,5 @@
+type: object
+
+properties:
+  share:
+    $ref: 'nfs_response.yml'

specification/resources/nfs/models/nfs_get_response.yml

@@ -0,0 +1,5 @@
+type: object
+
+properties:
+  share:
+    $ref: 'nfs_response.yml'

specification/resources/nfs/models/nfs_list_response.yml

@@ -0,0 +1,7 @@
+type: object
+
+properties:
+  shares:
+    type: array
+    items:
+      $ref: 'nfs_response.yml'

specification/resources/nfs/models/nfs_request.yml

@@ -0,0 +1,26 @@
+---
+type: object
+properties:
+  name:
+    type: string
+    description: The human-readable name of the share.
+    example: "my-nfs-share"
+  size_gib:
+    type: integer
+    description: The desired/provisioned size of the share in GiB (Gibibytes). Must be >= 50.
+    example: 50
+  region:
+    type: string
+    description: The DigitalOcean region slug (e.g., nyc2, atl1) where the NFS share resides.
+    example: atl1
+  vpc_ids:
+    type: array
+    items:
+      type: string
+    description: List of VPC IDs that should be able to access the share.
+    example: ["796c6fe3-2a1d-4da2-9f3e-38239827dc91"]
+required:
+  - name
+  - size_gib
+  - region
+  - vpc_ids

specification/resources/nfs/models/nfs_response.yml

@@ -0,0 +1,45 @@
+---
+type: object
+properties:
+  id:
+    type: string
+    description: The unique identifier of the NFS share.
+    readOnly: true
+    example: "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d"
+  name:
+    type: string
+    description: The human-readable name of the share.
+    example: "sammy-share-drive"
+  size_gib:
+    type: integer
+    description: The desired/provisioned size of the share in GiB (Gibibytes). Must be >= 50.
+    example: 1024
+  region:
+    type: string
+    description: The DigitalOcean region slug (e.g., nyc2, atl1) where the NFS share resides.
+    example: "atl1"
+  status:
+    type: string
+    enum: [CREATING, ACTIVE, FAILED, DELETED]
+    description: The current status of the share.
+    readOnly: true
+    example: "ACTIVE"
+  created_at:
+    type: string
+    format: date-time
+    description: Timestamp for when the NFS share was created.
+    readOnly: true
+    example: "2023-01-01T00:00:00Z"
+  vpc_ids:
+    type: array
+    items:
+      type: string
+    description: List of VPC IDs that should be able to access the share.
+    example: ["796c6fe3-2a1d-4da2-9f3e-38239827dc91"]
+required:
+  - id
+  - name
+  - size_gib
+  - region
+  - status
+  - created_at