翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 の場所を取得するには、`LocationType` *`S3`* および `Operator` *`Equals`* のフィルター名を持つ `ListLocations` を使用できます。

API の結果をフィルタリングするには、フィルタ名、演算子、および値を指定する必要があります。
+ `Name` — 使用されているフィルタの名前。各 API 呼び出しでは、使用可能なフィルターのリストがサポートされています (例えば、`ListLocations` の `LocationType`)。
+ `Values` — フィルターする値。たとえば、Amazon S3 のロケーションのみを表示することができます。
+ `Operator` — フィルター値の比較に使用される演算子 (例: `Equals` または `Contains`)。

次の表では使用できるキーの一覧を示します。


| オペレーター | キーのタイプ | 
| --- | --- | 
| Equals | 文字列、数値 | 
| NotEquals | 文字列、数値 | 
| LessThan | 数値 | 
| LessThanOrEqual | 数値 | 
| GreaterThan | 数値 | 
| GreaterThanOrEqual | 数値 | 
| 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` — 場所に割り当てられたユニフォームリソース識別子 (URI) を`DescribeLocation*` API 呼び出し (例えば、Amazon S3 の場所の場合は `s3://bucket-name/your-prefix`) により返されるとおりにフィルタリングします。
+ `CreationTime` — 場所が作成された時刻をフィルタリングします。入力形式は協定世界時 (UTC) 表記の `yyyy-MM-dd:mm:ss` です。

次の AWS CLI 例では、文字列で始まり、2019-12-15 17:15:20 UTC 以降に`"s3://amzn-s3-demo-bucket"`作成された場所 URI を持つ Amazon S3 タイプのすべての場所を一覧表示します。

```
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 リソースネーム (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"
        }
    ]
}
```