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

Metodo get (oggetto group)

Description

Mostra informazioni sul gruppo. Le informazioni visualizzate comprendono: nome del gruppo, ID, ambito, descrizione e membri del gruppo principale.

Sintassi

/api/v2/group/get?group=group&vdc=controller-name 

Argomenti

group

Nome del gruppo

vdc

Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Creazione di un gruppo locale denominato mygroup

GET
http://192.168.123.200/api/v2/group/create?group=mygroup&vdc=mygrid

Ottenere informazioni sul gruppo per il gruppo mygroup

GET
http://192.168.123.200/api/v2/group/get?group=mygroup&vdc=mygrid

Output di esempio

JSON:

{
   "group" : {
      "can_own" : "0",
      "name" : "mygroup",
      "id" : "1c534f9d-e26d-41e8-922f-4649743b9e98",
      "description" : "",
      "scope" : "local"
   }
}

XML:

<group>
  <can_own>0</can_own>
  <description></description>
  <id>1c534f9d-e26d-41e8-922f-4649743b9e98</id>
  <name>mygroup</name>
  <scope>local</scope>
</group>

Codici di errore HTTP

400

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

400.4

Argomenti necessari mancanti (app).
- Argomento gruppo=group mancante.

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