Manuels d'intégration › Manuel de référence de l'API de service Web › Objets valides › Objet group › Méthode info (objet group)

Méthode info (objet group)

Description

Affiche des informations concernant le groupe. Ces informations incluent : le nom du groupe, l'ID, la portée, la description et les membres principaux du groupe.

Syntaxe

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

Arguments

groupe

Nom du groupe

vdc

Nom du centre de données virtuel cible

Type de transaction

Synchrone

Type de requête

GET

Exemples

Récupérer les informations sur le groupe mygroup

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

Exemple de sortie

JSON

{
   "group" : {
      "members" : {
         "members[2]" : {
            "name" : "*",
            "id" : "f29c1426-10c1-4715-a763-b0bcc4b8b9d5",
            "type" : "user",
            "scope" : "local"
         },
         "members[0]" : {
            "name" : "apimig@3tera.com",
            "id" : "e1a5357f-204b-4cd3-9ca8-9e09f45b21c6",
            "type" : "user",
            "scope" : "local"
         },
         "members[1]" : {
            "name" : "api@3tera.com",
            "id" : "4f865f5b-e63a-410a-9d9a-96427c3ecfc7",
            "type" : "user",
            "scope" : "local"
         },
         "members[3]" : {
            "name" : "apoorva@3tera.com",
            "id" : "b543eff7-db88-4d79-a11c-4de22d5e6d3b",
            "type" : "user",
            "scope" : "local"
         }
      },
      "name" : "mygroup",
      "id" : "a5cb10bc-7291-4a86-84f8-74419fc9ae63",
      "description" : "us",
      "scope" : "local"
   }
}

XML

<group>
  <name>mygroup</name>
  <description>us</description>
  <id>a5cb10bc-7291-4a86-84f8-74419fc9ae63</id>
  <members>
    <name>apimig@3tera.com</name>
    <id>e1a5357f-204b-4cd3-9ca8-9e09f45b21c6</id>
    <scope>local</scope>
    <type>user</type>
  </members>
  <members>
    <name>api@3tera.com</name>
    <id>4f865f5b-e63a-410a-9d9a-96427c3ecfc7</id>
    <scope>local</scope>
    <type>user</type>
  </members>
  <members>
    <name>*</name>
    <id>f29c1426-10c1-4715-a763-b0bcc4b8b9d5</id>
    <scope>local</scope>
    <type>user</type>
  </members>
  <scope>local</scope>
</group>

Codes d'erreur HTTP

400

L'entité vdc mygrid est introuvable.
- Le nom de VDC spécifié n'est pas configuré dans l'application WS_API.

400.4

Missing required arguments (app).
- Argument group=group manquant

Remarque : Cette API est disponible avec WS_API_r6-1.0.6-1 et les versions ultérieures.