Sumber daya penyaringan AWS DataSync

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

Parameter untuk penyaringan

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

Untuk memfilter API hasil, Anda harus menentukan nama filter, operator, dan nilai.

• Name— Nama filter yang sedang digunakan. Setiap API panggilan mendukung daftar filter yang tersedia untuknya (misalnya, LocationType untukListLocations).

• 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 dikembalikan oleh DescribeLocation* API panggilan (misalnya, s3://bucket-name/your-prefix untuk lokasi Amazon S3).

• CreationTime— Filter pada saat lokasi dibuat. Format input yyyy-MM-dd:mm:ss dalam Coordinated Universal Time (UTC).

AWS CLI Contoh berikut mencantumkan semua lokasi tipe Amazon S3 yang memiliki lokasi URI dimulai dengan string "s3://DOC-EXAMPLE-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://DOC-EXAMPLE-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://DOC-EXAMPLE-BUCKET-examples/"
        },
        {
            "LocationArn": "arn:aws:datasync:us-east-1:123456789012:location/loc-987654321abcdef0",
            "LocationUri": "s3://DOC-EXAMPLE-BUCKET-examples-2/"
        }
    ]
}

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 ada yyyy-MM-dd:mm:ss diUTC.

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": "DOC-EXAMPLE-BUCKET"
        }
    ]
}