View a markdown version of this page

ジョブの進行状況のモニタリング - Amazon Location Service
例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ジョブの進行状況のモニタリング

GetJob オペレーションを使用して、ジョブのステータスを定期的に確認します。ジョブは通常、保留中から実行中、完了まで進行しますが、処理時間はアドレスの数とリクエストされた機能によって異なります。

ジョブステータスフィールドをモニタリングして、処理が完了したタイミングを判断します。完了ステータスは、出力バケットで使用可能な結果で処理が成功したことを示します。Failed ステータスは、エラーが発生したことを示し、詳細はジョブレスポンスで確認できます。

API を継続的にポーリングするのではなく、Amazon EventBridge 統合を実装して、ジョブステータスの変更に関する自動通知を受け取ることを検討してください。

例

Sample request
{  
    "JobId": "YOUR_JOB_ID"
}
Sample response
{
    "Action": "ValidateAddress",
    "CreatedAt": "2023-01-01T00:00:00Z",
    "EndedAt": "2023-01-01T01:00:00Z",
    "ExecutionRoleArn": "arn:aws:iam::YOUR_ACCOUNT_ID:role/LocationServiceJobExecutionRole",
    "InputOptions": {
        "Location": "arn:aws:s3:::YOUR_INPUT_BUCKET",
        "Format": "Parquet"
    },
    "JobArn": "arn:aws:geo:us-west-2:YOUR_ACCOUNT_ID:job/YOUR_JOB_ID",
    "JobId": "YOUR_JOB_ID",
    "Name": "MyFirstValidationJob",
    "OutputOptions": {
        "Format": "Parquet",
        "Location": "arn:aws:s3:::YOUR_OUTPUT_BUCKET"
    },
    "Status": "Completed",
    "UpdatedAt": "2023-01-01T01:00:00Z",
    "ActionOptions": {
        "ValidateAddress": {
            "AdditionalFeatures": [
                "Position",
                "CountrySpecificAttributes"
            ]
        }
    }
}
AWS CLI
aws location get-job --job-id "YOUR_JOB_ID" --region us-west-2