API Reference

Nfs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Create a new NFS share

nfs.create(NfCreateParams**kwargs) -> NfCreateResponse

post/v2/nfs

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

ParametersExpand Collapse

name: str

The human-readable name of the share.

region: str

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

size_gib: int

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

vpc_ids: SequenceNotStr[str]

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

ReturnsExpand Collapse

class NfCreateResponse: …

share: Optional[Share]

id: str

The unique identifier of the NFS share.

created_at: datetime

Timestamp for when the NFS share was created.

formatdate-time

name: str

The human-readable name of the share.

region: str

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

size_gib: int

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

status: Literal["CREATING", "ACTIVE", "FAILED", "DELETED"]

The current status of the share.

Accepts one of the following:

"CREATING"

"ACTIVE"

"FAILED"

"DELETED"

host: Optional[str]

The host IP of the NFS server that will be accessible from the associated VPC

mount_path: Optional[str]

Path at which the share will be available, to be mounted at a target of the user's choice within the client

vpc_ids: Optional[List[str]]

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

Create a new NFS share

Python

HTTP

TypeScript

Python

from gradient import Gradient

client = Gradient(
    access_token="My Access Token",
)
nf = client.nfs.create(
    name="sammy-share-drive",
    region="atl1",
    size_gib=1024,
    vpc_ids=["796c6fe3-2a1d-4da2-9f3e-38239827dc91"],
)
print(nf.share)

200 example

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

Returns Examples

200 example

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