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

# AWS DataSync 리소스 필터링
<a name="query-resources"></a>

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

## 필터링을 위한 파라미터
<a name="API-filter-parameters"></a>

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

API 결과를 필터링하려면 필터 이름, 연산자 및 값을 지정해야 합니다.
+ `Name` – 사용 중인 필터의 이름입니다. 각 API 직접 호출은 사용할 수 있는 필터 목록을 지원합니다(예: `ListLocations`에 대한 `LocationType`).
+ `Values` – 필터링 기준으로 사용할 값입니다. 예컨대, Amazon S3 위치만 표시할 수 있습니다.
+ `Operator` – 필터 값을 비교하는 데 사용되는 연산자입니다(예: `Equals`또는`Contains`).

다음 표에는 이용 가능한 연산자가 나열되어 있습니다.


| 연산자 | 키 유형 | 
| --- | --- | 
| Equals | 문자열, 숫자 | 
| NotEquals | 문자열, 숫자 | 
| LessThan | 숫자 | 
| LessThanOrEqual | 숫자 | 
| GreaterThan | 숫자 | 
| GreaterThanOrEqual | 숫자 | 
| In | 문자열 | 
| Contains | 문자열 | 
| NotContains | 문자열 | 
| BeginsWith | 문자열 | 

## 위치별 필터링
<a name="ListLocations"></a>

`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 예제에서는 문자열로 시작하고 2019-12-15 17:15:20 UTC 이후에 생성된 위치 URI가 `"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/"
        }
    ]
}
```

## 작업 기준으로 필터링
<a name="ListTasks"></a>

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