Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi › Oggetto group › Metodo list (oggetto group)

Metodo list (oggetto group)

Description

Elenca gruppi nel database di servizio della directory locale del controller della griglia e nel database di servizio della directory globale (se la griglia è configurata per l'utilizzo come servizio).

Sintassi

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

Argomenti

vdc (facoltativo)

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Elenco di gruppi

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

Ottenere un elenco dei gruppi locali

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

Elenco gruppi globali

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

Output di esempio

JSON:

{
   "group" : [
      {
         "can_own" : "0",
         "name" : "local:admin",
         "description" : "",
         "scope" : "local"
      },
      {
         "can_own" : "0",
         "name" : "local:all",
         "description" : "implicitly contains all users as members",
         "scope" : "local"
      }
   ]
}

XML:

<groups>
  <group>
    <can_own>0</can_own>
    <description></description>
    <name>local:admin</name>
    <scope>local</scope>
  </group>
  <group>
    <can_own>0</can_own>
    <description>implicitly contains all users as members</description>
    <name>local:all</name>
    <scope>local</scope>
  </group>
</groups>

Codici di errore HTTP

400

Entità vdc mygrid non trovata
- È stato specificato un nome di VDC non configurato nell'applicazione WS_API.

Nota: questa API è disponibile con WS_API_r6-1.0.6-1 e versioni successive.