Initiate an NFS action

nfs.initiate_action(, ) -> NfInitiateActionResponse

post/v2/nfs/{nfs_id}/actions

To execute an action (such as resize) on a specified NFS share, send a POST request to /v2/nfs/{nfs_id}/actions. In the JSON body to the request, set the type attribute to on of the supported action types:

Action	Details
`resize`	Resizes an NFS share. Set the size_gib attribute to a desired value in GiB
`snapshot`	Takes a snapshot of an NFS share

ParametersExpand Collapse

nfs_id: str

region: str

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

type: Literal["resize", "snapshot"]

The type of action to initiate for the NFS share (such as resize or snapshot).

Accepts one of the following:

"resize"

"snapshot"

params: Optional[NfsActionResizeParams]

size_gib: int

The new size for the NFS share.

ReturnsExpand Collapse

class NfInitiateActionResponse: …

Action response of an NFS share.

action: Action

The action that was submitted.

region_slug: str

The DigitalOcean region slug where the resource is located.

resource_id: str

The unique identifier of the resource on which the action is being performed.

formatuuid

resource_type: Literal["network_file_share", "network_file_share_snapshot"]

The type of resource on which the action is being performed.

Accepts one of the following:

"network_file_share"

"network_file_share_snapshot"

started_at: datetime

The timestamp when the action was started.

formatdate-time

status: Literal["in-progress", "completed", "errored"]

The current status of the action.

Accepts one of the following:

"in-progress"

"completed"

"errored"

type: str

The type of action being performed.

Initiate an NFS action

from gradient import Gradient

client = Gradient(
    access_token="My Access Token",
)
response = client.nfs.initiate_action(
    nfs_id="0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    region="atl1",
    type="resize",
)
print(response.action)

{
  "action": {
    "region_slug": "atl1",
    "resource_id": "b5eb9e60-6750-4f3f-90b6-8296966eaf35",
    "resource_type": "network_file_share",
    "started_at": "2025-10-14T11:55:31.615157397Z",
    "status": "in-progress",
    "type": "resize"
  }
}

Returns Examples

{
  "action": {
    "region_slug": "atl1",
    "resource_id": "b5eb9e60-6750-4f3f-90b6-8296966eaf35",
    "resource_type": "network_file_share",
    "started_at": "2025-10-14T11:55:31.615157397Z",
    "status": "in-progress",
    "type": "resize"
  }
}