サイトグループ管理用構文

管理 Web サービス › グループ Web サービス › サイトグループ管理用構文

サイトグループ管理用構文

グループツリーの最上位レベルのグループの下にあるすべてのグループのリスト（デフォルトでは［All Groups］）を取得するには、groupPath パラメータまたは groupItemId パラメータが使用できます。

groupPath パラメータを使ってデフォルトグループを識別し、次のコールを発行します。

http://CA Performance Center Server IP Address:8181/pc/center/webservice/groups/
groupPath/All%20Groups

注：いくつかの REST クライアントを使用する場合、「All%20Groups」ではなく、「All Groups」構文が必要です。しかし、一般的に、ブランクのスペースは URL 内で有効ではありません。

サイトグループの識別子（siteId）を取得するには、次のコールを発行します。

http://CA Performance Center Server IP Address:8181/pc/center/webservice/
groups/groupItemId/siteId

返される XML で、サイト ID は次のように表示されます。

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

指定したグループの下のすべてのサブグループのリストを取得するには、次の 2 つのオプションがあります。

groupPath パラメータを使用する。
groupItemId パラメータを使用する。

groupPath パラメータを使ってグループを特定し、次のコールを発行すると、返された XML にそのサブグループが一覧表示されます。

http://CA Performance Center Server IP address:8181/pc/center/webservice/
groups/groupPath/All%20Groups%5CInventory

groupItemId パラメータを使ってグループを特定し、次のコールを発行すると、返された XML にそのサブグループが一覧表示されます。

注：デフォルトの「Inventory」グループの groupItemId は 5 です。

http://CA Performance Center Server IP address:8181/pc/center/webservice/
groups/groupItemId/5

返される XML には、そのグループに適用されるあらゆるグループルールの構文が含まれます。そのため、ユーザインターフェースで作成するさまざまなルールをテストし、生成された構文を調べることをお勧めします。

サイトグループおよびルール

グループルールは正規表現に加えて、多重比較をサポートします。たとえば、次の XML の構文を使用すると、名前が単語「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>

グループパス構文については、スラッシュ文字は、ポストする XML ドキュメントに適切です。この例では、「/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>

ただし、Web サービスリクエスト用の URL で、円記号文字をグループパスに使用します。スラッシュは、ブラウザによって誤って解釈されます。

サイト グループ管理用構文

サイトグループ管理用構文