Guías de integración › Guía de referencia de API de servicio Web › Objetos válidos › Objeto user › Método list (objeto user)

Método list (objeto user)

Descripción

Permite recuperar la lista de usuarios para un grid.

Sintaxis

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

Argumentos

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

Recuperación de la lista de usuarios

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

Ejemplo de salida

XML:

<users>
  <user>
    <loginenabled>1</loginenabled>
    <loginname>ak</loginname>
    <realname></realname>
    <scope>local</scope>
  </user>
  <user>
    <loginenabled>1</loginenabled>
    <loginname>api</loginname>
    <realname></realname>
    <scope>local</scope>
  </user>
</users>

JSON:

{
   "user" : [
   {
      "realname" : "",
      "loginenabled" : "1",
      "loginname" : "api",
      "scope" : "local"
   },
   {
      "realname" : "",
      "loginenabled" : "1",
      "loginname" : "ak",
      "scope" : "local"
   }
   ]
}

Códigos de error de HTTP

404

Entidad mygrid de vdc no encontrada: se ha especificado un nombre de VDC que no está configurado en la aplicación WS_API.