[{"label":"Latest (1.3.0)","version":"latest"}]
vrealize-suite-lifecycle-manager

Create User V2

Description

This API is used to add a user and assign roles to it. You can fetch different roles by triggering get all external roles.

Request

Request

URL

URL


post
https://localhost:8080/lcm/authzn/api/v2/users
Copy

Request Body

Request Body

UserRequestDTO of type(s) application/json Required

userRequestDTO

{
    "displayName": "configadmin configadmin",
    "domain": "System Domain",
    "password": "locker:password:<vmid>:<alias>",
    "providerIdentifier": "6304f1ed-17e0-4128-b86f-e29c6563e32f",
    "userPrincipalName": "configadmin_upn",
    "userType": "VIDM_LOCAL_USER",
    "username": "configadmin"
}
string
displayName Optional

Display name


string
domain Optional

Domain


boolean
isDisabled Optional

array of string
mappedRoles Optional

string
password Optional

Password


string
providerIdentifier Optional

Provider ID


userMetadata Optional

User Metadata


string
userPrincipalName Optional

User Principal Name


string
userType Optional

User type


string
username Optional

Username

Authentication

Authentication

This operation uses the following authentication methods.

Authorization

Scopes: global

Response

Response

200 OK Response Body>

Response Body

200 OK

Returns object of type(s) application/json

201 Created Response Body>

Response Body

201 Created

Returns UserDTO of type(s) application/json
{
    "displayName": "lcm user1",
    "domain": "example.com",
    "providerIdentifier": "3d6701ea-0c5b-43e7-871c-468947e86616",
    "userType": "VIDM_AD_USER",
    "username": "lcmuser1",
    "vmid": "3eef09c1-ae69-4f20-ba97-07f607227b13"
}
string
displayName Optional

Display Name


string
domain Optional

Domain


boolean
isDisabled Optional

string
password Optional

string
providerIdentifier Optional

Provider ID


array of RoleDTO
roleMappings Optional

userMetadata Optional

string
userPrincipalName Optional

User Principal Name


string
userType Optional

User Type


string
username Optional

Username


string
vmid Optional

User ID

Errors

Errors

401

Unauthorized


403

Forbidden


404

Not Found


GenericErrorResponseDTO
500

Internal Server Error

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"displayName":"configadmin configadmin","domain":"System Domain","password":"locker:password:<vmid>:<alias>","providerIdentifier":"6304f1ed-17e0-4128-b86f-e29c6563e32f","userPrincipalName":"configadmin_upn","userType":"VIDM_LOCAL_USER","username":"configadmin"}' https://localhost:8080/lcm/authzn/api/v2/users


Feedback

Was this page helpful?