Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Sumber daya penyaringan AWS DataSync
<a name="query-resources"></a>

Anda dapat memfilter AWS DataSync lokasi dan tugas Anda dengan menggunakan operasi `ListLocations` dan `ListTasks` API di AWS CLI. Misalnya, ambil daftar tugas terbaru Anda.

## Parameter untuk penyaringan
<a name="API-filter-parameters"></a>

Anda dapat menggunakan filter API untuk mempersempit daftar sumber daya yang dikembalikan oleh `ListTasks` dan `ListLocations`. Misalnya, untuk mengambil semua lokasi Amazon S3 Anda, Anda dapat `ListLocations` menggunakan dengan nama filter `LocationType` *`S3`*dan. `Operator` *`Equals`*

Untuk memfilter hasil API, Anda harus menentukan nama filter, operator, dan nilai.
+ `Name`— Nama filter yang sedang digunakan. Setiap panggilan API mendukung daftar filter yang tersedia untuk itu (misalnya, `LocationType` untuk `ListLocations`).
+ `Values`— Nilai yang ingin Anda filter. Misalnya, Anda mungkin ingin menampilkan lokasi Amazon S3.
+ `Operator`— Operator yang digunakan untuk membandingkan nilai filter (misalnya, `Equals` atau`Contains`). 

Tabel berikut menjelaskan operator yang tersedia.


| Operator | Tipe kunci | 
| --- | --- | 
| Equals | String, Jumlah | 
| NotEquals | String, Jumlah | 
| LessThan | Bilangan | 
| LessThanOrEqual | Bilangan | 
| GreaterThan | Bilangan | 
| GreaterThanOrEqual | Bilangan | 
| In | String | 
| Contains | String | 
| NotContains | String | 
| BeginsWith | String | 

## Pemfilteran berdasarkan lokasi
<a name="ListLocations"></a>

`ListLocations` mendukung nama filter berikut:
+ `LocationType`— Filter pada jenis lokasi:
  + `SMB`
  + `NFS`
  + `HDFS`
  + `OBJECT_STORAGE`
  + `S3`
  + `OUTPOST_S3`
  + `FSX_WINDOWS`
  + `FSX_LUSTRE`
  + `FSX_OPENZFS_NFS`
  + `FSX_ONTAP_NFS`
  + `FSX_ONTAP_SMB`
+ `LocationUri`— Filter pada pengenal sumber daya seragam (URI) yang ditetapkan ke lokasi, seperti yang ditampilkan oleh panggilan `DescribeLocation*` API (misalnya, `s3://bucket-name/your-prefix` untuk lokasi Amazon S3).
+ `CreationTime`— Filter pada saat lokasi dibuat. Format input adalah `yyyy-MM-dd:mm:ss` dalam Coordinated Universal Time (UTC).

 AWS CLI Contoh berikut mencantumkan semua lokasi jenis Amazon S3 yang memiliki URI lokasi dimulai dengan string `"s3://amzn-s3-demo-bucket"` dan yang dibuat pada atau setelah 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}]
```

Perintah ini mengembalikan output yang serupa dengan yang berikut ini.

```
{
    "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/"
        }
    ]
}
```

## Pemfilteran berdasarkan tugas
<a name="ListTasks"></a>

`ListTasks` mendukung nama filter berikut.
+ `LocationId`— Filter pada lokasi sumber dan tujuan pada nilai Amazon Resource Name (ARN).
+ `CreationTime`— Filter pada saat tugas dibuat. Format input adalah `yyyy-MM-dd:mm:ss` dalam UTC.

 AWS CLI Contoh berikut menunjukkan sintaks saat memfilter pada. `LocationId`

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

Output perintah ini terlihat serupa dengan yang berikut ini.

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