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

# 일괄 내보내기 작업 실행
<a name="running-bulk-operations-export"></a>

 대량 내보내기는 AWS IoT SiteWise 워크스페이스에서 Amazon S3 버킷으로 메타데이터를 이동하는 작업입니다.

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

필터는 JSON 요청의 소스 섹션 내 `iotSiteWiseConfiguration` 섹션에 지정되어야 합니다.

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

**Example 필터가 있는 요청 본문**  

```
{
      "metadataTransferJobId": "your-transfer-job-id",
      "sources": [
       {
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
          "filters": [
           {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID"
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeAssets": true
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeOffspring": true
               }
             }
           ]
          }
        }
       ],
       "destination": {
          "type": "s3",
          "s3Configuration": {
            "location": "arn:aws:s3:::amzn-s3-demo-bucket"
          }
      }
}
```

## 메타데이터 내보내기(콘솔)
<a name="export-metadata-console"></a>

다음 절차에서는 콘솔 내보내기 작업을 설명합니다.

**에서 내보내기 작업 생성 AWS IoT SiteWise Console**

1.  [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.

1. 탐색 창에서 **일괄 작업 새로 만들기**를 선택합니다.

1. **새 내보내기**를 선택하여 내보내기 프로세스를 시작합니다.

1. **메타데이터 내보내기** 페이지에서 다음을 수행합니다.
   +  내보내기 작업의 이름을 입력합니다. Amazon S3 버킷의 내보낸 파일에 사용되는 이름입니다.
   + 내보낼 리소스를 선택하면 작업에 대한 필터가 설정됩니다.
     + 모든 자산 및 자산 모델을 내보냅니다. 자산 및 자산 모델에 필터를 사용합니다.
     + 자산을 내보냅니다. 자산을 필터링합니다.
       + 내보내기 필터에 사용할 자산을 선택합니다.
       + (선택 사항) 파생 자산 또는 관련 자산 모델을 추가합니다.
     + 자산 모델을 내보냅니다. 자산 모델을 필터링합니다.
       + 내보내기 필터에 사용할 자산 모델을 선택합니다.
       + (선택 사항) 파생 자산, 관련 자산 또는 둘 다를 추가합니다.
     + **다음**을 선택합니다.
   + Amazon S3 버킷으로 이동합니다.
     + Amazon S3 버킷 및 파일을 보려면 **Amazon S3 찾아보기**를 선택합니다.
     + 파일을 배치해야 하는 Amazon S3 버킷으로 이동합니다.
     + **다음**을 선택합니다.
   + 내보내기 작업을 검토하고 **내보내기**를 선택합니다.

1. 의 ** SiteWise 메타데이터에 대한 대량 작업** 페이지에는 새로 생성된 가져오기 작업이 **작업 진행**률 테이블에 AWS IoT SiteWise Console 표시됩니다.

메타데이터를 내보낼 때 필터를 사용하는 다양한 방법은 [메타데이터 예시 내보내기](bulk-operations-export-filter-examples.md) 섹션을 참조하세요.

## 메타데이터 내보내기(AWS CLI)
<a name="export-metadata-cli"></a>

다음 절차에서는 AWS CLI 내보내기 작업을 설명합니다.

**에서 Amazon S3 AWS IoT SiteWise 로 데이터 내보내기**

1. 요청 본문이 포함된 JSON 파일을 생성합니다. 요청 본문은 전송 작업의 소스와 대상을 지정합니다. 다음 예시는 요청 본문 예시를 보여 줍니다.

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

   Amazon S3 버킷을 메타데이터 전송 작업의 대상으로 지정해야 합니다.
**참고**  
이 예시에서는 모든 자산 모델과 자산을 내보냅니다. 특정 자산 모델 또는 자산으로 내보내기를 제한하려면 요청 본문에 필터를 포함할 수 있습니다. 내보내기 필터 적용에 대한 자세한 내용은 [메타데이터 예시 내보내기](bulk-operations-export-filter-examples.md) 섹션을 참조하세요.

1. 다음 단계에서 사용할 요청 본문 파일을 저장합니다. 이 예시에서 파일의 이름은 `createMetadataTransferJobExport.json`으로 지정됩니다.

1. 다음 AWS CLI 명령을 실행`CreateMetadataTransferJob`하여를 호출합니다.

   ```
   aws iottwinmaker create-metadata-transfer-job --region us-east-1 \ 
            --cli-input-json file://createMetadataTransferJobExport.json
   ```

   입력 JSON 파일을 고유한 전송 파일 이름이 포함된 `createMetadataTransferJobExport.json`으로 바꿉니다.