AWS DataSync 리소스 필터링 - AWS DataSync
필터링을 위한 파라미터위치별 필터링작업 기준으로 필터링

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS DataSync 리소스 필터링

의 및 ListTasks API 작업을 사용하여 AWS DataSync 위치 ListLocations 및 작업을 필터링할 수 있습니다 AWS CLI. 예를 들어 가장 최근 작업 목록을 검색할 수 있습니다.

필터링을 위한 파라미터

API 필터를 사용하여 ListTasks및 ListLocations에서 반환되는 리소스 목록의 범위를 좁힐 수 있습니다. 예를 들어, 모든 Amazon S3 위치를 검색하려면 ListLocations을 필터 이름 LocationTypeS3과 OperatorEquals 함께 사용할 수 있습니다.

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 – DescribeLocation*API 직접 호출에서 반환된 대로 위치에 할당된 URI(Uniform Resource Identifier)에 대한 필터(예: Amazon S3 위치에 대한 s3://bucket-name/your-prefix).

  • CreationTime – 위치가 생성된 시간에 대한 필터. 입력 형식은 국제 표준시(UTC)의 yyyy-MM-dd:mm:ss입니다.

다음 AWS CLI 예제에서는 문자열로 시작하는 위치 URI가 "s3://amzn-s3-demo-bucket" 있고 2019-12-15 17:15:20 UTC 이후에 생성된 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 – 작업이 생성된 시간에 대한 필터. 입력 형식은 UTC의 yyyy-MM-dd:mm:ss입니다.

다음 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"
        }
    ]
}