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

Cria uma configuração de live-to-VOD para armazenar gravações no ApsaraVideo VOD.

Descrição da operação

O armazenamento de gravações no ApsaraVideo VOD aciona operações automáticas como mesclagem e transcodificação de vídeo, que geram taxas de processamento de vídeo dentro do serviço. Para mais detalhes, consulte cobrança de edição de vídeo e cobrança de transcodificação de vídeo. Para perguntas frequentes sobre mesclagem e transcodificação automáticas, consulte as perguntas frequentes sobre live-to-VOD.
Contas do Alibaba Finance Cloud não suportam o recurso live-to-VOD.

Limite de QPS

O limite de QPS para esta API é de 1.000 chamadas por minuto por usuário. Exceder esse limite fará com que as chamadas de API sejam limitadas, o que pode impactar seus negócios. Para evitar limitação, chame a API a uma taxa razoável.

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

create

*Domain

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. O valor de exemplo `cn-shanghai` indica a região China (Xangai).	cn-shanghai
DomainName	string	Sim	O domínio de streaming. Nota Certifique-se de que o ApsaraVideo VOD esteja ativado na mesma região do domínio de streaming.	example.com
AppName	string	Sim	O nome da aplicação à qual o stream pertence. Você pode encontrar esse valor na página de gerenciamento de streams.	testName
StreamName	string	Não	O nome do stream. Você pode encontrar esse valor na página de gerenciamento de streams.	stream
VodTranscodeGroupId	string	Não	Importante Este parâmetro é ignorado se `RecordFormat` for especificado. O ID do grupo de modelos de transcodificação do ApsaraVideo VOD para transcodificar vídeos gravados.	e2d796d3bb5fd8049d32bff62f94****
CycleDuration	integer	Não	A duração do ciclo, em segundos. O valor padrão é 3600. O valor deve estar entre 300 e 21600.	300
AutoCompose	string	Não	Importante Este parâmetro é ignorado se `RecordFormat` for especificado. Especifica se os arquivos de múltiplos ciclos de gravação devem ser mesclados automaticamente em um único arquivo após o término de um live stream. O valor ON ativa a mesclagem automática. Se ativado, você também deve especificar o parâmetro `ComposeVodTranscodeGroupId`. Por padrão, a mesclagem automática está desativada.	ON
SpaceId	string	Não	O ID do espaço de aplicação VOD. Você pode obter esse ID no console do VOD ou chamando uma operação de API para consultar informações da aplicação. Este parâmetro se aplica somente quando o recurso de espaço de aplicação VOD está ativado.	app-1000000
StorageLocation	string	Não	O local de armazenamento.	****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com
ComposeVodTranscodeGroupId	string	Não	Importante Este parâmetro é ignorado se `RecordFormat` for especificado. O ID do grupo de modelos de transcodificação do ApsaraVideo VOD para transcodificar o vídeo mesclado. Este parâmetro é obrigatório se `AutoCompose` estiver definido como `ON`.	*****
OnDemand	integer	Não	O modo de acionamento da gravação. Valores válidos: 0 (Padrão): Gravação automática. 1: Gravação sob demanda acionada por um callback HTTP. 2: Gravação sob demanda acionada por parâmetros de ingestão. 7: Gravação manual. Permite iniciar e parar a gravação chamando a operação `RealTimeRecordCommand`.	0
RecordContent	string	Não	O conteúdo gravado. Valores válidos: `raw` (Padrão): Grava o stream de origem. `transcode`: Grava streams transcodificados. Para gravar tanto streams de origem quanto transcodificados, forneça uma lista separada por vírgulas, por exemplo, `raw,transcode`. Nota Se este parâmetro estiver definido para incluir `transcode`, você deve especificar pelo menos um modelo no parâmetro `TranscodeTemplates`.	raw
DelayTime	integer	Não	O tempo limite de interrupção do stream, em segundos. Se uma interrupção do stream for menor que essa duração, a gravação continua no mesmo arquivo. Se a interrupção for maior, um novo arquivo é criado. Valores válidos: 15 a 21600.	180
RecordFormat	array<object>	Não	Uma lista de configurações de gravação específicas por formato.
	object	Não	A configuração do formato de gravação.
Format	string	Não	O formato de gravação. Valores válidos: `m3u8` `flv` `mp4`	m3u8
SliceDuration	integer	Não	A duração do segmento, em segundos. Este parâmetro se aplica somente ao formato `m3u8`. O valor deve estar entre 5 e 30. O padrão é 30.	30
AutoCompose	string	Não	Especifica se os arquivos de gravação deste formato devem ser mesclados automaticamente após o término do stream. Valores válidos: `ON`: Ativa a mesclagem automática. `OFF`: Desativa a mesclagem automática.	ON
VideoProcess	string	Não	A fonte de vídeo a ser processada. Valores válidos: `origin` (Padrão): Os arquivos de gravação por ciclo. `compose`: O arquivo de vídeo único composto de todos os ciclos. Para processar ambas as fontes de vídeo, separe os valores com uma vírgula (,), por exemplo, `origin,compose`.	origin
ProcessMethod	string	Não	O método de processamento de vídeo. Valores válidos: `transcode`: Usa um grupo de modelos de transcodificação para processar o vídeo. `workflow`: Usa um workflow para processar o vídeo.	transcode
ProcessTemplateId	string	Não	O ID do grupo de modelos de transcodificação ou workflow. Nota O ID especificado deve corresponder ao `ProcessMethod`. Por exemplo, forneça um ID de grupo de modelos de transcodificação se `ProcessMethod` for `transcode`, ou um ID de workflow se `ProcessMethod` for `workflow`.	e2d796d3bb5fd8049d32bff62f94****
Tags	string	Não	As tags para categorização de vídeo.	sports
TranscodeTemplates	array	Não	Uma lista de modelos de transcodificação para gravar streams transcodificados.
	string	Não	O nome do modelo de transcodificação. Você pode especificar até 10 modelos. Se `RecordContent` estiver definido para incluir `transcode`, você deve especificar pelo menos um modelo. Para gravar todos os streams transcodificados disponíveis, especifique o caractere curinga (``) como valor. Por exemplo, `TranscodeTemplates.1=`. Nota O valor `raw` é reservado e não pode ser usado. O `N` em `TranscodeTemplates.N` é um índice que começa em 1 para cada modelo. Por exemplo: `TranscodeTemplates.1=sd` e `TranscodeTemplates.2=hd`.	sd

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	16A96B9A-F203-4EC5-8E43-CB92E68F****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ConfigAlreadyExists	Config has already exist.
400	CommomLiveRcordConfigExisted	Commom liverecord config has already exist.
400	InvalidAutoCompose.Malformed	Specified parameter AutoCompose is not valid.
400	InvalidAutoComposeAndComposeVodTranscodeGroupId.Malformed	Specified parameter AutoCompose and ComposeVodTranscodeGroupId is not valid, must both empty or input
400	InvalidParam	%s.	Parameter verification failed
500	InternalError	The request processing has failed due to backend service exception.
403	InvalidRegion.Conflict	Specified parameter StorageLocation and Region is not match
404	InvalidStorage.NotFound	Specified parameter StorageLocation is not exist
404	InvalidTemplateGroupId.NotFound	Specified parameter vodTranscodeGroupId or composeVodTranscodeGroupId is not exist

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.