Delete Share

You can delete a specific share from within a cluster using its clusterId and shareId.

Endpoint

Use the regional endpoints to delete a specific share:

• Berlin, Germany: https://nfs.de-txl.ionos.com/clusters/{clusterId}/shares/{shareId}

• Frankfurt, Germany: https://nfs.de-fra.ionos.com/clusters/{clusterId}/shares/{shareId}

• Paris, France: https://nfs.fr-par.ionos.com/clusters/{clusterId}/shares/{shareId}

• London, Great Britain: https://nfs.gb-lhr.ionos.com/clusters/{clusterId}/shares/{shareId}

• Logroño, Spain: https://nfs.es-vit.ionos.com/clusters/{clusterId}/shares/{shareId}

• Las Vegas, United States: https://nfs.us-las.ionos.com/clusters/{clusterId}/shares/{shareId}

• Newark, United States: https://nfs.us-ewr.ionos.com/clusters/{clusterId}/shares/{shareId}

• Lenexa, United States: https://nfs.us-mci.ionos.com/clusters/{clusterId}/shares/{shareId}

The region 'Worcester, GB' will follow shortly.

Request

Note: The following request contains sample values. Remember to replace them with the relevant information.

curl -X 'DELETE' \
  'https://nfs.de-fra.ionos.com/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead/shares/7b1ef56d-dfc6-51fe-aff0-7af2d6747868' \
  -H 'accept: application/json'

Request Header Parameters

To make authenticated requests to the API, the following fields are mandatory in the request header:

Header Parameters	Required	Type	Description
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.

Path Parameters

Below is the list of mandatory path parameters:

Body Parameters	Type	Description	Example
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

Response

A 202 message confirms that the specified share has been successfully deleted.