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

# 啟動任務
<a name="starting-a-job"></a>

使用您的任務組態提交`StartJob`請求。指定您要執行的動作、提供執行角色 ARN，以及使用 Amazon S3 儲存貯體位置設定輸入和輸出選項。

有些動作類型支援可增強結果的選用其他功能。可用的功能取決於動作類型。如需地址驗證的其他功能，請參閱 [地址驗證功能](address-validation-concepts.md#address-validation-features)。

提供有意義的任務名稱，以協助識別監控和管理操作中的任務。請考慮在任務名稱中包含時間戳記或批次識別符，以便於追蹤。

## 地址驗證範例
<a name="start-job-examples"></a>

下列範例示範如何啟動地址驗證任務。使用這些項目做為請求結構的參考。

### 啟動非同步地址驗證任務
<a name="start-address-validation-example"></a>

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

------

### 使用其他功能啟動任務
<a name="start-job-with-features-example"></a>

下列範例包含 `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
```

------