篩選 AWS DataSync 資源 - AWS DataSync
用於篩選的參數依位置篩選依任務篩選

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

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

下列 AWS CLI 範例列出所有 Amazon S3 類型的位置，其位置 URI 以字串開頭，"s3://amzn-s3-demo-bucket"並在 2019-12-157：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}]

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

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

依任務篩選

ListTasks 支援下列篩選條件名稱。

  • LocationId – 在 Amazon Resource Name (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"
        }
    ]
}