Share → Update
AI-generatedSummary
Updates an existing NFS share on an IONOS Cloud cluster.
Inputs
- location — The IONOS Cloud location used to construct the API endpoint.
- clusterId (required) — The ID (UUID) of the Cluster containing the share.
- shareId (required) — The ID (UUID) of the Share to update.
- name (required) — The name of the NFS share.
- quota — The quota for the share in MiB (0 = unlimited).
- uid — The user ID that will own the exported directory.
- gid — The group ID that will own the exported directory.
- clientGroups (required) — Virtual machines connecting to the NFS cluster. Each entry supports description, IP networks (CIDR), hosts (IPv4/IPv6), and NFS squash mode.
Output shape
The PUT request returns the updated share object from the IONOS Cloud API. If the node continues on fail, an error object is returned instead of throwing.
HTTP method: PUT. Endpoint: /clusters/{clusterId}/shares/{shareId}. Body includes id, properties with name, quota, uid, gid, and formatted clientGroups.
Examples
Example 1: Update share name and quota.
Set name and quota; leave uid/gid at defaults; optionally adjust clientGroups.