v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_NFS

Create a new NFS share

To create a new NFS share, send a POST request to /v2/nfs.

post/v2/nfs

Request body

namestring required

The human-readable name of the share.

size_gibinteger required

The desired/provisioned size of the share in GiB (Gibibytes). Must be >= 50.

regionstring required

The DigitalOcean region slug (e.g., nyc2, atl1) where the NFS share resides.

vpc_idsstring[] required

List of VPC IDs that should be able to access the share.

Example request

{
  "name": "my-nfs-share",
  "size_gib": 50,
  "region": "atl1",
  "vpc_ids": [
    "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
  ]
}

Response

A JSON response containing details about the new NFS share.

Example response

{
  "share": {
    "id": "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "name": "sammy-share-drive",
    "size_gib": 1024,
    "region": "atl1",
    "status": "ACTIVE",
    "created_at": "2023-01-01T00:00:00Z",
    "vpc_ids": [
      "796c6fe3-2a1d-4da2-9f3e-38239827dc91"
    ]
  }
}