CreateLiveStreamMonitor - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Cria uma sessão de monitoramento.

Descrição da operação

Chame esta operação para criar uma sessão de monitoramento. Certifique-se de que os parâmetros obrigatórios estejam configurados.

Limite de QPS

O limite de consultas por segundo (QPS) para um único usuário é de 10 chamadas por segundo. Se você exceder o limite, suas chamadas de API serão limitadas. Isso pode afetar seus negócios. Planeje suas chamadas de API de acordo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

live:CreateLiveStreamMonitor

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-shanghai
MonitorName	string	Sim	O nome da sessão de monitoramento.	liveMonitor****
OutputTemplate	string	Sim	O modelo de saída para a sessão de monitoramento. Valores válidos: lp_ld: baixa definição. lp_sd: definição padrão. lp_hd: alta definição. lp_ud: ultra-alta definição.	lp_ud
Domain	string	Sim	O nome de domínio a ser monitorado.	demo.aliyundoc.com
App	string	Não	O nome do aplicativo para o fluxo de saída da sessão de monitoramento. Você pode especificar um nome personalizado. Se você não especificar este parâmetro, monitor será usado como o nome do aplicativo.	monitor****
Stream	string	Não	O nome do fluxo de saída para a sessão de monitoramento. Se você não especificar este parâmetro, o sistema gerará um nome aleatório.	monitorStream****
InputList	string	Sim	A lista de fluxos de entrada a serem monitorados. Para obter mais informações, consulte a tabela InputConfig abaixo.	InputConfig
MonitorConfig	string	Não	As configurações de limite de alerta para monitoramento. O valor deve ser uma string JSON. Para obter mais informações, consulte a tabela MonitorConfig abaixo.	"{\"fpsLowThres\": 0.6,\"brLowThres\": 1.1,\"eofDurationThresSec\": 10}"
CallbackUrl	string	Não	O endereço do webhook. HTTP e HTTPS são suportados.	http://guide.aliyundoc.com/notify
DingTalkWebHookUrl	string	Não	A URL do webhook do chatbot do DingTalk. Para receber notificações de alerta, configure um chatbot do DingTalk e insira sua URL do webhook, que pode estar no formato HTTP ou HTTPS. Para obter mais informações, consulte Acesso de robô personalizado. Nota Defina a palavra-chave personalizada para o chatbot do DingTalk como "Alerting". Caso contrário, você não poderá receber mensagens.	https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa****

InputConfig

Nome	Tipo	Descrição	Valor de exemplo
Index	Integer	O índice. Este parâmetro é usado pelo frontend.	1
LayoutId	Integer	O ID do layout. O valor deve começar em 1.	1
StreamName	String	O nome de exibição do fluxo monitorado.	monitorStream****
InputUrl	String	A URL do fluxo de entrada.	demo.aliyundoc.com
LayoutConfig	LayoutConfig	As configurações de layout.	Consulte a tabela LayoutConfig abaixo.
PlayConfig	PlayConfig	A configuração de reprodução.	Consulte a tabela PlayConfig abaixo.

LayoutConfig

Nome	Tipo	Descrição	Valor de exemplo
FillMode	String	O modo de preenchimento. Defina este parâmetro como `none` para o frontend.	none
PositionRefer	String	O ponto de referência para a posição do elemento. Valores válidos: `topLeft` (superior esquerdo), `topRight` (superior direito), `bottomLeft` (inferior esquerdo) e `bottomRight` (inferior direito).	topLeft
PositionNormalized	Float	A posição normalizada da área de preenchimento da camada, no formato `[x,y]`. Os valores de x e y variam de 0 a 1. Por exemplo, `[0.1,0.1]` indica um deslocamento horizontal de 10% e um deslocamento vertical de 10% a partir do canto superior esquerdo.	[0.1, 0.1]
SizeNormalized	Float	O tamanho normalizado da camada, no formato `[w,h]`. Os valores de w e h variam de 0 a 1. Tanto a largura quanto a altura são normalizadas. Por exemplo, `[0.2,0.3]` indica uma largura de 20% e uma altura de 30%.	[0.2, 0.3]

PlayConfig

Nome	Tipo	Descrição	Valor de exemplo
VolumeRate	Float	O volume. O valor pode ser de 0 a 1, com precisão de duas casas decimais.	0.50

MonitorConfig

Nome	Tipo	Descrição	Valor de exemplo
fpsLowThres	Float	O limite de alerta para a taxa de quadros de vídeo. Este limite é um coeficiente. O valor pode ser de (0.0, 1.0]. O valor padrão é 0.7. Um alerta é acionado se a taxa de quadros de vídeo do fluxo monitorado for menor que (o limite de alerta × a taxa de quadros original do fluxo ao vivo).	0.7
brHighThres	Float	O limite de alerta para a taxa de bits de áudio e vídeo. Este limite é um coeficiente. O valor pode ser de (0.0, 100]. O valor padrão é 1.0. Um alerta é acionado se a taxa de bits de áudio e vídeo do fluxo monitorado for maior que (o limite de alerta × a taxa de bits original do fluxo ao vivo).	1.0
eofDurationThresSec	Float	O limite para a duração de uma interrupção de fluxo antes que um alerta seja acionado. Unidade: segundos. O valor pode ser de (0, 65535]. O valor padrão é 0. - Após a interrupção de um fluxo, a conexão permanece ativa. O sistema usa um tempo limite interno de recebimento de pacotes de 5 segundos para detectar a interrupção. Se você definir este parâmetro com um valor menor ou igual a 5 segundos, o tempo de detecção real será de 5 segundos. Se você definir este parâmetro com um valor maior que 5 segundos, o tempo de detecção real será o valor definido. Os primeiros 5 segundos deste período são para o tempo limite interno, e o restante é o tempo que o sistema aguarda a recuperação do fluxo. - Se o fluxo se recuperar antes do término do período de tempo limite, nenhum alerta será acionado. Se você alterar o endereço de monitoramento antes que o tempo limite do fluxo expire, o sistema parará de detectar tempos limite e acionar alertas para o fluxo anterior.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
MonitorId	string	O ID da sessão de monitoramento.	445409ec-7eaa-461d-8f29-4bec2eb9****
RequestId	string	O ID da solicitação.	5c6a2a0d-f228-4a64-af62-20e91b96****

Exemplos

Resposta de sucesso

JSON formato

{
  "MonitorId": "445409ec-7eaa-461d-8f29-4bec2eb9****",
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b96****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
400	InvalidUserId.Malformed	%s, please check userId.	The userId passed in is invalid, please check.
400	MissingParameter	%s.	Missing parameter
400	StreamMonitorExist	%s, please check and try again later.	The monitoring room already exists, please check and try again.
401	IllegalOperation	%s, please check and try again later.	Operation not allowed, please check and try again.
500	InternalError	%s, please try again later.	Internal error, please try again later.
404	InvalidDomainName.NotFound	%s, please check and try again later.	Domain name does not exist, please check and try again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.