Apache CloudStack 4.20.0.0 Root Admin API Reference

listUsers

Lists user accounts

Request parameters

Parameter NameDescriptionRequired
accountlist resources by account. Must be used with the domainId parameter.false
accounttypeList users by account type. Valid types include admin, domain-admin, read-only-admin, or user.false
domainidlist only resources belonging to the domain specifiedfalse
idList user by ID.false
isrecursivedefaults to false, but if true, lists all resources from the parent specified by the domainId till leaves.false
keywordList by keywordfalse
listallIf set to false, list only resources belonging to the command's caller; if set to true - list resources that the caller is authorized to see. Default value is false. Resources dedicated to a project are listed only if using the projectid parameter.false
pagefalse
pagesizefalse
showiconflag to display the resource icon for usersfalse
stateList users by state of the user account.false
usernameList user by the usernamefalse

Response Tags

Response NameDescription
idthe user ID
accountthe account name of the user
accountidthe account ID of the user
accounttypethe account type of the user
apikeythe api key of the user
createdthe date and time the user account was created
domainthe domain name of the user
domainidthe domain ID of the user
emailthe user email address
firstnamethe user firstname
iconBase64 string representation of the resource icon
is2faenabledtrue if user has two factor authentication enabled
is2famandatedtrue if user has two factor authentication is mandated
iscallerchilddomainthe boolean value representing if the updating target is in caller's child domain
isdefaulttrue if user is default, false otherwise
lastnamethe user lastname
roleidthe ID of the role
rolenamethe name of the role
roletypethe type of the role
secretkeythe secret key of the user
statethe user state
timezonethe timezone user was created in
usernamethe user name
usersourcethe source type of the user in lowercase, such as native, ldap, saml2