数据驱动的 REST Web 服务 › 筛选属性

筛选属性

您可以筛选数据驱动的 Web 服务的 XSD 架构中所列的属性，如项名称、说明和其他此类属性。 例如，按所包含的度量标准系列筛选监视配置文件。 您可以使用该信息确定是将度量标准系列添加到监视配置文件还是从中删除。

请执行以下步骤：

1. 在 Web 浏览器中输入以下 URL：

   http://hostname:port/rest/
   

   此时将显示一个列表，其中显示数据驱动的可用 Web 服务。

2. 单击一个 Web 服务。

   将显示该 Web 服务的文档页面。

3. 单击“筛选后的 get 列表”方法下的 URL。

   将打开 XSD 架构。

4. 查找具有 substitutionGroup="AttributeFilterTypeSubstitution" 的元素，如下例所示。 使用此信息可确定要筛选的属性。

   

5. 打开 REST 客户端编辑器或 HTTP 工具（用于发送请求并获得响应），并将上下文类型设置为 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 属性（选择条件）。