CreateUser
Adds a RAM user or STS account to a Hologres instance as an instance account. After the account is added, you can log on to the instance by using the RAM or STS identity.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
hologram:CreateUser |
create |
*Instance
|
None | None |
Request syntax
POST /api/v1/instances/{instanceId}/createUser HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| instanceId |
string |
No |
The instance ID. |
hgpostcn-cn-zpr3426vm002 |
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 account is a RAM user, the name must be prefixed with p4_, such as p4_234253434. If the account is an STS account, the name must be prefixed with v4_, such as v4_3234134. |
p4_2346134 |
| superUser |
boolean |
No |
Specifies whether the user is a superuser. |
false |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
Id of the request |
D3AE84AB-0873-5FC7-A4C4-8CF869D2FA70 |
| 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": "D3AE84AB-0873-5FC7-A4C4-8CF869D2FA70",
"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.