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

Método get (Objeto group)

Descripción

Muestra información sobre los grupos. La información mostrada incluye: nombre del grupo, ID, ámbito, descripción y miembros del grupo del elemento principal.

Sintaxis

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

Argumentos

grupo

Nombre del grupo

vdc

Nombre del centro de datos virtual de destino

Tipo de transacción

sincrónica

Tipo de solicitud

GET

Ejemplos

Cree un grupo local denominado mygroup.

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

Obtenga información de grupo para el grupo "mygroup".

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

Ejemplo de salida

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>

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.

400.4

Faltan argumentos obligatorios (app):
- Falta group=group.

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