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

# 메타데이터 예시 내보내기
<a name="bulk-operations-export-filter-examples"></a>

Amazon S3로 AWS IoT SiteWise 콘텐츠를 대량으로 내보낼 때 *필터를* 지정하여 내보내려는 특정 자산 모델 및 자산을 제한할 수 있습니다.

요청 본문의 `sources` 섹션에 있는 `iotSiteWiseConfiguration` 섹션에 필터를 지정합니다.

**참고**  
필터는 여러 개 설정할 수 있습니다. 일괄 작업은 그 어느 필터와든 일치하는 모든 자산 모델 또는 자산을 내보냅니다.  
필터를 제공하지 않으면 작업이 모든 자산 모델과 자산을 내보냅니다.

```
{
    "metadataTransferJobId": "{{your-transfer-job-id}}",
    "sources": [{
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
            "filters": [{
                {{list of filters}}
            }]
        }
    }],
    "destination": {
        "type": "s3",
        "s3Configuration": {
            "location": "arn:aws:s3:::{{amzn-s3-demo-bucket}}"
        }
    }
}
```



## 자산 모델별 필터링
<a name="bulk-export-filter-asset-model"></a>

특정 자산 모델을 필터링할 수 있습니다. 해당 모델을 사용하는 모든 자산 또는 계층 구조 내의 모든 자산 모델을 포함할 수도 있습니다. 자산과 계층 구조를 모두 포함할 수는 없습니다.

계층 구조에 대한 자세한 정보는 [자산 모델 계층 정의](define-asset-hierarchies.md) 단원을 참조하세요.

------
#### [ Asset model ]

이 필터에는 다음의 지정된 자산 모델이 포함됩니다.

```
"filterByAssetModel": {
    "assetModelId": "{{asset model ID}}"
}
```

------
#### [ Asset model and its assets ]

이 필터에는 지정된 자산 모델과 해당 자산 모델을 사용하는 모든 자산이 포함됩니다.

```
"filterByAssetModel": {
    "assetModelId": "{{asset model ID}}",
    "includeAssets": true
}
```

------
#### [ Asset model and its hierarchy ]

이 필터에는 해당 계층 구조에 있는 모든 관련 자산 모델과 함께 지정된 자산 모델이 포함됩니다.

```
"filterByAssetModel": {
    "assetModelId": "{{asset model ID}}",
    "includeOffspring": true
}
```

------

## 자산별 필터링
<a name="bulk-export-filter-asset"></a>

특정 자산을 필터링할 수 있습니다. 자산 모델 또는 해당 계층 구조 내에 연결된 모든 자산을 포함할 수도 있습니다. 자산 모델과 계층 구조를 모두 포함할 수는 없습니다.

계층 구조에 대한 자세한 정보는 [자산 모델 계층 정의](define-asset-hierarchies.md) 단원을 참조하세요.

------
#### [ Asset ]

이 필터에는 다음의 지정된 자산이 포함됩니다.

```
"filterByAsset": {
    "assetId": "{{asset ID}}"
}
```

------
#### [ Asset and its asset model ]

이 필터에는 다음의 지정된 자산과 함께 해당 자산이 사용하는 자산 모델이 포함됩니다.

```
"filterByAsset": {
    "assetId": "{{asset ID}}",
    "includeAssetModel": true
}
```

------
#### [ Asset and its hierarchy ]

이 필터에는 해당 계층 구조에 있는 모든 관련 자산과 함께 지정된 자산이 포함됩니다.

```
"filterByAsset": {
    "assetId": "{{asset ID}}",
    "includeOffspring": true
}
```

------