CreateStreamProcessor - Amazon Rekognition

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. UsarNamepara asignar un identificador para el procesador de streaming de. UsasNamepara 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 deStreamProcessorInput.

Tipo: objeto StreamProcessorInput

Obligatorio: Sí

Name

Identificador que se asigna al procesador de streaming. Puede usarNamepara administrar el procesador de streaming. Por ejemplo, puede obtener el estado actual del procesador de streaming llamando aDescribeStreamProcessor.Namees 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 deStreamProcessorOutput.

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á unLimitExceededExceptionexcepció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: