Get Users By Principal Name V2 Using GET
This API is used to get a user by principal name.
Request
URI
GET
https://{api_host}/lcm/authzn/api/v2/users/upn/{upn}
COPY
Path Parameters
string
upn
Required
upn
Responses
200
OK
Returns UserDTO of type(s) application/json
{
"displayName": "lcm user1",
"domain": "example.com",
"isDisabled": false,
"password": "string",
"providerIdentifier": "3d6701ea-0c5b-43e7-871c-468947e86616",
"roleMappings": [
{
"roleDescription": "vRealize Lifecycle Manager Administrator",
"roleName": "admin",
"vmid": "782c2945-3b69-4e29-8b32-b3d0d37ff562"
}
],
"userMetadata": {
"additionalMeta": [
"string"
],
"distinguishedName": "string",
"emails": [
"[email protected]"
],
"externalId": "764195c6-5504-4f56-8c34-b372d47f5176",
"familyName": "user1",
"givenName": "LCM"
},
"userPrincipalName": "string",
"userType": "VIDM_AD_USER",
"username": "lcmuser1",
"vmid": "3eef09c1-ae69-4f20-ba97-07f607227b13"
}
string
displayName
Optional
Display Name
string
domain
Optional
Domain
boolean
isDisabled
Optional
isDisabled
string
password
Optional
password
string
providerIdentifier
Optional
Provider ID
string
userPrincipalName
Optional
User Principal Name
string
userType
Optional
User Type
string
username
Optional
Username
string
vmid
Optional
User ID
401
Unauthorized
Operation doesn't return any data structure
403
Forbidden
Operation doesn't return any data structure
404
Not Found
Returns GenericErrorResponseDTO of type(s) application/json
{
"errorCode": "LCM_EXAMPLE_API_ERROR0000",
"errorLabel": "Example Error!",
"message": "Something went wrong!",
"recommendations": []
}
string
errorCode
Optional
errorCode
string
errorLabel
Optional
errorLabel
string
message
Optional
message
array of string
recommendations
Optional
recommendations
500
Internal Server Error
Returns GenericErrorResponseDTO of type(s) application/json
{
"errorCode": "LCM_EXAMPLE_API_ERROR0000",
"errorLabel": "Example Error!",
"message": "Something went wrong!",
"recommendations": []
}
string
errorCode
Optional
errorCode
string
errorLabel
Optional
errorLabel
string
message
Optional
message
array of string
recommendations
Optional
recommendations
Authentication User Controller Operations
POST
Create User V2 Using POST
DELETE
Delete User By Id V2 Using DELETE
GET
Get All Provider Mapped Users V2 Using GET
GET
Get User By Provider Identifier V2 Using GET
GET
Get Users By Principal Name And Domain V2 Using GET
GET
Get Users By Principal Name V2 Using GET
GET
Get Users By User Name And Domain V2 Using GET
POST
Search Vidm User Grp V2 Using POST
PUT
Update Local User Password V2 Using PUT
PATCH
Update User By Id V2 Using PATCH
PUT
Update User By Id V2 Using PUT