Skip to main content
REST API reference

Manage external-role-mapping entries

Map external identity provider roles to ONTAP roles using this API to manage access controls effectively. Use these endpoints to create and retrieve role mappings, ensuring seamless integration between external providers and ONTAP roles.

Overview

This API is used to map external identity provider roles to ONTAP roles. The POST request creates an external role to ONTAP role mapping. Various responses are shown in the examples below.

Examples

Creating an external role to ONTAP role mapping entry

The following output shows how to create an external role to ONTAP role mapping entry.

# The API
/api/security/external-role-mappings

# The call:
curl -X POST "https://<mgmt-ip>/api/security/external-role-mappings" -d '{ "external_role": "Administrator", "ontap_role": { "name": "admin" }, "provider": "adfs", "comment": "Admin role" }'

Retrieving all external role to ONTAP role mapping entries

The following output shows all external role to ONTAP role mapping entries.

# The API
/api/security/external-role-mappings

# The call:
curl -X GET "https://<mgmt-ip>/api/security/external-role-mappings"

# The response:
{
 "records": [
 {
   "external_role": "Administrator",
   "provider": "adfs"
 }
 ],
 "num_records": 1
}