Data-Driven REST Web サービス › フィルタ属性

フィルタ属性

データ駆動型 Web サービス用に XSD スキーマでリスト表示される属性（アイテム名、説明、他の類似属性など）をフィルタできます。 たとえば、監視プロファイルを、それらに含まれるメトリック ファミリでフィルタリングします。 この情報を使用して、メトリック ファミリを監視プロファイルに追加または削除するかどうかを決定できます。

以下の手順に従います。

1. Web ブラウザに以下の URL を入力します。

   http://hostname:port/rest/
   

   利用可能なデータ駆動型 Web サービスがリスト表示されます。

2. Web サービスをクリックします。

   その Web サービス用のドキュメント ページが表示されます。

3. 「フィルタリングされた GETList」メソッド下の URL をクリックします。

   XSD スキーマが表示されます。

4. 以下の例に示すように substitutionGroup="AttributeFilterTypeSubstitution" という条件を満たすエレメントを探します。 この情報を使用してどの属性をフィルタリングするかを決定します。

   

5. リクエストを送信しレスポンスを取得する REST クライアント エディタまたは HTTP ツールを開き、コンテンツ タイプを application/xml に設定します。
6. 以下のフィルタ条件を入力します。
   • URL: http://hostname:port/rest/endpoint/filtered/
   • HTTP method = POST

     このメソッドはフィルタ条件を定義する必要があります。

   • ［HTTP 要求］ペイン内の［Body］タブ上の基本的なフィルタ選択条件は以下のとおりです。

     <FilterSelect xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="filter.xsd">
            <Filter>
                        <elementName type="CONTAINS">filter-criteria</elementName>
            <Filter>
     </FilterSelect>
     

     filter-criteria

     属性の実際の値を指定します。

     elementName

     フィルタするエレメント名（属性）を指定します。

     注： またポーリング レートのみのように、選択条件も指定できます。 詳細については、以下の例を参照してください。

   結果は［HTTP レスポンス］ペインの［Body］タブに返されます。

例： フィルタおよび選択条件を使用してメトリック ファミリを含む監視プロファイルのリストを返します。

選択条件としてポーリング レートを使用して、メトリック ファミリが含まれる監視プロファイルを返すために以下の URL を入力します。

• メソッドと URL：

  POST http://hostname:port/rest/monitoringprofiles/filtered/
  

• Body:

  <FilterSelect xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="filter.xsd">
                  <Filter>
                         <MonitoringProfile.FacetTypes type="CONTAINS">{http://im.ca.com/normalizer}NormalizedPortInfo</MonitoringProfile.FacetTypes>
                  <Filter>
                  <Select use="exclude"  isa="exclude">
                     <MonitoringProfile use="exclude"> 
                         <PollRate use="include"/>
                     </MonitoringProfile>       
                  </Select>
  </FilterSelect>
  

以下は、この例に対応するスクリーンショットです。 レスポンスには、NormalizedPortInfo メトリック（フィルタ条件）が含まれる監視プロファイルが表示されます。また、これらのプロファイルには指定された PollRate 属性（選択条件）だけが含まれます。