View a markdown version of this page

Monitor job progress - Amazon Location Service
Examples

Monitor job progress

Use the GetJob operation to check job status periodically. Jobs typically progress from Pending to Running to Completed, though processing time varies based on the number of addresses and requested features.

Monitor the job status field to determine when processing is complete. The Completed status indicates successful processing with results available in your output bucket. The Failed status indicates an error occurred, with details available in the job response.

Consider implementing Amazon EventBridge integration to receive automatic notifications of job status changes rather than polling the API continuously.

Examples

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