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.
# StartJob
La `StartJob` operación inicia un nuevo trabajo de procesamiento de datos de Amazon Location. Usted especifica el tipo de acción, las ubicaciones de entrada y salida de Amazon S3 y una función de ejecución de IAM que concede al servicio acceso a sus buckets. La operación devuelve un identificador de trabajo, un nombre de recurso de Amazon (ARN) y un estado inicial que puede utilizar para supervisar el progreso del trabajo.
Puede solicitar funciones adicionales mediante el `ActionOptions` parámetro de las `StartJob` solicitudes. Estas funciones proporcionan opciones mejoradas para el procesamiento de datos y los resultados.
Para los `ValidateAddress` trabajos, la función **Posición** incluye coordenadas de latitud y longitud en formato del [Sistema Geodésico Mundial (WGS 84](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84)). **CountrySpecificAttributes**incluye datos adicionales específicos de cada país, como información sobre las rutas de los transportistas, datos censales e identificadores postales.
Para obtener más información, consulta [StartJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_StartJob.html)la *referencia de la API de Amazon Location Service*.
Para ver ejemplos de solicitudes, respuestas y comandos de CLI para esta API, consulta [Cómo iniciar un trabajo](https://docs.aws.amazon.com/location/latest/developerguide/starting-a-job.html).
## Casos de uso
+ **Migración de datos y consolidación de sistemas:** limpie y estandarice grandes volúmenes de datos de direcciones al migrar entre sistemas o al consolidar múltiples fuentes de datos en una base de datos unificada.
+ **Preparación de campañas de marketing:** valide las bases de datos de direcciones de los clientes antes de lanzar campañas de correo directo para reducir los costos de devolución de correo y mejorar las tasas de éxito de las entregas.
+ **Mantenimiento y cumplimiento de las bases de datos:** valide periódicamente las bases de datos de direcciones de clientes existentes para mantener los estándares de calidad de los datos y cumplir con los requisitos de conformidad logística y de envío.
## Explicación de la solicitud
La `StartJob` solicitud requiere detalles de configuración que especifiquen la acción del trabajo, las ubicaciones de los datos y los permisos. Esta configuración determina cómo se procesan los datos y dónde se almacenan los resultados.
La solicitud incluye los siguientes parámetros:
**Job, acción y permisos**
Parámetros necesarios que definen el tipo de operación y los permisos de acceso.
+ `Action`: el tipo de operación que se va a realizar. En la actualidad, solo se admite `ValidateAddress`.
+ `ExecutionRoleArn`: ARN del rol de IAM que Amazon Location asume para acceder a sus buckets de Amazon S3 durante la ejecución del trabajo.
**Configuración de entrada**
Parámetros obligatorios que especifican dónde leer los datos de entrada y su formato.
+ `InputOptions`: Objeto que contiene la configuración de los datos de entrada.
+ `Location`: ARN o URI de Amazon S3 donde se almacenan los archivos de entrada.
+ `Format`: Formato de datos de entrada. En la actualidad, solo se admite `Parquet`.
**Configuración de salida**
Parámetros obligatorios que especifican dónde escribir los resultados y su formato.
+ `OutputOptions`: Objeto que contiene la configuración de los datos de salida.
+ `Location`: ARN o URI de Amazon S3 donde se escriben los archivos de salida.
+ `Format`: Formato de datos de salida. En la actualidad, solo se admite `Parquet`.
**Parámetros opcionales**
Parámetros que proporcionan funciones y configuraciones de trabajo adicionales.
+ `Name`: nombre del trabajo legible por humanos para facilitar la identificación. Debe tener entre 1 y 100 caracteres que coincidan con el patrón. `[-._\w]+`
+ `ClientToken`: token de idempotencia para garantizar que no se cree el mismo trabajo varias veces. Debe tener entre 1 y 64 caracteres que coincidan con el patrón. `^[!-~]+$`
+ `ActionOptions`: objeto que contiene funciones adicionales para la acción especificada.
+ `ValidateAddress`: Objeto que contiene opciones específicas para la validación de direcciones.
+ `AdditionalFeatures`: Matriz de nombres de funciones para incluirlos en los resultados. Valores válidos:
+ `Position`: Incluye la latitud y la longitud en formato [WGS 84](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) para cada dirección validada.
+ `CountrySpecificAttributes`: Incluye datos adicionales específicos de cada país, como información sobre las rutas de los transportistas, datos censales e identificadores postales.
## Explicación de la respuesta
La `StartJob` respuesta proporciona información esencial para supervisar y gestionar el puesto de trabajo recién creado. Utilice estos valores para realizar un seguimiento del progreso del trabajo y recuperar los resultados cuando se complete el procesamiento.
La respuesta incluye los siguientes campos:
**Identificación del trabajo**
Identificadores únicos para el trabajo creado.
+ `JobId`: identificador de trabajo único que se utiliza para las operaciones de supervisión y gestión.
+ `JobArn`: ARN que identifica de forma exclusiva el trabajo interno. AWS
**Situación y calendario del trabajo**
Estado inicial y fecha de creación.
+ `Status`: Estado inicial del trabajo. Siempre `Pending` para puestos de trabajo recién creados.
+ `CreatedAt`: Fecha y hora de creación de empleo en formato ISO 8601.