기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# StartJob
`StartJob` 작업은 새 Amazon Location 데이터 처리 작업을 시작합니다. 작업 유형, 입력 및 출력 Amazon S3 위치, 서비스에 버킷에 대한 액세스 권한을 부여하는 IAM 실행 역할을 지정합니다. 작업은 작업 진행 상황을 모니터링하는 데 사용할 수 있는 작업 식별자, Amazon 리소스 이름(ARN) 및 초기 상태를 반환합니다.
요청에서 `ActionOptions` 파라미터를 사용하여 추가 기능을 `StartJob` 요청할 수 있습니다. 이러한 기능은 데이터 처리 및 결과를 위한 향상된 옵션을 제공합니다.
`ValidateAddress` 작업의 경우 **위치** 기능에는 [WGS 84(World Geodetic System)](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 형식의 위도 및 경도 좌표가 포함됩니다. **CountrySpecificAttributes**에는 운송업체 경로 정보, 인구 조사 데이터 및 우편 식별자와 같은 각 국가에 특정한 추가 데이터가 포함됩니다.
자세한 내용은 Amazon Location Service API 참조의 [StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)을 참조하세요. **
이 API에 대한 요청, 응답 및 CLI 명령의 예는 [작업을 시작하는 방법을 참조하세요](https://docs.aws.amazon.com/location/latest/developerguide/starting-a-job.html).
## 사용 사례
+ **데이터 마이그레이션 및 시스템 통합:** 시스템 간에 마이그레이션하거나 여러 데이터 소스를 통합 데이터베이스로 통합할 때 대량의 주소 데이터를 정리하고 표준화합니다.
+ **마케팅 캠페인 준비:** 직접 메일 캠페인을 시작하기 전에 고객 주소 데이터베이스를 검증하여 반환된 메일 비용을 줄이고 배달 성공률을 개선합니다.
+ **데이터베이스 유지 관리 및 규정 준수:** 기존 고객 주소 데이터베이스를 정기적으로 검증하여 데이터 품질 표준을 유지하고 배송 및 물류 규정 준수 요구 사항을 충족합니다.
## 요청 이해
`StartJob` 요청에는 작업, 데이터 위치 및 권한을 지정하는 구성 세부 정보가 필요합니다. 이 구성은 데이터가 처리되는 방식과 결과가 저장되는 위치를 결정합니다.
요청에는 다음 파라미터가 포함됩니다.
**작업 작업 및 권한**
작업 유형 및 액세스 권한을 정의하는 필수 파라미터입니다.
+ `Action`: 수행할 작업의 유형입니다. 현재 `ValidateAddress`만 지원됩니다.
+ `ExecutionRoleArn`: Amazon Location이 작업 실행 중에 Amazon S3 버킷에 액세스하기 위해 수임하는 IAM 역할 ARN입니다.
**입력 구성**
입력 데이터를 읽을 위치와 형식을 지정하는 필수 파라미터입니다.
+ `InputOptions`: 입력 데이터 구성을 포함하는 객체입니다.
+ `Location`: 입력 파일이 저장되는 Amazon S3 ARN 또는 URI입니다.
+ `Format`: 입력 데이터 형식입니다. 현재 `Parquet`만 지원됩니다.
**출력 구성**
결과를 작성할 위치와 형식을 지정하는 필수 파라미터입니다.
+ `OutputOptions`: 출력 데이터 구성을 포함하는 객체입니다.
+ `Location`: 출력 파일이 기록되는 Amazon S3 ARN 또는 URI입니다.
+ `Format`: 출력 데이터 형식입니다. 현재 `Parquet`만 지원됩니다.
**선택적 파라미터**
추가 작업 구성 및 기능을 제공하는 파라미터입니다.
+ `Name`: 쉽게 식별할 수 있도록 사람이 읽을 수 있는 작업 이름입니다. 패턴와 일치하는 1\~100자여야 합니다`[-._\w]+`.
+ `ClientToken`: 동일한 작업이 여러 번 생성되지 않도록 하는 Idempotency 토큰입니다. 패턴와 일치하는 1\~64자여야 합니다`^[!-~]+$`.
+ `ActionOptions`: 지정된 작업에 대한 추가 기능이 포함된 객체입니다.
+ `ValidateAddress`: 주소 확인과 관련된 옵션이 포함된 객체입니다.
+ `AdditionalFeatures`: 결과에 포함할 특성 이름 배열입니다. 유효한 값:
+ `Position`: 검증된 각 주소에 대해 위도와 경도를 [WGS 84](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 형식으로 포함합니다.
+ `CountrySpecificAttributes`: 운송업체 경로 정보, 인구 조사 데이터 및 우편 식별자와 같은 각 국가에 특정한 추가 데이터를 포함합니다.
## 응답 이해
`StartJob` 응답은 새로 생성된 작업을 모니터링하고 관리하기 위한 필수 정보를 제공합니다. 이 값을 사용하여 작업 진행 상황을 추적하고 처리가 완료될 때 결과를 검색할 수 있습니다.
응답에는 다음 필드가 포함됩니다.
**작업 식별**
생성된 작업의 고유 식별자입니다.
+ `JobId`: 모니터링 및 관리 작업에 사용되는 고유한 작업 식별자입니다.
+ `JobArn`: 내에서 작업을 고유하게 식별하는 ARN입니다 AWS.
**작업 상태 및 타이밍**
초기 상태 및 생성 타임스탬프입니다.
+ `Status`: 초기 작업 상태입니다. 새로 생성된 작업`Pending`의 경우 항상.
+ `CreatedAt`: ISO 8601 형식의 작업 생성 타임스탬프입니다.