筛选Amazon DataSync资源 - Amazon DataSync
用于筛选的参数按位置筛选按任务筛选
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

筛选Amazon DataSync资源

您可以使用中的和ListTasks API 操作筛选您的Amazon DataSync 位置ListLocations和任务Amazon CLI。例如，检索您最近的任务列表。

用于筛选的参数

您可以使用 API 过滤器来缩小ListTasks和返回的资源列表的范围ListLocations。例如，要检索您的所有 Amazon S3 位置，您可以将筛选器名称LocationTypeS3和ListLocations一起使用OperatorEquals。

要筛选 API 结果，必须指定筛选器名称、运算符和值。

  • Name— 正在使用的过滤器的名称。每个 API 调用都支持可用于它的过滤器列表（LocationType例如，forListLocations）。

  • Values— 要筛选的值。例如，您可能希望仅显示 Amazon S3 位置。

  • Operator— 用于比较筛选器值的运算符（例如，Equals或Contains）。

下表列出了可用的运算符。

操作符 密钥类型
Equals 字符串，数字
NotEquals 字符串，数字
LessThan 数字
LessThanOrEqual 数字
GreaterThan 数字
GreaterThanOrEqual 数字
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) 进行筛选（例如，对于 Amazon S3 位置）。s3://bucket-name/your-prefix

  • CreationTime— 根据创建位置的时间进行筛选。输入格式采用yyyy-MM-dd:mm:ss协调世界时 (UTC)。

以下Amazon CLI示例列出了所有类型为 Amazon S3 的位置，这些位置 URI 以字符串开头"s3://DOC-EXAMPLE-BUCKET"，创建于 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}]

该命令会返回类似以下内容的输出。

{
    "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— 根据亚马逊资源名称 (ARN) 值对源位置和目标位置进行筛选。

  • CreationTime— 根据任务创建时间进行筛选。输入格式采用yyyy-MM-dd:mm:ss UTC 表示。

以下Amazon 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"
        }
    ]
}