Actions34
- Account Actions
- Audit Actions
- Certificate Actions
- Key Manager Actions
- Login Messages Actions
- Role Actions
- SSH Actions
Role → Add Privilege
AI-generatedSummary
Adds a command-directory privilege to an existing ONTAP role by POSTing the path and access level to the role's privileges endpoint.
Inputs
- Cluster Host (required) — Hostname or IP address of the ONTAP cluster management LIF.
- Port — HTTPS port for the ONTAP REST API. Defaults to 443.
- Role (required) — Existing role to add the privilege to. The value must be in ownerUUID/roleName form, for example a cluster UUID followed by the role name, because the node splits the Role locator value on '/' when building the API URL.
- Command/Path (required) — Command directory path the privilege applies to, such as volume or volume snapshot.
- Access Level (required) — Access level to grant: all, none, or readonly. Defaults to all.
- Options — Optional request options. Fields is a comma-separated list of response fields to include, or * for all; it is sent as the fields query parameter.
Output shape
ONTAP API response for the created role privilege, optionally including the completed job object.
Each input item is processed independently and produces one output item. If the POST returns an async ONTAP job, the node polls the job until completion and returns the original response merged with the completed job data plus _jobCompleted: true. If no job is returned, the raw ONTAP API response is returned. On failure with Continue On Fail enabled, returns an item containing { error: error.message }; otherwise it throws a NodeApiError with a parsed ONTAP error message.