기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 작업 진행 상황 추적 및 오류 처리
일괄 프로세스 작업은 처리하는 데 시간이 걸립니다. 각 작업은 요청을 AWS IoT SiteWise 수신하는 순서대로 처리됩니다. 각 계정에 대해 한 번에 하나씩 처리됩니다. 작업이 완료되면 대기열의 다음가 자동으로 처리를 시작합니다.는 작업을 비동기적으로 AWS IoT SiteWise 해결하고 진행됨에 따라 각의 상태를 업데이트합니다. 각 작업에는 리소스 상태 및 오류 메시지(해당되는 경우)가 포함된 상태 필드가 있습니다.
상태는 다음 값 중 하나일 수 있습니다.
+ `VALIDATING` - 제출된 파일 형식 및 내용을 포함한 작업을 검증하는 중입니다.
+ `PENDING` - 작업이 대기열에 있습니다. AWS IoT SiteWise 콘솔에서 이 상태의 작업을 취소할 수 있지만 다른 모든 상태는 종료될 때까지 계속됩니다.
+ `RUNNING` - 작업을 처리하는 중입니다. 가져오기 파일에 정의된 대로 리소스를 생성 및 업데이트하거나 선택한 내보내기 작업 필터를 기반으로 리소스를 내보내는 중입니다. 취소하면 이 작업에서 가져온 리소스는 삭제되지 않습니다. 자세한 정보는 [작업 진행 상황 및 세부 정보 검토(콘솔)](review-job-progress.md#review-job-progress-console)을 참조하세요.
+ `CANCELLING` - 작업이 적극적으로 취소되고 있습니다.
+ `ERROR` - 하나 이상의 리소스를 처리하지 못했습니다. 자세한 내용은 세부 작업 보고서를 참조하세요. 자세한 정보는 [오류 세부 정보 검사(콘솔)](inspect-errors.md#inspect-errors-console)을 참조하세요.
+ `COMPLETED` – 오류 없이 작업이 완료되었습니다.
+ `CANCELLED` - 작업이 취소되고 대기열에 추가되지 않습니다. `RUNNING` 작업을 취소한 경우 취소 시이 작업에서 이미 가져온 리소스는 삭제되지 않습니다 AWS IoT SiteWise.
**Topics**
+ [작업 진행 상황 추적](review-job-progress.md)
+ [오류 검사 AWS IoT SiteWise](inspect-errors.md)
# 작업 진행 상황 추적
## 작업 진행 상황 및 세부 정보 검토(콘솔)
일괄 작업을 시작하려면 [메타데이터 가져오기(콘솔)](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)
일괄 작업을 시작한 후 다음 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
```
# 오류 검사 AWS IoT SiteWise
## 오류 세부 정보 검사(콘솔)
**AWS IoT SiteWise 콘솔의 오류 세부 정보:**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.
1. 대량 **작업 목록은의 작업 진행**률 테이블 AWS IoT SiteWise Console 을 참조하세요.
1. 작업을 선택하여 작업 세부 정보를 봅니다.
1. 작업의 상태가 `COMPLETED` 또는 `ERROR`인 경우 `Total resources` 개수는 세부 개수(`Succeeded`, `Failed` 및 `Skipped`)의 합계와 같습니다.
1. 작업 상태가 `ERROR`인 경우 **작업 실패** 테이블에서 특정 오류 및 실패에 대한 세부 정보를 확인합니다.
1. **작업 실패** 테이블에는 작업 보고서의 내용이 표시됩니다. `Resource type` 필드는 다음과 같은 오류 또는 실패의 위치를 나타냅니다.
+ 예를 들어 `Resource type` 필드의 `Bulk operations template`에서 발생한 유효성 검사 오류는 가져오기 템플릿과 메타데이터 스키마 파일 형식이 일치하지 않음을 나타냅니다. 자세한 정보는 [AWS IoT SiteWise 메타데이터 전송 작업 스키마](bulk-operations-schema.md)을 참조하세요.
+ `Resource type` 필드의 `Asset` 실패는 다른 자산과의 충돌로 인해 자산이 생성되지 않았음을 나타냅니다. AWS IoT SiteWise 리소스 [오류 및 충돌에 대한 자세한 내용은 일반](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/CommonErrors.html) 오류를 참조하세요.
## 오류 세부 정보 검사(AWS CLI)
전송 작업 중에 발생한 오류를 처리하고 진단하려면 `GetMetadataTransferJob` API 작업 사용에 대한 다음 절차를 참조하세요.
1. 전송 작업을 생성하고 실행한 후 [GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)을 호출합니다.
```
aws iottwinmaker get-metadata-transfer-job \
--metadata-transfer-job-id your_metadata_transfer_job_id \
--region us-east-1
```
1. 작업 상태가 `COMPLETED`로 전환되는 것을 확인하면 작업 결과 확인을 시작할 수 있습니다.
1. `GetMetadataTransferJob`을 호출하면 [https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html)라는 객체가 반환됩니다.
MetadataTransferJobProgress 객체는 다음 파라미터를 포함합니다.
+ **failedCount:** 전송 프로세스 중에 실패한 자산 수를 나타냅니다.
+ **skippedCount:** 전송 프로세스 중에 건너뛴 자산 수를 나타냅니다.
+ **succeededCount:** 전송 프로세스 중에 성공한 자산 수를 나타냅니다.
+ **totalCount:** 전송 프로세스와 관련된 총 자산 수를 나타냅니다.
1. 또한 API 직접 호출은 미리 서명된 URL이 포함된 `reportUrl` 요소를 반환합니다. 전송 작업에 추가 조사가 필요한 문제가 있는 경우 이 URL을 참조하세요.