Nexfs Management API Documentation

Method Index

DetachUserRole

Detach a Role from a User Account using the Nexfs Management API


Action: DetachUserRole

Removes a Role from a User account


Permissions

A requesting session must have the iam/eUpdateUsers role enabled.


Request Parameters

A request must be made against the nexfs management console api with the DetachUserRole action.


The request must be signed with a valid AWS V4 style Signature using an active temporary session security token.


Action

DetachUserRole

UserId

The Users Id (The account id/name used for that user to authenticate against the API)

RoleName

The name of the Role to be detached from the UserId


Request Body

The request does not have a request body.

Response Syntax

HTTP1/1 200

<?xml version="1.0" encoding="UTF-8"?>

<RequestCompleted>

<Code>string</Code>

<DeatachUserRoleResponse>

<ResponseMetadata>

<RequestId>integer</RequestId>

</ResponseMetadata>

</DeatachUserRoleResponse>

<Resource>string</Resource>

</RequestCompleted>

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in XML format by the service:


RequestCompleted

Root Level tag for the successful Detach User Role response

Code

OK

DeatachUserRoleResponse

A section label with contains the detach user role response details

ResponseMetadata

A section label with makes the start of the response metadata


RequestId

A requestid number that identifies the request made against the management api

Resource

/nexfsconsoleapi

Errors

Also See Rest Error Responses


400 BadRequest The request was Malformed

A BadRequest will be returned if UserID or RoleName is missing from the request

401 Unauthorized The request cannot be authenticated


403 Forbidden Session does not have the rights to perform the requested action


409 NoSuchEntity No user exists with the request userid

409 NoSuchEntity No role exists with the request rolename


500 InternalServerError An Internal Error was encountered

Example Request


GET http://nexfs.example.com:9200/nexfsconsoleapi?Action=DetachUserRole&RoleName=Nexfs%20Default%20Administration%20Role&UserId=ExampleUser

Authorization: AWS4-HMAC-SHA256 Credential=ad3ef4a51dc742208b5b4fc9d80d9756/20220831/nexfs/nexfsconsoleapi/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=cc2f785d7056159fe702ce2a1a1d92470561fbe960bb2e6cd85d41cf48914d4c

host: nexfs.example.com

x-amz-date: 20220831T153945Z

Example Response

<?xml version="1.0" encoding="UTF-8"?>

<RequestCompleted>

<Code>Ok</Code>

<DeatachUserRoleResponse>

<ResponseMetadata>

<RequestId>116</RequestId>

</ResponseMetadata>

</DeatachUserRoleResponse>

<Resource>/nexfsconsoleapi</Resource>

</RequestCompleted>