View a markdown version of this page

啟動任務 - Amazon Location Service
地址驗證範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

啟動任務

使用您的任務組態提交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