本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# TaskFilter
<a name="API_TaskFilter"></a>

您可以使用 API 筛选器来缩小 `ListTasks` 返回的资源的列表范围。例如，要检索源位置上的所有任务，您可以结合该位置的 ARN 使用筛选器名称为 `LocationId` 和 `Operator Equals` 的 `ListTasks`。

有关更多信息，请参阅[筛选 DataSync 资源](https://docs.aws.amazon.com/datasync/latest/userguide/query-resources.html)。

## 内容
<a name="API_TaskFilter_Contents"></a>

 ** Name **   <a name="DataSync-Type-TaskFilter-Name"></a>
正在使用的筛选器名称。每个 API 调用都支持其可用的筛选器列表。例如，`ListTasks` 的 `LocationId`。  
类型：字符串  
有效值：`LocationId | CreationTime`  
必需：是

 ** Operator **   <a name="DataSync-Type-TaskFilter-Operator"></a>
用于比较筛选值的运算符（例如，`Equals` 或 `Contains`）。  
类型：字符串  
有效值：`Equals | NotEquals | In | LessThanOrEqual | LessThan | GreaterThanOrEqual | GreaterThan | Contains | NotContains | BeginsWith`  
必需：是

 ** Values **   <a name="DataSync-Type-TaskFilter-Values"></a>
要筛选的值。例如，您可能只想显示在特定目标位置的任务。  
类型：字符串数组  
长度约束：最小长度为 1。最大长度为 255。  
模式：`^[0-9a-zA-Z_\ \-\:\*\.\\/\?-]*$`  
必需：是

## 另请参阅
<a name="API_TaskFilter_SeeAlso"></a>

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/TaskFilter) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/TaskFilter) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/TaskFilter)