資料驅動 REST Web 服務 › 篩選屬性

篩選屬性

您可以依據資料驅動 Web 服務的 XSD 結構描述中所列的屬性進行篩選，例如項目名稱、說明和其他這類屬性。 例如，依監控設定檔包含的度量系列篩選監控設定檔。 您可以使用此資訊來判斷要在監控設定檔中新增或移除度量系列。

遵循這些步驟：

1. 在 Web 瀏覽器輸入下列 URL：

   http://hostname:port/rest/
   

   有一份清單顯示可用的資料驅動 Web 服務。

2. 按一下 Web 服務。

   該 Web 服務的文件頁面隨即顯示。

3. 按一下「已篩選的取得清單」方法之下的 URL。

   XSD 結構描述隨即開啟。

4. 尋找 substitutionGroup="AttributeFilterTypeSubstitution" 的元素 (如下列範例所示)。 使用此資訊來決定篩選所要依據的屬性。

   

5. 開啟可傳送要求和取得回應的 REST 用戶端編輯器或 HTTP 工具，並將 Content-type 設為 application/xml。
6. 輸入下列篩選準則：
   • URL: http://hostname:port/rest/endpoint/filtered/
   • HTTP 方法 = POST

     此方法必須定義篩選準則。

   • [HTTP 要求] 窗格中 [內文] 索引標籤上的基本篩選選取準則：

     <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 回應] 窗格的 [內文] 索引標籤中。

範例：使用篩選和選取準則傳回包含度量系列的監控設定檔清單。

輸入下列 URL，以使用輪詢率作為選取準則來傳回包含度量系列的監控設定檔：

• 方法和 URL：

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

• 內容：

  <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 屬性 (選取準則) 的設定檔。