기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
작업 시작
작업 구성으로 StartJob 요청을 제출합니다. 수행할 작업을 지정하고, 실행 역할 ARN을 제공하고, Amazon S3 버킷 위치로 입력 및 출력 옵션을 구성합니다.
일부 작업 유형은 결과를 개선하는 선택적 추가 기능을 지원합니다. 사용 가능한 기능은 작업 유형에 따라 다릅니다. 주소 확인 추가 기능은 섹션을 참조하세요주소 확인 기능.
모니터링 및 관리 작업에서 작업을 식별하는 데 도움이 되는 의미 있는 작업 이름을 제공합니다. 더 쉽게 추적할 수 있도록 작업 이름에 타임스탬프 또는 배치 식별자를 포함하는 것이 좋습니다.
주소 확인 예제
다음 예제에서는 주소 확인 작업을 시작하는 방법을 보여줍니다. 이를 요청 구조의 참조로 사용합니다.
- Sample request
-
{
"Action": "ValidateAddress",
"Name": "MyFirstValidationJob",
"ExecutionRoleArn": "arn:aws:iam::YOUR_ACCOUNT_ID:role/LocationServiceJobExecutionRole",
"InputOptions": {
"Location": "arn:aws:s3:::YOUR_INPUT_BUCKET_NAME",
"Format": "Parquet"
},
"OutputOptions": {
"Location": "arn:aws:s3:::YOUR_OUTPUT_BUCKET_NAME",
"Format": "Parquet"
}
}
- Sample response
-
{
"CreatedAt": "2024-01-01T00:00:00Z",
"JobArn": "arn:aws:geo:us-west-2:YOUR_ACCOUNT_ID:job/MyFirstValidationJob-12345678-abcd-1234-5678-abcdef123456",
"JobId": "MyFirstValidationJob-12345678-abcd-1234-5678-abcdef123456",
"Status": "Pending"
}
- AWS CLI
-
aws location start-job \
--action ValidateAddress \
--execution-role-arn "arn:aws:iam::YOUR_ACCOUNT_ID:role/LocationServiceJobExecutionRole" \
--input-options Location=arn:aws:s3:::YOUR_INPUT_BUCKET,Format=Parquet \
--name "MyFirstCLIJob" \
--output-options Location=arn:aws:s3:::YOUR_OUTPUT_BUCKET,Format=Parquet \
--region us-west-2
다음 예제에는 Position 및 CountrySpecificAttributes 추가 기능이 포함되어 있습니다.
- Sample request
-
{
"Action": "ValidateAddress",
"Name": "ValidationJobWithFeatures",
"ExecutionRoleArn": "arn:aws:iam::YOUR_ACCOUNT_ID:role/LocationServiceJobExecutionRole",
"InputOptions": {
"Location": "arn:aws:s3:::YOUR_INPUT_BUCKET_NAME",
"Format": "Parquet"
},
"OutputOptions": {
"Location": "arn:aws:s3:::YOUR_OUTPUT_BUCKET_NAME",
"Format": "Parquet"
},
"ActionOptions": {
"ValidateAddress": {
"AdditionalFeatures": [
"Position",
"CountrySpecificAttributes"
]
}
}
}
- AWS CLI
-
aws location start-job \
--action ValidateAddress \
--execution-role-arn "arn:aws:iam::YOUR_ACCOUNT_ID:role/LocationServiceJobExecutionRole" \
--input-options Location=arn:aws:s3:::YOUR_INPUT_BUCKET,Format=Parquet \
--name "ValidationJobWithFeatures" \
--output-options Location=arn:aws:s3:::YOUR_OUTPUT_BUCKET,Format=Parquet \
--action-options '{"ValidateAddress":{"AdditionalFeatures":["Position","CountrySpecificAttributes"]}}' \
--region us-west-2
