本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 篩選 AWS DataSync 資源
<a name="query-resources"></a>

您可以使用 中的 和 `ListTasks` API 操作來篩選 AWS DataSync 位置`ListLocations`和任務 AWS CLI。例如，擷取最新任務的清單。

## 用於篩選的參數
<a name="API-filter-parameters"></a>

您可以使用 API 篩選條件來縮小 `ListTasks`和 傳回的資源清單`ListLocations`。例如，若要擷取所有 Amazon S3 位置，您可以使用 `ListLocations`搭配篩選條件名稱 `LocationType`*`S3`*和 `Operator` *`Equals`*。

若要篩選 API 結果，您必須指定篩選名稱、運算子和值。
+ `Name` – 正在使用的篩選條件名稱。每個 API 呼叫都支援可用的篩選條件清單 （例如，`LocationType`適用於 `ListLocations`)。
+ `Values` – 您要篩選的值。例如，您可能只想顯示 Amazon S3 位置。
+ `Operator` – 用來比較篩選條件值的運算子 （例如 `Equals`或 `Contains`)。

下表列出可用的運算子。


| 運算子 | 金鑰類型 | 
| --- | --- | 
| Equals | 字串、數字 | 
| NotEquals | 字串、數字 | 
| LessThan | Number | 
| LessThanOrEqual | Number | 
| GreaterThan | Number | 
| GreaterThanOrEqual | Number | 
| In | String | 
| Contains | 字串 | 
| NotContains | 字串 | 
| BeginsWith | String | 

## 依位置篩選
<a name="ListLocations"></a>

`ListLocations` 支援下列篩選條件名稱：
+ `LocationType` – 依位置類型篩選：
  + `SMB`
  + `NFS`
  + `HDFS`
  + `OBJECT_STORAGE`
  + `S3`
  + `OUTPOST_S3`
  + `FSX_WINDOWS`
  + `FSX_LUSTRE`
  + `FSX_OPENZFS_NFS`
  + `FSX_ONTAP_NFS`
  + `FSX_ONTAP_SMB`
+ `LocationUri` – 依 `DescribeLocation*` API 呼叫傳回 （例如，`s3://bucket-name/your-prefix`Amazon S3 位置），篩選指派給位置的統一資源識別符 (URI)。
+ `CreationTime` – 篩選建立位置的時間。輸入格式`yyyy-MM-dd:mm:ss`為國際標準時間 (UTC)。

下列 AWS CLI 範例列出 Amazon S3 類型的所有位置，其位置 URI 以字串開頭，`"s3://amzn-s3-demo-bucket"`並在 2019-12-15 17：15：20 UTC 或之後建立。

```
aws datasync list-locations \
    --filters [{Name=LocationType, Values=["S3"], Operator=Equals}, {Name=LocationUri, Values=["s3://amzn-s3-demo-bucket"], Operator=BeginsWith}, {Name=CreationTime,Values=["2019-12-15 17:15:20"],Operator=GreaterThanOrEqual}]
```

此命令會傳回類似以下的輸出。

```
{
    "Locations": [
        {
            "LocationArn": "arn:aws:datasync:us-east-1:111122223333:location/loc-333333333abcdef0",
            "LocationUri": "s3://amzn-s3-demo-bucket1/"
        },
        {
            "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-987654321abcdef0",
            "LocationUri": "s3://amzn-s3-demo-bucket2/"
        }
    ]
}
```

## 依任務篩選
<a name="ListTasks"></a>

`ListTasks` 支援下列篩選條件名稱。
+ `LocationId` – 在 Amazon Resource Name (ARN) 值上同時篩選來源和目的地位置。
+ `CreationTime` – 篩選任務建立的時間。輸入格式為 `yyyy-MM-dd:mm:ss` UTC。

下列 AWS CLI 範例顯示在 上篩選時的語法`LocationId`。

```
aws datasync list-tasks \
    --filters Name=LocationId,Values=arn:aws:datasync:us-east-1:your-account-id:location/your-location-id,Operator=Contains
```

此命令的輸出看起來類似以下內容。

```
{
    "Tasks": [
        {
            "TaskArn": "arn:aws:datasync:us-east-1:your-account-id:task/your-task-id",
            "Status": "AVAILABLE",
            "Name": "amzn-s3-demo-bucket"
        }
    ]
}
```