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.
CreateStreamProcessor
Crea un procesador de streaming de Amazon Rekognition que puede utilizar para detectar y reconocer rostros en un vídeo en streaming.
Amazon Rekognition Video es un consumidor de vídeo en directo de Amazon Kinesis Video Streams. Amazon Rekognition Video envía los resultados de análisis a Amazon Kinesis Data Streams.
Proporciona como entrada una transmisión de vídeo de Kinesis (Input
) y una secuencia de datos de Kinesis (Output
) flujo de. También se especifican los criterios de reconocimiento facial enSettings
. Por ejemplo, la colección que contiene caras que desea reconocer. UsarName
para asignar un identificador para el procesador de streaming de. UsasName
para administrar el procesador de streaming. Por ejemplo, puede empezar a procesar el vídeo de origen llamandoStartStreamProcessorconName
.
Una vez que haya terminado de analizar un vídeo en streaming, utiliceStopStreamProcessorpara detener el procesamiento. Puede eliminar el procesador de streaming llamando aDeleteStreamProcessor.
Esto operación requiere permisos para realizar la acción rekognition:CreateStreamProcessor
. Si desea etiquetar el procesador de streaming, también necesita permiso para realizar elrekognition:TagResource
.
Sintaxis de la solicitud
{
"Input": {
"KinesisVideoStream": {
"Arn": "string
"
}
},
"Name": "string
",
"Output": {
"KinesisDataStream": {
"Arn": "string
"
}
},
"RoleArn": "string
",
"Settings": {
"FaceSearch": {
"CollectionId": "string
",
"FaceMatchThreshold": number
}
},
"Tags": {
"string
" : "string
"
}
}
Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
- Input
-
Transmisión de vídeo de Kinesis que proporciona la transmisión de vídeo de origen. Si utiliza la interfaz de línea de línea de AWS de línea de línea de línea de línea de línea de
StreamProcessorInput
.Tipo: objeto StreamProcessorInput
Obligatorio: Sí
- Name
-
Identificador que se asigna al procesador de streaming. Puede usar
Name
para administrar el procesador de streaming. Por ejemplo, puede obtener el estado actual del procesador de streaming llamando aDescribeStreamProcessor.Name
es idempotente.Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 128 caracteres.
Patrón:
[a-zA-Z0-9_.\-]+
Obligatorio: Sí
- Output
-
Transmisión de datos de Kinesis en la que Amazon Rekognition Video pone los resultados del análisis. Si utiliza la interfaz de línea de línea de AWS de línea de línea de línea de línea de línea de
StreamProcessorOutput
.Tipo: objeto StreamProcessorOutput
Obligatorio: Sí
- RoleArn
-
ARN de la función de IAM que permite tener acceso al procesador de streaming de.
Type: Cadena
Patrón:
arn:aws:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+
Obligatorio: Sí
- Settings
-
Parámetros de entrada de reconocimiento facial que debe utilizar el procesador de secuencias. Incluye la colección que se utilizará para el reconocimiento facial y los atributos de cara que se van a detectar.
Tipo: objeto StreamProcessorSettings
Obligatorio: Sí
- Tags
-
Conjunto de etiquetas (pares clave-valor) que desee asociar al procesador de streaming de.
Type: Asignación de cadena a cadena
Entradas de mapa: El número mínimo es 0 elementos. Número máximo de 200 elementos.
Limitaciones de longitud clave: Longitud mínima de 1. La longitud máxima es de 128 caracteres.
Patrón de clave:
^(?!aws:)[\p{L}\p{Z}\p{N}_.:/=+\-@]*$
Restricciones de longitud de valor: Longitud mínima de 0. La longitud máxima es de 256 caracteres.
Patrón de valor:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$
Obligatorio: No
Sintaxis de la respuesta
{
"StreamProcessorArn": "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.
- StreamProcessorArn
-
ARN para el procesador de streaming recién creado.
Type: Cadena
Patrón:
(^arn:[a-z\d-]+:rekognition:[a-z\d-]+:\d{12}:streamprocessor\/.+$)
Errores
- AccessDeniedException
-
No tiene autorización para realizar la acción.
Código de estado HTTP: 400
- InternalServerError
-
Amazon Lex ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
- InvalidParameterException
-
El parámetro de entrada infringió una restricción. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
- LimitExceededException
-
Se ha superado un límite de servicio de Amazon Rekognition. Por ejemplo, si inicia demasiados trabajos de Amazon Rekognition Video simultáneamente, llama para iniciar operaciones (
StartLabelDetection
, por ejemplo) elevará unLimitExceededException
excepción (código de estado HTTP: 400) hasta que el número de trabajos ejecutados simultáneamente se encuentre por debajo del límite de servicio de Amazon Rekognition.Código de estado HTTP: 400
- ProvisionedThroughputExceededException
-
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Rekognition.
Código de estado HTTP: 400
- ResourceInUseException
-
El recurso especificado ya se está utilizando.
Código de estado HTTP: 400
- ServiceQuotaExceededException
-
El tamaño del recurso supera el límite permitido. Para obtener más información, consulte Directrices y cuotas de Amazon Rekognition.
Código de estado HTTP: 400
- ThrottlingException
-
Amazon Lex no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: