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

# 작업 진행 상황 추적
<a name="review-job-progress"></a>

## 작업 진행 상황 및 세부 정보 검토(콘솔)
<a name="review-job-progress-console"></a>

일괄 작업을 시작하려면 [메타데이터 가져오기(콘솔)](running-bulk-operations-import.md#import-metadata-console) 또는 [메타데이터 내보내기(콘솔)](running-bulk-operations-export.md#export-metadata-console) 섹션을 참조하세요.

**AWS IoT SiteWise 콘솔의 작업 진행 상황 개요:**

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

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

1.  AWS IoT SiteWise 콘솔의 **작업 진행**률 테이블에는 대량 작업 작업 목록이 표시됩니다.

1. **작업 유형** 열은 내보내기 또는 가져오기 작업인지 설명합니다. **가져온 날짜** 열에는 작업이 시작된 날짜가 표시됩니다.

1. **상태** 열에는 작업 상태가 표시됩니다. 작업을 선택하여 작업에 대한 세부 정보를 볼 수 있습니다.

1. 선택한 작업은 성공 시 **성공** 또는 작업 실패 시 실패 목록을 표시합니다. 오류 설명도 각 리소스 유형과 함께 표시됩니다.

**AWS IoT SiteWise 콘솔의 작업 세부 정보 개요:**

 AWS IoT SiteWise 콘솔의 **작업 진행**률 테이블에는 대량 작업 작업 목록이 표시됩니다.

1. 더 자세한 정보를 보려면 작업을 선택합니다.

1. **가져오기** 작업의 경우 `Data source ARN`은 가져오기 파일의 Amazon S3 위치를 나타냅니다.

1. **내보내기** 작업의 경우 `Data destination ARN`는 내보내기 후 파일의 Amazon S3 위치를 나타냅니다.

1. `Status` 및 `Status reason`은 현재 작업에 대한 추가 세부 정보를 제공합니다. 자세한 내용은 [작업 진행 상황 추적 및 오류 처리](jobs-progress-error-handling.md) 섹션을 참조하세요.

1. `Queued position`은 프로세스 대기열에서 작업의 위치를 나타냅니다. 작업은 한 번에 하나씩 처리됩니다. 대기열 위치 1은 작업이 다음으로 처리될 것임을 나타냅니다.

1.  작업 세부 정보 페이지에는 작업 진행 상황 개수도 표시됩니다.

   1. 작업 진행 상황 수 유형은 다음과 같습니다.

     1. `Total resources` - 전송 프로세스에 있는 총 자산 수를 나타냅니다.

     1. `Succeeded` - 프로세스 중에 성공적으로 전송된 자산 수를 나타냅니다.

     1. `Failed` - 프로세스 중에 실패한 자산 수를 나타냅니다.

     1. `Skipped` - 프로세스 중에 건너뛴 자산 수를 나타냅니다.

1. `PENDING` 또는 `VALIDATING`의 작업 상태는 모든 작업 진행 상황 수를 `–` 기호로 표시합니다. 이는 작업 진행 상황 수가 평가 중임을 나타냅니다.

1. `RUNNING`의 작업 상태는 처리를 위해 제출된 작업인 `Total resources` 수를 표시합니다. 세부 개수(`Succeeded`, `Failed` 및 `Skipped`)는 처리된 리소스에 적용됩니다. 작업 상태가 `COMPLETED` 또는 `ERROR`가 될 때까지 세부 개수의 합계는 `Total resources` 개수보다 작습니다.

1.  작업의 상태가 `COMPLETED` 또는 `ERROR`인 경우 `Total resources` 개수는 세부 개수(`Succeeded`, `Failed` 및 `Skipped`)의 합계와 같습니다.

1.  작업 상태가 `ERROR`인 경우 **작업 실패** 테이블에서 특정 오류 및 실패에 대한 세부 정보를 확인합니다. 자세한 내용은 [오류 세부 정보 검사(콘솔)](inspect-errors.md#inspect-errors-console) 섹션을 참조하세요.

## 작업 진행 상황 및 세부 정보 검토(AWS CLI)
<a name="review-job-progress-cli"></a>

일괄 작업을 시작한 후 다음 API 작업을 사용하여 상태를 확인하거나 업데이트할 수 있습니다.
+ 특정 작업에 대한 정보를 검색하려면 [GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html) API 작업을 사용합니다.

**`GetMetadataTransferJob` API를 사용하여 정보 검색:**

  1. 전송 작업 생성 및 실행 `GetMetadataTransferJob` API를 직접적으로 호출합니다.  
**Example AWS CLI 명령:**  

     ```
     aws iottwinmaker get-metadata-transfer-job \ 
             --metadata-transfer-job-id {{your_metadata_transfer_job_id}} \
             --region {{your_region}}
     ```

  1.  `GetMetadataTransferJob` API는 다음 파라미터가 있는 `MetadataTransferJobProgress` 객체를 반환합니다.
     + **succeededCount** - 프로세스에서 성공적으로 전송된 자산 수를 나타냅니다.
     + **failedCount** - 프로세스 중에 실패한 자산 수를 나타냅니다.
     + **skippedCount** - 프로세스 중에 건너뛴 자산 수를 나타냅니다.
     + **totalCount** - 전송 프로세스의 총 자산 수를 나타냅니다.

     이러한 파라미터는 작업 진행 상태를 나타냅니다. 상태가 `RUNNING`인 경우 아직 처리해야 할 리소스 수를 추적하는 데 도움이 됩니다.

     스키마 검증 오류가 발생하거나 **failedCount**가 1보다 크거나 같으면 작업 진행 상태가 `ERROR`로 바뀝니다. 작업에 대한 전체 오류 보고서는 Amazon S3 버킷에 배치됩니다. 자세한 내용은 [오류 검사 AWS IoT SiteWise](inspect-errors.md) 섹션을 참조하세요.
+ 현재 작업을 나열하려면 [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html) API 작업을 사용합니다.

  JSON 파일을 사용하여 반환된 작업을 현재 상태에 따라 필터링합니다. 다음 절차를 참조하세요.

  1. 사용할 필터를 지정하려면 AWS CLI 입력 JSON 파일을 생성합니다.는 다음을 사용합니다.

     ```
     {
         "sourceType": "s3",
         "destinationType": "iottwinmaker",
         "filters": [{
             "state": "COMPLETED"
         }]
     }
     ```

     유효한 `state` 값 목록은AWS IoT TwinMaker API 참조 가이드**의 [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)를 참조하세요.

  1.  다음 AWS CLI 예제 명령에서 JSON 파일을 인수로 사용합니다.

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ 작업을 취소하려면 [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html) API 작업을 사용합니다. 이 API는 이미 내보내거나 가져온 리소스에 영향을 주지 않고 특정 메타데이터 전송 작업을 취소합니다.

  ```
  aws iottwinmaker cancel-metadata-transfer-job \ 
          --region {{your_region}} \ 
          --metadata-transfer-job-id {{job-to-cancel-id}}
  ```