[{"label":"Latest (v37.0)","version":"latest"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Get User

Description

Get a specified user by id.

Request

Request

URL

URL


get
https://{api_host}/cloudapi/1.0.0/users/{userUrn}
Copy

Path Parameters

Path Parameters

string
userUrn Required

userUrn


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns VcdUser of type(s) application/json;version=37.0
{
	"deployedVmQuota": 0,
	"description": "string",
	"email": "string",
	"enabled": false,
	"fullName": "string",
	"id": "string",
	"isGroupRole": false,
	"nameInSource": "string",
	"orgEntityRef": {
		"id": "string",
		"name": "string"
	},
	"password": "string",
	"providerType": "string",
	"roleEntityRefs": [
		{
			"id": "string",
			"name": "string"
		}
	],
	"storedVmQuota": 0,
	"username": "string"
}
string
username Required

Immutable user name of the user.


array of EntityReference
roleEntityRefs Required

The role(s) of the user. If isGroupRole is true, this user inherits their role(s) from group membership(s)


string
nameInSource Optional

Name of the user in its source.


boolean
enabled Optional

Enabled state of the user. Defaults to true.


string
fullName Optional

Full name (display name) of the user.


string
id Optional

Unique id for the user.


boolean
isGroupRole Optional

Determines if this user’s role is inherited from a group. Defaults to false.


string as email
email Optional

A user’s email address. Based on org email preferences, notifications can be sent to the user via email.


orgEntityRef Optional

Organization that the user belongs to.


string
password Optional

Password for the user. Must be null for external users.


string
providerType Optional

Provider type of the user. It is immutable and must be one of: LOCAL, LDAP, SAML, OAUTH.


string
description Optional

Description of the user.


integer as int32
storedVmQuota Optional

The stored VM quota for this user. Defaults to 0 which means unlimited. This property is deprecated in 35.0. Use user quotas API.


integer as int32
deployedVmQuota Optional

The deployed VM quota for this user. Defaults to 0 which means unlimited. This property is deprecated in 35.0. Use user quotas API.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl https://{api_host}/cloudapi/1.0.0/users/{userUrn}


[{"label":"Latest (v37.0)","version":"latest"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Availability
Added in 35.0
User Operations
Feedback

Was this page helpful?