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

# 監控任務進度
<a name="monitoring-job-progress"></a>

使用 `GetJob`操作定期檢查任務狀態。任務通常會從**待**定進度到**執行****完成**，但處理時間會根據地址數量和請求的功能而有所不同。

監控任務狀態欄位，以判斷處理完成的時間。**已完成**狀態表示成功處理輸出儲存貯體中可用的結果。**失敗**狀態表示發生錯誤，並在任務回應中提供詳細資訊。

請考慮實作 Amazon EventBridge 整合，以接收任務狀態變更的自動通知，而不是持續輪詢 API。

## 範例
<a name="monitor-job-status-examples"></a>

### 監控現有地址驗證任務的狀態
<a name="monitor-job"></a>

------
#### [ 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
```

------