Rubrique précédente: Syntaxe d'exemple du service Web des groupesRubrique suivante: Service Web de rôles

Administration à l'aide de services Web › Service Web de groupes › Syntaxe pour la gestion de groupes de sites

Syntaxe pour la gestion de groupes de sites

Pour obtenir la liste de tous les groupes inclus dans le groupe au niveau le plus élevé dans l'arborescence Groupes (par défaut, Tous les groupes), vous pouvez utiliser les paramètres groupPath ou groupItemId.

Envoyez l'appel suivant pour utiliser le paramètre groupPath afin d'identifier le groupe par défaut : 

http://adresse_IP_serveur_CA_Performance_Center:8181/pc/center/webservice/groups/
groupPath/All%20Groups

Remarque : Lorsque vous utilisez certains clients REST, la syntaxe All Groups est requise au lieu de la syntaxe All%20Groups. Mais en général, les espaces ne sont pas valides dans les URL.

Envoyez l'appel suivant pour obtenir l'identificateur (siteId) pour un groupe de sites : 

http://adresse_IP_serveur_CA_Performance_Center:8181/pc/center/webservice/
groups/groupItemId/siteId

Dans le contenu XML renvoyé, l'ID du site ressemble au résultat suivant :

<GroupTree siteId="118" inheritDefault="true" path="Austin, TX">

Vous pouvez obtenir la liste de tous les sous-groupes inclus dans un groupe que vous spécifiez de deux façons :

Envoyez l'appel suivant pour utiliser le paramètre groupPath afin d'identifier le groupe dont les sous-groupes sont répertoriés dans le contenu XML renvoyé : 

http://adresse_IP_serveur_CA_Performance_Center:8181/pc/center/webservice/
groups/groupPath/All%20Groups%5CInventory

Envoyez l'appel suivant pour utiliser le paramètre groupItemId afin d'identifier le groupe dont les sous-groupes sont répertoriés dans le contenu XML renvoyé :

Remarque : La valeur groupItemId du groupe Inventory (Inventaire) par défaut est 5.

http://adresse_IP_serveur_CA_Performance_Center:8181/pc/center/webservice/
groups/groupItemId/5

Le contenu XML qui est renvoyé inclut la syntaxe des règles de groupe appliquées à ce groupe. Par conséquent, nous vous recommandons de tester plusieurs règles que vous créez dans l'interface utilisateur et de réviser la syntaxe qui est générée.

Groupes de sites et règles

Les règles de groupe prennent en charge plusieurs comparaisons, en plus des expressions régulières. Par exemple, utilisez la syntaxe suivante dans le contenu XML pour publier une règle de groupe ajoutant des unités dont le nom commence par le mot Cisco :

<Match>
   <Compare readOnly="true" using="MEMBER_OF">
       <Property name="ItemID" type="device"/>
           <Value reference="/All Groups">1</Value>
   </Compare>
   <Compare readOnly="false" using="STARTS_WITH">
      <Property name="DisplayName" type="device"/>
           <Value>Cisco*</Value>
   </Compare>
</Match>

Pour la syntaxe du chemin de groupe, les caractères de barre oblique sont adaptés aux documents XML que vous publiez. Cet exemple s'applique à une structure de groupe All Groups\Texas\Austin :

<GroupTree inheritDefault="true" path="/All Groups/Texas/Austin">
    <Group desc="" inherit="true" location="" name="CA Officetype="custom group">
        <Group desc="" inherit="true" location="" name="Austin Lab" type="custom group"/>
    </Group>
    <Group desc="" inherit="true" location="" name="Austin Data Center" type="custom group"/>
</GroupTree>

Dans l'URL pour la demande de service Web, toutefois, utilisez une barre oblique inversée pour le chemin de groupe. Les barres obliques ne sont pas correctement interprétées par le navigateur.