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

Atualiza uma configuração de gravação de transmissão ao vivo que salva a saída no Object Storage Service (OSS).

Descrição da operação

Limite de QPS

Você pode chamar esta operação até 30 vezes por segundo por conta. Solicitações que excederem esse limite serão descartadas e você poderá enfrentar interrupções no serviço.

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

update

*Domain

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DomainName	string	Sim	O domínio principal de streaming.	example.com
AppName	string	Sim	O AppName da transmissão ao vivo.	liveApp****
OssEndpoint	string	Sim	O endpoint para armazenamento OSS. Você deve criar um bucket OSS antes de usar este recurso. Consulte Configurar OSS.	learn.developer.aliyundoc.com
StreamName	string	Não	O nome da transmissão ao vivo.	teststream
StartTime	string	Não	A hora de início da gravação. Formato: yyyy-MM-ddTHH:mm:ssZ (horário UTC). Nota Este parâmetro é efetivo apenas para gravações no nível de stream (ou seja, quando `StreamName` é especificado). O horário deve estar dentro de 7 dias do horário real de início do stream.	2018-04-10T09:57:21Z
EndTime	string	Não	A hora de término da gravação. Formato: yyyy-MM-ddTHH:mm:ssZ (horário UTC). Nota Este parâmetro é efetivo apenas para gravações no nível de stream. O intervalo entre EndTime e StartTime não pode exceder 7 dias.	2018-04-16T09:57:21Z
OnDemand	integer	Não	Especifica o modo de gravação. Valores válidos: 0: desativa a gravação sob demanda. 1: gravação sob demanda via callback HTTP. 2: gravação sob demanda por análise de parâmetros na URL de ingestão. 7: gravação manual. Você pode chamar a API RealTimeRecordCommand para iniciar ou parar a gravação manualmente. Nota Se você definir OnDemand como 1, será necessário chamar a API AddLiveRecordNotifyConfig para configurar o parâmetro OnDemandUrl. Caso contrário, o ApsaraVideo Live não realizará a gravação sob demanda.	1
DelayTime	integer	Não	A janela em segundos para mesclar gravações fragmentadas após uma interrupção. Se um stream desconectar e reconectar dentro dessa janela, a gravação continuará no mesmo arquivo. Valores válidos: 15 a 21600.	180
RecordFormat	array<object>	Não	Os detalhes da gravação.
	object	Não
CycleDuration	integer	Não	A duração de um único ciclo de gravação em segundos. Se não especificado, o valor padrão é 6 horas. Nota Se uma transmissão ao vivo for interrompida durante um ciclo de gravação, mas retomar o streaming normal dentro da janela de mesclagem, a gravação continuará no mesmo arquivo. Um arquivo de gravação é gerado apenas quando uma transmissão ao vivo é interrompida por mais tempo do que a janela de mesclagem.	1
Format	string	Não	O formato de gravação. Valores válidos: Importante Se você escolher m3u8 ou cmaf, também deverá definir SliceOssObjectPrefix e SliceDuration. Pelo menos um entre RecordFormat ou TranscodeRecordFormat deve ser especificado. m3u8 flv mp4 cmaf	m3u8
SliceDuration	integer	Não	A duração de um único segmento. Unidade: segundos. Nota Este parâmetro é efetivo apenas se você definir o parâmetro RecordFormat.N.Format como m3u8 ou cmaf. Se você não especificar este parâmetro, o valor padrão de 30 segundos será usado. Valores válidos: 5 a 30.	30
TranscodeRecordFormat	array<object>	Não	A configuração de gravação de stream transcodificado.
	object	Não
CycleDuration	integer	Não	O ciclo de gravação do stream transcodificado. Unidade: segundos. Se você não especificar este parâmetro, o valor padrão de 6 horas será usado.	21600
Format	string	Não	O formato da gravação do stream transcodificado. Valores válidos: Nota Se você escolher m3u8 ou cmaf, deverá especificar os parâmetros TranscodeRecordFormat.N.SliceOssObjectPrefix e TranscodeRecordFormat.N.SliceDuration. m3u8 flv mp4 cmaf	m3u8
SliceDuration	integer	Não	A duração de um único segmento para gravação de stream transcodificado. Unidade: segundos. Nota Este parâmetro é efetivo apenas se você definir o parâmetro TranscodeRecordFormat.N.Format como m3u8 ou cmaf. Se você não especificar este parâmetro, o valor padrão de 30 segundos será usado. Valores válidos: 5 a 30.	30
TranscodeTemplates	array	Não	Os detalhes do grupo de modelos de transcodificação.
	string	Não	O modelo de transcodificação. Você pode configurar até 10 modelos de transcodificação por vez. Se você especificar os parâmetros TranscodeRecordFormat.N.xxx, configure pelo menos um modelo de transcodificação. Para gravar múltiplos ou todos os streams transcodificados, você pode definir TranscodeTemplates.1 como *** (cinco asteriscos). Nota** Não é permitido passar `raw` em TranscodeTemplates, pois é um identificador reservado. O .N em TranscodeTemplates.N representa um índice incremental para especificar múltiplos modelos. Por exemplo: TranscodeTemplates.1=sd, TranscodeTemplates.2=hd.	sd

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidOssBucket.Malformed	Specified parameter OssBucket is not valid.
400	InvalidOssBucket.NotFound	The parameter OssBucket does not exist.
400	InvalidFormat.Malformed	Specified parameter Format is not valid.	Invalid value of Format. Check whether the Format parameter that you specified is correct.
400	InvalidCycleDuration.Malformed	Specified CycleDuration Format is not valid.	Invalid format of CycleDuration. Check whether the format of the CycleDuration parameter is correct.
400	InvalidSliceDuration.Malformed	Specified SliceDuration Format is not valid.
400	InvalidTemplateLength.Malformed	Specified record template length is not valid.
400	InvalidTemplate.ForbidRaw	Template named raw is Forbidden.
400	MissingTemplate	Template is mandatory for this action.
400	MissingOssObjectPrefix	OssObjectPrefix is mandatory for this action.
400	MissingSliceOssObjectPrefix	SliceOssObjectPrefix is mandatory for this action.
400	InvalidOssObjectPrefix.Malformed	Specified parameter OssObjectPrefix is not valid.
400	InvalidSliceOssObjectPrefix.Malformed	Specified parameter SliceOssObjectPrefix is not valid.
400	ConfigAlreadyExists	Config has already exist.
400	InvalidFormat.IllegalOperation	Specified parameter Format can not be multiple.
400	InvalidDelayTime	Specified Delaytime is invalid.
400	Live2Vod.ConfigAlreadyExists	Had live2vod record config already.
400	InvalidStartTime.Malformed	Specified StartTime is malformed.
400	InvalidEndTime.Malformed	Specified EndTime is malformed.
400	InvalidEndTime.Mismatch	Specified EndTime does not math the specified StartTime or current time.
400	InvalidStartTime.Mismatch	Specified StartTime does not math the current time.
400	Forbidden	Ram Permission is forbidden.
400	InvalidOssEndpoint.Malformed	%s, please check and try again later.	Invalid OssEndpoint, 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.