Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Commencer un travail
Soumettez une StartJob demande avec la configuration de votre tâche. Spécifiez l'action que vous souhaitez effectuer, fournissez l'ARN de votre rôle d'exécution et configurez les options d'entrée et de sortie avec les emplacements de vos compartiments Amazon S3.
Certains types d'actions prennent en charge des fonctionnalités supplémentaires facultatives qui améliorent les résultats. Les fonctionnalités disponibles dépendent du type d'action. Pour les fonctionnalités supplémentaires de validation des adresses, voirFonctionnalités de validation des adresses.
Indiquez un nom de poste significatif pour aider à identifier le poste dans le cadre des opérations de surveillance et de gestion. Envisagez d'inclure des horodatages ou des identifiants de lot dans les noms des tâches pour faciliter le suivi.
Exemples de validation d'adresses
Les exemples suivants montrent comment démarrer une tâche de validation d'adresse. Utilisez-les comme référence pour la structure de la demande.
- 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
L'exemple suivant inclut Position les fonctionnalités CountrySpecificAttributes supplémentaires :
- 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
