CreateStreamProcessor - Amazon Rekognition

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

CreateStreamProcessor

Cria um processador de streaming do Amazon Rekognition que você pode usar para detectar e reconhecer faces em um streaming de vídeo.

O Amazon Rekognition Video é um consumidor de vídeos ao vivo do Amazon Kinesis Video Streams. O Amazon Rekognition Video envia resultados da análise para o Amazon Kinesis Data Streams.

Você fornece como entrada um streaming de vídeo do Kinesis (Input) e um stream de dados do Kinesis (Output) stream. Você também especifica os critérios de reconhecimento facial emSettings. Por exemplo, a coleção que contém rostos que você deseja reconhecer. Usar oNamePara atribuir um identificador para o processador de fluxo. Você usaNamePara gerenciar o processador de fluxo do. Você pode começar a processar o vídeo de origem chamandoStartStreamProcessorcom oNamecampo.

Depois de terminar de analisar um streaming de vídeo, useStopStreamProcessorpara interromper o processamento. É possível excluir o processador de fluxo chamandoDeleteStreamProcessor.

Essa operação exige permissões para executar a ação rekognition:CreateStreamProcessor. Se você quiser marcar seu processador de stream, você também precisa de permissão para executar orekognition:TagResourceoperação.

Sintaxe da solicitação

{ "Input": { "KinesisVideoStream": { "Arn": "string" } }, "Name": "string", "Output": { "KinesisDataStream": { "Arn": "string" } }, "RoleArn": "string", "Settings": { "FaceSearch": { "CollectionId": "string", "FaceMatchThreshold": number } }, "Tags": { "string" : "string" } }

Parâmetros de solicitação

A solicitação aceita os dados a seguir no formato JSON.

Input

Fluxo de fluxo de vídeo Kinesis que fornece o streaming de vídeo de origem. Se você estiver usando a CLI do AWS, o nome do parâmetro seráStreamProcessorInput.

Tipo: objeto StreamProcessorInput

: obrigatório Sim

Name

Um identificador atribuído ao processador de fluxo. Você pode usarNamePara gerenciar o processador de fluxo do. Por exemplo, você pode obter o status atual do processador de fluxo chamandoDescribeStreamProcessor.Nameé idempotente.

Type: String

Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 128.

Padrão: [a-zA-Z0-9_.\-]+

: obrigatório Sim

Output

Stream de fluxo de dados do Kinesis para o qual o Amazon Rekognition Video coloca os resultados da análise. Se você estiver usando a CLI do AWS, o nome do parâmetro seráStreamProcessorOutput.

Tipo: objeto StreamProcessorOutput

: obrigatório Sim

RoleArn

O ARN da função do IAM que permite o acesso ao processador de stream.

Type: String

Padrão: arn:aws:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

: obrigatório Sim

Settings

Parâmetros de entrada de reconhecimento facial a serem usados pelo processador de fluxo. Inclui a coleção a ser usada para reconhecimento facial e os atributos faciais a serem detectados.

Tipo: objeto StreamProcessorSettings

: obrigatório Sim

Tags

Um conjunto de chaves (pares chave-valor) que você quer associar ao processador de fluxo.

Type: Mapa de string para string

Entradas do mapa: Número máximo de 0 itens. Número máximo de 200 itens.

Restrições de comprimento da chave: Tamanho mínimo de 1. Tamanho máximo de 128.

Padrão da chave: ^(?!aws:)[\p{L}\p{Z}\p{N}_.:/=+\-@]*$

Restrições de tamanho do valor: Tamanho mínimo de 0. Tamanho máximo de 256.

Padrão de valor:^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

: obrigatório Não

Sintaxe da resposta

{ "StreamProcessorArn": "string" }

Elementos de resposta

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

StreamProcessorArn

ARN para o processador de fluxo recém-criado.

Type: String

Padrão: (^arn:[a-z\d-]+:rekognition:[a-z\d-]+:\d{12}:streamprocessor\/.+$)

Errors

AccessDeniedException

Você não está autorizado a executar a ação.

Código de status HTTP: 400

InternalServerError

O Amazon Rekognition teve um problema de serviço. Tente fazer a chamada novamente.

Código de status HTTP: 500

InvalidParameterException

Um parâmetro de entrada violou uma restrição. Valide seu parâmetro antes de chamar a operação de API novamente.

Código de status HTTP: 400

LimitExceededException

Um limite do serviço Amazon Rekognition foi excedido. Por exemplo, se você iniciar muitos trabalhos do Amazon Rekognition Video simultaneamente, chamadas para iniciar operações (StartLabelDetection, por exemplo) levantará umLimitExceededExceptionexceção (código de status HTTP: 400) até que o número de trabalhos simultâneos fique abaixo do limite de serviço do Amazon Rekognition.

Código de status HTTP: 400

ProvisionedThroughputExceededException

O número de solicitações excedeu o limite da taxa de transferência. Se precisar aumentar esse limite, entre em contato com o Amazon Rekognition.

Código de status HTTP: 400

ResourceInUseException

O recurso especificado já está sendo usado.

Código de status HTTP: 400

ServiceQuotaExceededException

O tamanho do recurso excede o limite permitido. Para obter mais informações, consulte Diretrizes e cotas no Amazon Rekognition.

Código de status HTTP: 400

ThrottlingException

O Amazon Rekognition está temporariamente indisponível para processar a solicitação. Tente fazer a chamada novamente.

Código de status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: