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

Consulta os registros de callback para gravações de transmissão ao vivo armazenadas no OSS.

Descrição da operação

O limite de QPS do site da China (chinês) para um único usuário nesta operação é de 100 chamadas por segundo. Exceder esse limite resulta em limitação de taxa, o que pode afetar seus negócios. Chame esta operação adequadamente.

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:DescribeLiveRecordNotifyRecords

get

*Domínio.

acs:cdn:*:{#accountId}:domain/{#DomainName}

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
DomainName	string	Sim	O domínio de streaming do streamer.	example.com
AppName	string	Não	O nome do aplicativo ao qual a transmissão pertence.	liveApp****
StreamName	string	Não	O nome da transmissão.	liveStream****
PageSize	integer	Sim	O número de entradas por página. Valor padrão: 20. Valor máximo: 500. Valores válidos: qualquer número inteiro de 1 a 500.	10
PageNumber	integer	Sim	O número da página. Valor padrão: 1. Valores válidos: 1 a 100000.	1
Status	string	Não	Especifica se o callback foi bem-sucedido. Valores válidos: success: O callback foi bem-sucedido. failed: O callback falhou.	success
StartTime	string	Sim	A hora de início. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC). Nota Você pode consultar dados dos últimos 7 dias.	2023-02-10T21:03:47Z
EndTime	string	Sim	A hora de término. A hora de término deve ser posterior à hora de início. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC).	2023-02-10T21:03:47Z
StorageType	string	Não	O tipo de armazenamento da gravação para a qual consultar registros de callback. Valores válidos: oss: gravado no OSS vod: gravado no ApsaraVideo VOD all: consulta registros de callback para todos os tipos de armazenamento Valores válidos: all : consulta registros de callback para todos os tipos de armazenamento. vod : gravado no ApsaraVideo VOD. oss : gravado no OSS.	oss

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os registros de callback.
CallbackList	array<object>	Os registros de callback.
	object	Os registros de callback.
AppName	string	O nome do aplicativo ao qual a transmissão pertence.	liveApp****
Description	string	A descrição do resultado. O valor é success se o callback foi bem-sucedido. Caso contrário, uma mensagem de erro é retornada.	success
DomainName	string	O domínio de streaming do streamer.	example.com
NotifyContent	string	O conteúdo específico do callback.	7月26日 16:14{"domain":"al.xxxx.com","stream":"livestream01","pull _stream_result":true,"cdn":"al"}
NotifyResult	string	O resultado do callback. Valores válidos: success: O callback foi bem-sucedido. failed: O callback falhou.	success
NotifyTime	string	A hora do callback. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC).	2022-10-19T19:09:28Z
NotifyType	string	O tipo de callback. Valores válidos: file_created: A gravação foi criada. record_error: Ocorreu um erro de gravação. record_started: A gravação foi iniciada. record_paused: A gravação foi pausada. record_resumed: A gravação foi retomada. record_force_transcode_fail: A tarefa de gravação falhou ao acionar a transcodificação. transformat_error: Ocorreu um erro ao analisar o conteúdo da transmissão ao vivo.	record_started
NotifyUrl	string	A URL de callback de gravação.	http://learn.aliyundoc.com/examplecallback.action
NotifyHeader	string	O cabeçalho da solicitação de callback.	{ "Content-Type": [ "application/json; charset=utf-8" ] }
StreamName	string	O nome da transmissão.	liveStream****
NotifyResponse	string	A resposta retornada pelo usuário após receber o callback.	{"Code":0,"Msg":"Success"}
StorageType	string	O tipo de armazenamento da gravação. Valores válidos: oss: gravado no OSS vod: gravado no ApsaraVideo VOD all: todos os tipos de armazenamento	oss
Code	integer	O código de erro.	0
Msg	string	A mensagem de aviso.	ok
PageNum	integer	O número da página.	1
PageSize	integer	O número de entradas por página.	20
RequestId	string	O ID da solicitação.	180FA0D2-1A02-5158-A36B-115DBF7B218D
TotalNum	integer	O número total de entradas que atendem às condições.	20
TotalPage	integer	O número total de páginas.	20

Exemplos

Resposta de sucesso

JSON formato

{
  "CallbackList": [
    {
      "AppName": "liveApp****",
      "Description": "success",
      "DomainName": "example.com",
      "NotifyContent": "7月26日 16:14{\"domain\":\"al.xxxx.com\",\"stream\":\"livestream01\",\"pull _stream_result\":true,\"cdn\":\"al\"}",
      "NotifyResult": "success",
      "NotifyTime": "2022-10-19T19:09:28Z",
      "NotifyType": "record_started",
      "NotifyUrl": "http://learn.aliyundoc.com/examplecallback.action",
      "NotifyHeader": "{\n  \"Content-Type\": [\n    \"application/json; charset=utf-8\"\n  ]\n}",
      "StreamName": "liveStream****",
      "NotifyResponse": "{\"Code\":0,\"Msg\":\"Success\"}",
      "StorageType": "oss"
    }
  ],
  "Code": 0,
  "Msg": "ok",
  "PageNum": 1,
  "PageSize": 20,
  "RequestId": "180FA0D2-1A02-5158-A36B-115DBF7B218D",
  "TotalNum": 20,
  "TotalPage": 20
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	Invalid JSON
400	MissingParams	%s, please check and try again later.	Parâmetros obrigatórios estão ausentes. Verifique e tente novamente.
400	MalformedParams	%s, please check and try again later.	O parâmetro é inválido. Verifique o parâmetro e tente novamente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.