翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ジョブを開始する
ジョブ設定で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
