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.
CreateBatchSegmentJob
Crea un trabajo de segmento por lotes. La operación puede gestionar hasta 50 millones de registros y el archivo de entrada debe estar en formato JSON. Para obtener más información, consulte Obtención de recomendaciones por lotes y segmentos de usuario.
Sintaxis de la solicitud
{
"filterArn": "string",
"jobInput": {
"s3DataSource": {
"kmsKeyArn": "string",
"path": "string"
}
},
"jobName": "string",
"jobOutput": {
"s3DataDestination": {
"kmsKeyArn": "string",
"path": "string"
}
},
"numResults": number,
"roleArn": "string",
"solutionVersionArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- filterArn
-
El ARN del filtro que se va a aplicar al trabajo de segmentación por lotes. Para obtener más información, consulte Filtrado de recomendaciones de lote.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: no
- jobInput
-
La ruta de Amazon S3 para los datos de entrada utilizados para generar el trabajo de segmentación por lotes.
Tipo: objeto BatchSegmentJobInput
Obligatorio: sí
- jobName
-
El nombre del trabajo de segmentación por lotes que se va a crear.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.
Patrón:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Obligatorio: sí
- jobOutput
-
La ruta de Amazon S3 del bucket donde se almacenará el resultado del trabajo.
Tipo: objeto BatchSegmentJobOutput
Obligatorio: sí
- numResults
-
El número de usuarios previsto que generará el trabajo de segmentación por lotes para cada línea de datos de entrada. El número máximo de usuarios por segmento es de 5 millones.
Tipo: entero
Obligatorio: no
- roleArn
-
El ARN del rol de Amazon Identity and Access Management que tiene permisos de lectura y escritura en los buckets de Amazon S3 de entrada y salida, respectivamente.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Obligatorio: sí
- solutionVersionArn
-
El nombre de recurso de Amazon (ARN) de la versión de la solución que desea que el trabajo de segmentación por lotes use para generar segmentos por lote.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: sí
-
Una lista de etiquetas para aplicar al trabajo de segmentación por lotes.
Tipo: matriz de objetos Tag
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.
Obligatorio: no
Sintaxis de la respuesta
{
"batchSegmentJobArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- batchSegmentJobArn
-
El ARN del trabajo de segmentación por lotes.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errores
- InvalidInputException
-
Proporcione un valor válido para el campo o el parámetro.
Código de estado HTTP: 400
- LimitExceededException
-
Se ha excedido el límite en el número de solicitudes por segundo.
Código de estado HTTP: 400
- ResourceAlreadyExistsException
-
El recurso especificado ya existe.
Código de estado HTTP: 400
- ResourceInUseException
-
El recurso especificado está en uso.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No se ha encontrado el recurso especificado.
Código de estado HTTP: 400
- TooManyTagsException
-
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
