Add group mapping
Add a new group 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/group
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. |
| unixName | BODY | N | string | Unix group name |
| unixId | BODY | N | integer | Unix group ID |
| noUnixMapping | BODY | N | boolean | If true, no automatic mapping will be attempted |
| ntName | BODY | N | string | NT group name |
| ntId | BODY | N | string | NT group SID |
| noNtMapping | BODY | N | boolean | If true, no automatic mapping will be attempted |
| nfs4Name | BODY | N | string | NFSv4 group name |
| noNfs4Mapping | BODY | N | boolean | If true, no automatic mapping will be attempted |
Return codes
| Code | Data | Description |
| 201 | groupMapping | The group 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/0/mappings/group -X POST -d '{"unixName":"newGroup1", "unixId":877}'
Response example
HTTP/1.1 201 Created
{
"groupMapping": {
"isNfs4NameFixed": false,
"isNfs4NameValid": true,
"isNtIdFixed": false,
"isNtIdValid": false,
"isNtNameFixed": false,
"isNtNameValid": true,
"isUnixIdFixed": true,
"isUnixIdValid": true,
"isUnixNameFixed": true,
"isUnixNameValid": true,
"nfs4Name": "newGroup1@localhost",
"ntId": "",
"ntName": "PROTOCOLS\\newGroup1",
"objectId": "303a3a3a313a3a3a62616236393833362d613638352d313164382d393030352d3963353534373037356537353a3a3a303a3a3a4f49445f24232140255f56",
"unixId": 877,
"unixName": "newGroup1"
},
"uri": "https://172.27.5.11:8444/v8/storage/mappings/303a3a3a313a3a3a62616236393833362d613638352d313164382d393030352d3963353534373037356537353a3a3a303a3a3a4f49445f24232140255f56"
}