Sumber daya penyaringan AWS DataSync

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

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 S3dan. 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 atauContains).

Tabel berikut menjelaskan operator yang tersedia.

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

Pemfilteran berdasarkan lokasi

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

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"
        }
    ]
}