AWS DataSync リソースのフィルタリング - AWS DataSync
フィルタリングのパラメータ場所によるフィルタリングタグによるフィルタリング

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS DataSync リソースのフィルタリング

の および ListTasks API オペレーションを使用して、 AWS DataSync の場所ListLocationsとタスクをフィルタリングできます AWS CLI。たとえば、最新のタスクリストの取得などです。

フィルタリングのパラメータ

API フィルターを使用して、ListTasks および ListLocations によって返されるリソースのリストを絞り込むことができます。例えば、すべての Amazon S3 の場所を取得するには、LocationType S3 および Operator Equals のフィルター名を持つ ListLocations を使用できます。

API の結果をフィルタリングするには、フィルタ名、演算子、および値を指定する必要があります。

  • Name — 使用されているフィルタの名前。各 API 呼び出しでは、使用可能なフィルターのリストがサポートされています (例えば、ListLocations の LocationType)。

  • Values — フィルターする値。たとえば、Amazon S3 のロケーションのみを表示することができます。

  • Operator — フィルター値の比較に使用される演算子 (例: Equals または Contains)。

次の表では使用できるキーの一覧を示します。

演算子 キーのタイプ
Equals 文字列、数値
NotEquals 文字列、数値
LessThan 数値
LessThanOrEqual 数値
GreaterThan 数値
GreaterThanOrEqual 数値
In String
Contains 文字列
NotContains 文字列
BeginsWith String

場所によるフィルタリング

ListLocations では、次のフィルター名をサポートしています。

  • LocationType — 以下のロケーションタイプでフィルタします。

    • SMB

    • NFS

    • HDFS

    • OBJECT_STORAGE

    • S3

    • OUTPOST_S3

    • FSX_WINDOWS

    • FSX_LUSTRE

    • FSX_OPENZFS_NFS

    • FSX_ONTAP_NFS

    • FSX_ONTAP_SMB

  • LocationUri — 場所に割り当てられたユニフォームリソース識別子 (URI) をDescribeLocation* API 呼び出し (例えば、Amazon S3 の場所の場合は s3://bucket-name/your-prefix) により返されるとおりにフィルタリングします。

  • CreationTime — 場所が作成された時刻をフィルタリングします。入力形式は協定世界時 (UTC) 表記の yyyy-MM-dd:mm:ss です。

次の の AWS CLI 例では、文字列で始まる場所 URI を持ち、2019-12-157:15:20 UTC"s3://amzn-s3-demo-bucket"」以降に作成された Amazon S3 タイプのすべての場所を一覧表示します。

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 リソースネーム (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"
        }
    ]
}