Change the User Access Permissions on a Shared Folder by User Name
Applies To: Windows Server 2012 Essentials
Modifies the access permissions of a user on a shared folder by specifying a user name.
URI Template
POST services/builtin/StorageManagement.svc/serverfolder/{id}/modify/permission/{permission}?username={username}&name={name}&description={description}
{id}
The identifier of the shared folder.
{permission}
The permission level. Use one of the following access permission values:
| Enumeration Value Name | Value | Meaning |
|---|---|---|
None |
0 | No access. |
ReadOnly |
1 | Read-only access. |
Full |
2 | Read/write access. |
Other |
3 | Unknown or unspecified access. |
{username}
The logon name of a user.
{name}
The name of the shared folder.
{description}
A description for the shared folder.
Sample Request
POST https://www.contoso.com/services/builtin/StorageManagement.svc/serverfolder/51760c8b-7024-4c8e-a78f-d7b05615273b/modify/permission/1?username=AuroraUser&name=Folder1&description=desc HTTP/1.1
Content-Type: application/xml
Accept: application/xml
Cookie: ASP.NET_SessionId=********************
Canary: *********************
Host: domainname
Content-Length: 0
Sample Response
HTTP/1.1 200 OK
Error Codes
| Error Code | Error Message |
|---|---|
| 400 | One or more parameters are not valid. |
| 401 | Access is denied to the requested resource. |
| 404 | The path does not exist. |