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
Para obtener más información, consulta StartJobla 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.
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 admiteValidateAddress. -
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 admiteParquet.
-
-
- 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 admiteParquet.
-
-
- 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 84para 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. SiemprePendingpara puestos de trabajo recién creados. -
CreatedAt: Fecha y hora de creación de empleo en formato ISO 8601.
-
