篩選AWS DataSync資源

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

用於篩選的參數

您可以使用 API 篩選器來縮小ListTasks和傳回的資源清單ListLocations。例如，若要擷取所有 Amazon S3 位置，您可以使ListLocations用篩選器名稱LocationTypeS3和Operator Equals.

若要篩選 API 結果，您必須指定篩選器名稱、運算子和值。

• Name— 正在使用的篩選器名稱。每個 API 呼叫都支援可用的篩選器清單 (例如，LocationType針對ListLocations)。

• Values— 您要篩選的值。例如，您可能只想要顯示 Amazon S3 位置。

• Operator— 用來比較篩選值的運算子 (例如，Equals或Contains)。

下表會列出可用的運算符。

運算子	金鑰類型
Equals	字符串，數字
NotEquals	字符串，數字
LessThan	Number
LessThanOrEqual	Number
GreaterThan	Number
GreaterThanOrEqual	Number
In	字串
Contains	字串
NotContains	字串
BeginsWith	字串

依位置篩選

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 呼叫傳回的指派給位置的統一資源識別碼 (URI) 進行篩選 (例如，s3://bucket-name/your-prefix針對 Amazon S3 位置)。

• CreationTime— 篩選建立位置的時間。輸入格式為yyyy-MM-dd:mm:ss國際標準時間 (UTC)。

下列AWS CLI範例列出 Amazon S3 類型的所有位置，這些位置的位置 URI 以字串開頭，"s3://DOC-EXAMPLE-BUCKET"且在世界標準時間 2019-12-15 17:15 當日或之後建立的位置。

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

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

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

依任務篩選

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