Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Comenzar un trabajo
Envíe una StartJob solicitud con la configuración de su trabajo. Especifique la acción que desea realizar, proporcione el ARN de su función de ejecución y configure las opciones de entrada y salida con las ubicaciones de sus buckets de Amazon S3.
Algunos tipos de acciones admiten funciones adicionales opcionales que mejoran los resultados. Las funciones disponibles dependen del tipo de acción. Para ver las funciones adicionales de validación de direcciones, consulteFunciones de validación de direcciones.
Proporcione un nombre de trabajo significativo para ayudar a identificar el trabajo en las operaciones de supervisión y administración. Considere incluir marcas de tiempo o identificadores de lote en los nombres de los trabajos para facilitar el seguimiento.
Ejemplos de validación de direcciones
Los siguientes ejemplos muestran cómo iniciar un trabajo de validación de direcciones. Úselos como referencia para la estructura de la solicitud.
- 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
El siguiente ejemplo incluye las funciones Position y CountrySpecificAttributes otras adicionales:
- 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
