Guías de integración › Guía de referencia de API de servicio Web › Objetos válidos para la API de CA AppLogic › Objeto group › Método list (Objeto group)

Método list (Objeto group)

Descripción

Enumera los grupos incluidos en la base de datos del servicio de directorio local del controlador del grid y los grupos incluidos en la base de datos del servicio de directorio global (si el grid está configurado para utilizar este servicio).

Sintaxis

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

Argumentos

vdc (opcional)

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

Enumere los grupos.

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

Enumerar los grupos locales.

GET
http://192.168.123.200/api/v1/group/list?local&vdc=mygrid

Enumere los grupos globales.

GET
http://192.168.123.200/api/v1/group/list?global&vdc=mygrid

Ejemplo de salida

JSON:

{
   "group[0]" : {
      "name" : "admin",
      "description" : "us",
      "scope" : "local"
   },
   "group[1]" : {
      "name" : "mygroup",
      "description" : "",
      "scope" : "local"
   }
}

XML:

<opt>
  <group[0]>
    <name>admin</name>
    <description>us</description>
    <scope>local</scope>
  </group[0]>
  <group[1]>
    <name>mygroup</name>
    <description></description>
    <scope>local</scope>
  </group[1]>
</opt>

Códigos de error de HTTP

400

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

Nota: Esta API está disponible con WS_API_r6-1.0.6-1 y versiones superiores.