You can delete a specific share from within a cluster using its clusterId and shareId.
Prerequisite: Only contract administrators, owners, and users with accessAndManageNFS privilege can delete shares via the API.
Use the regional endpoints to delete a specific share:
https://nfs.de-txl.ionos.com/clusters/{clusterId}/shares/{shareId}.
https://nfs.de-fra.ionos.com/clusters/{clusterId}/shares/{shareId}
Note: The following request contains sample values. Remember to replace them with the relevant information.
To make authenticated requests to the API, the following fields are mandatory in the request header:
| Header Parameters | Required | Type | Description |
|---|---|---|---|
Below is the list of mandatory path parameters:
| Body Parameters | Type | Description | Example |
|---|---|---|---|
A 202 message confirms that the specified share has been successfully deleted.
Authorization
yes
string
You can use Basic Authentication or a Bearer token. For more information, see Authentication.
Content-Type
yes
string
Set this to application/json.
clusterId
string
The ID (UUID) of the cluster.
e69b22a5-8fee-56b1-b6fb-4a07e4205ead
shareId
string
The ID (UUID) of the share.
7b1ef56d-dfc6-51fe-aff0-7af2d6747868