Create User

Create User

Create a new user.

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/users
COPY
Request Body
VcdUser of type(s) application/json
Optional
{
    "username": "string",
    "fullName": "string",
    "description": "string",
    "id": "string",
    "roleEntityRefs": [
        {
            "name": "string",
            "id": "string"
        }
    ],
    "orgEntityRef": {
        "name": "string",
        "id": "string"
    },
    "password": "string",
    "deployedVmQuota": 0,
    "storedVmQuota": 0,
    "email": "string",
    "nameInSource": "string",
    "enabled": false,
    "isGroupRole": false,
    "providerType": "string"
}
string
username
Required

User name of the user.

string
fullName
Optional

Full name (display name) of the user.

string
description
Optional

Description of the user.

string
id
Optional

Unique id for the user.

roleEntityRefs
Required

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

orgEntityRef
Optional

orgEntityRef

string
password
Optional

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

integer As int32 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.

integer As int32 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.

string As email As email
email
Optional

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

string
nameInSource
Optional

Name of the user in its source.

boolean
enabled
Optional

Enabled state of the user. Defaults to true.

boolean
isGroupRole
Optional

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

string
providerType
Optional

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

Authentication
This operation uses the following authentication methods.
Responses
201

Created

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

User name of the user.

string
fullName
Optional

Full name (display name) of the user.

string
description
Optional

Description of the user.

string
id
Optional

Unique id for the user.

roleEntityRefs
Required

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

orgEntityRef
Optional

orgEntityRef

string
password
Optional

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

integer As int32 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.

integer As int32 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.

string As email As email
email
Optional

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

string
nameInSource
Optional

Name of the user in its source.

boolean
enabled
Optional

Enabled state of the user. Defaults to true.

boolean
isGroupRole
Optional

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

string
providerType
Optional

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