View a markdown version of this page

StartJob - Amazon Location Service
사용 사례요청 이해응답 이해

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

StartJob

StartJob 작업은 새 Amazon Location 데이터 처리 작업을 시작합니다. 작업 유형, 입력 및 출력 Amazon S3 위치, 서비스에 버킷에 대한 액세스 권한을 부여하는 IAM 실행 역할을 지정합니다. 작업은 작업 진행 상황을 모니터링하는 데 사용할 수 있는 작업 식별자, Amazon 리소스 이름(ARN) 및 초기 상태를 반환합니다.

요청에서 ActionOptions 파라미터를 사용하여 추가 기능을 StartJob 요청할 수 있습니다. 이러한 기능은 데이터 처리 및 결과를 위한 향상된 옵션을 제공합니다.

ValidateAddress 작업의 경우 위치 기능에는 WGS 84(World Geodetic System) 형식의 위도 및 경도 좌표가 포함됩니다. CountrySpecificAttributes에는 운송업체 경로 정보, 인구 조사 데이터 및 우편 식별자와 같은 각 국가에 특정한 추가 데이터가 포함됩니다.

자세한 내용은 Amazon Location Service API 참조의 StartJob을 참조하세요.

이 API에 대한 요청, 응답 및 CLI 명령의 예는 작업을 시작하는 방법을 참조하세요.

사용 사례

  • 데이터 마이그레이션 및 시스템 통합: 시스템 간에 마이그레이션하거나 여러 데이터 소스를 통합 데이터베이스로 통합할 때 대량의 주소 데이터를 정리하고 표준화합니다.

  • 마케팅 캠페인 준비: 직접 메일 캠페인을 시작하기 전에 고객 주소 데이터베이스를 검증하여 반환된 메일 비용을 줄이고 배달 성공률을 개선합니다.

  • 데이터베이스 유지 관리 및 규정 준수: 기존 고객 주소 데이터베이스를 정기적으로 검증하여 데이터 품질 표준을 유지하고 배송 및 물류 규정 준수 요구 사항을 충족합니다.

요청 이해

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 형식으로 포함합니다.

        • CountrySpecificAttributes: 운송업체 경로 정보, 인구 조사 데이터 및 우편 식별자와 같은 각 국가에 특정한 추가 데이터를 포함합니다.

응답 이해

StartJob 응답은 새로 생성된 작업을 모니터링하고 관리하기 위한 필수 정보를 제공합니다. 이 값을 사용하여 작업 진행 상황을 추적하고 처리가 완료될 때 결과를 검색할 수 있습니다.

응답에는 다음 필드가 포함됩니다.

작업 식별

생성된 작업의 고유 식별자입니다.

  • JobId: 모니터링 및 관리 작업에 사용되는 고유한 작업 식별자입니다.

  • JobArn: 내에서 작업을 고유하게 식별하는 ARN입니다 AWS.

작업 상태 및 타이밍

초기 상태 및 생성 타임스탬프입니다.

  • Status: 초기 작업 상태입니다. 새로 생성된 작업Pending의 경우 항상.

  • CreatedAt: ISO 8601 형식의 작업 생성 타임스탬프입니다.