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

Atualiza as configurações de uma sessão de monitoramento.

Descrição da operação

Esta operação atualiza a configuração de uma sessão de monitoramento. Se a sessão de monitoramento estiver em execução, as atualizações na configuração da fonte de entrada entrarão em vigor em tempo real.

Limite de QPS

O limite de consultas por segundo (QPS) para um único usuário é 10. As chamadas de API que excederem esse limite serão limitadas. A limitação pode afetar seus negócios, portanto, recomendamos que você planeje suas chamadas 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:UpdateLiveStreamMonitor

update

*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
MonitorId	string	Sim	O ID da sessão de monitoramento. Nota Obtenha o valor de MonitorId a partir dos parâmetros de resposta da operação CreateLiveStreamMonitor.	445409ec-7eaa-461d-8f29-4bec2eb9****
MonitorName	string	Não	O nome da sessão de monitoramento.	liveMonitor****
Domain	string	Não	O nome de domínio de saída para a sessão de monitoramento.	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 AppName.	monitor****
Stream	string	Não	O nome do fluxo de saída para a sessão de monitoramento.	monitorStream****
OutputTemplate	string	Não	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
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 para os limites de alerta. O valor é 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. Os alertas de monitoramento são enviados para um grupo do DingTalk usando um chatbot. Configure um chatbot e insira sua URL de webhook, que deve ser um endereço HTTP ou HTTPS. Para obter mais informações, consulte Acesso de robô personalizado. Nota Defina a palavra-chave personalizada do chatbot do DingTalk como "Alerting". Caso contrário, as mensagens não poderão ser recebidas.	https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa****

InputConfig

Nome	Tipo	Descrição	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 informações de layout.	Para obter mais informações, consulte a tabela LayoutConfig abaixo.
PlayConfig	PlayConfig	A configuração de reprodução.	Para obter mais informações, consulte a tabela PlayConfig abaixo.

LayoutConfig

Nome	Tipo	Descrição	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, TopRight, BottomLeft e BottomRight.	TopLeft
PositionNormalized	Float	A posição normalizada da área de preenchimento para o elemento da camada. O valor está 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 da área de preenchimento para o elemento da camada. O valor está 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 proporção horizontal de 20% e uma proporção vertical de 30%.	[0.2, 0.3]

PlayConfig

Nome	Tipo	Descrição	Exemplo
VolumeRate	Float	O volume. O valor varia de 0 a 1, com precisão de duas casas decimais.	0.50

MonitorConfig

Nome	Tipo	Descrição	Exemplo
fpsLowThres	Float	O limite de alerta para a taxa de quadros de vídeo. Este limite é um coeficiente. O valor deve estar no intervalo (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 (limite de alerta × 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 deve estar no intervalo (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 (limite de alerta × taxa de bits original do fluxo ao vivo).	1.0
eofDurationThresSec	Float	O limite para detecção de interrupção de fluxo, em segundos. Um alerta é acionado se o fluxo monitorado for interrompido por uma duração maior que este limite. O valor deve estar no intervalo (0, 65535]. O valor padrão é 0. Após a interrupção de um fluxo, a conexão permanece ativa. O sistema determina que o fluxo foi interrompido se ocorrer um tempo limite de recebimento de pacote de 5 s. Portanto, se você definir este parâmetro com um valor menor ou igual a 5 s, o tempo de detecção real será de 5 s. Se você definir este parâmetro com um valor maior que 5 s, o tempo de detecção real será o valor definido. Os primeiros 5 s são para o tempo limite interno de recebimento de pacote, e o tempo restante é a duração durante a qual o sistema aguarda a retomada do fluxo. Se o fluxo for retomado antes do período de tempo limite expirar, nenhum alerta será acionado. Se você alterar o endereço de monitoramento antes do tempo limite do fluxo, o sistema interromperá a detecção do tempo limite e não acionará um alerta para o fluxo anterior.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	5c6a2a0d-f228-4a64-af62-20e91b9676b3

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b9676b3"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidUserId.Malformed	%s, please check userId.	The userId passed in is invalid, please check.
400	InvalidParameter.Malformed	There are invalid parameters: %s.	There are invalid parameters: %s.
400	MissingParameter	%s.	Missing parameter
400	InvalidMonitorId.Malformed	%s, please check and try again later.	The parameter MonitorId is invalid, 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.
404	StreamMonitorNotExist	%s, please check and try again later.	The monitoring room 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.