Add domain mapping
Adds a new domain mapping to a virtual server.
If the virtual server is configured in the global security context, the mapping will be added to the global context. Specify a virtual server ID of 0 to ensure the mapping is added to the global context. If the virtual server is configured to have an individual security context, the new mapping will only be associated with the specified virtual server.
HTTP request syntax (URI)
POST <base_URI>/v8/storage/virtual-servers/{virtualServerId}/mappings/domain
Parameters
| Name | Type | Required | Values | Description |
| virtualServerId | URI_PARAM | Y | string/number | Specifies either the virtual server object ID or the HNAS storage virtual server ID. |
| ntDomain | BODY | Y | string | NT domain name to map to/from |
| nfs4Domain | BODY | Y | string | NFSv4 domain name to map to/from |
| kerberosRealm | BODY | Y | string | Kerberos realm to map to/from |
| canMapUnixNames | BODY | Y | boolean | Can use this mapping entry to map to/from Unix names. |
Return codes
| Code | Data | Description |
| 201 | domainMapping | The domain mapping has been successfully added. |
| 400 | Error Message | Missing or invalid request contents. |
| 403 | Error Message | Operation forbidden by access level. |
| 404 | Error Message | Requested resource not found. |
| 500 | Error message | Error associated with the storage system. |
Any HTTP status code other than 201 indicates that the API did not complete successfully.
Request example: Create a new global group with valid Unix details and allowing others to be discovered automatically
curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/virtual-servers/1/mappings/domain -X POST -d '{"ntDomain":"example", "kerberosRealm":"EXAMPLE.COM", "nfs4Domain":"", "canMapUnixNames":false}'
Response example
HTTP/1.1 201 Created
{
"domainMapping": {
"canMapUnixNames": false,
"kerberosRealm": "EXAMPLE.COM",
"nfs4Domain": "",
"ntDomain": "example",
"objectId": "303a3a3a6e74446f6d61696e3a3a3a6578616d706c653a3a3a303a3a3a4f49445f24232140255f56"
},
"uri": "https://172.27.5.11:8444/v8/storage/mappings/303a3a3a6e74446f6d61696e3a3a3a6578616d706c653a3a3a303a3a3a4f49445f24232140255f56"
}