Integration Guides › Web Service API Reference Guide › Valid Web API Objects › user Object › list Method (user Object)

list Method (user Object)

Description

Retrieve list of users for a grid

Syntax

/api/v1/user/list?vdc=controller-name 

Arguments

vdc

Name of the target virtual data center

Transaction Type

synchronous

Request Type

GET

Examples

Retrieve list of users.

GET http://192.168.123.200/api/v1/user/list?vdc=mygrid 

Sample Output

XML:

<user> 
   <id>test@CA.com</id> 
   <comment></comment> 
   <realname></realname> 
</user>

JSON:

{ 
   "user" : { 
      "realname" : "", 
      "comment" : "", 
      "id" : "test@CA.com" 
   } 
} 

HTTP Error Codes

404

Entity vdc mygrid not found - A VDC name was specified that is not configured in the WS_API application.