DropUser
Deletes a RAM user or STS account from the Hologres account system. After deletion, the RAM user or STS account can no longer log on to the instance. To log on to the instance, call the CreateUser operation to add the user again.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
hologram:DropUser |
delete |
*Instance
|
None | None |
Request syntax
POST /api/v1/instances/{instanceId}/dropUser HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| instanceId |
string |
No |
The instance ID. |
hgprecn-cn-xxxxxxx |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
|
| userName |
string |
No |
The username. Only RAM users and STS accounts are supported. If the user is a RAM user, the name must be prefixed with "p4_", such as p4_234253434. If the user is an STS account, the name must be prefixed with "v4_", such as v4_3234134. |
p4_234253434 |
| superUser |
string |
No |
Specifies whether the user is a superuser. |
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
Id of the request |
EA8F0084-5831-5907-BB31-BD05D2617844 |
| Success |
string |
Indicates whether the operation is successful. Valid values:
|
true |
| ErrorCode |
string |
The error code. |
null |
| ErrorMessage |
string |
The error message. |
null |
| HttpStatusCode |
string |
The HTTP status code. |
200 |
| Data |
boolean |
Indicates whether the operation is successful. Valid values:
|
true |
Examples
Success response
JSON format
{
"RequestId": "EA8F0084-5831-5907-BB31-BD05D2617844",
"Success": "true",
"ErrorCode": "null",
"ErrorMessage": "null",
"HttpStatusCode": "200",
"Data": true
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 403 | NoPermission | RAM user permission is insufficient, please grant AliyunHologresReadOnlyAccess permission. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.