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

Atualiza uma configuração de live-to-VOD.

Descrição da operação

Esta operação possui um limite de 1.000 chamadas por minuto por conta. Se você exceder esse limite, suas chamadas de API serão limitadas, o que pode interromper o seu 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:UpdateLiveRecordVodConfig

update

*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.	cn-shanghai
DomainName	string	Sim	O domínio de streaming.	example.com
AppName	string	Sim	O nome do aplicativo. Você pode visualizar o `AppName` na página Gerenciamento de Streams.	testName
StreamName	string	Não	O nome do stream. Você pode visualizar o `StreamName` na página Gerenciamento de Streams.	stream
VodTranscodeGroupId	string	Não	Importante Este parâmetro é ignorado se o parâmetro `RecordFormat` for especificado. O ID do grupo de modelos de transcodificação do ApsaraVideo for VOD.	e2d796d3bb5fd8049d32bff62f94****
CycleDuration	integer	Não	A duração de cada arquivo de gravação cíclica, em segundos. Valor padrão: 3600. Valores válidos: 300 a 21600.	300
AutoCompose	string	Não	Importante Este parâmetro é ignorado se o parâmetro `RecordFormat` for especificado. Especifica se a composição automática deve ser ativada. Valores válidos: ON: Ativa a composição automática. Se você definir este valor como ON, também deverá especificar o parâmetro `ComposeVodTranscodeGroupId`.	OFF
ComposeVodTranscodeGroupId	string	Não	Importante Este parâmetro é ignorado se o parâmetro `RecordFormat` for especificado. O ID do grupo de modelos de transcodificação do ApsaraVideo for VOD usado para transcodificar o vídeo após a composição automática. Nota Você pode obter o ID chamando a operação Query Transcoding Configuration List.	*****
OnDemand	integer	Não	O modo de gravação sob demanda. Valores válidos: 0 (padrão): Desativa a gravação sob demanda. 1: Ativa a gravação sob demanda acionada por um callback HTTP. 2: Aciona a gravação analisando os parâmetros de push streaming. 7: Gravação manual. Chame a operação RealTimeRecordCommand para iniciar ou parar a gravação.	0
DelayTime	integer	Não	A duração máxima de uma interrupção de stream, em segundos. Se uma interrupção de stream exceder essa duração, o sistema gerará um novo arquivo. Valores válidos: 15 a 21600.	180
RecordFormat	array<object>	Não	Uma lista de parâmetros para cada formato de gravação.
	object	Não	A configuração para um formato de gravação. Importante Esta operação pode modificar apenas os parâmetros dos formatos de gravação existentes. Você não pode usá-la para adicionar ou remover formatos da configuração. Por exemplo, se a sua configuração incluir `m3u8` e `flv`, você pode atualizar seus parâmetros, mas não adicionar `mp4`.
Format	string	Não	O formato de armazenamento da gravação.	m3u8
SliceDuration	integer	Não	A duração de cada segmento, em segundos. Importante Este parâmetro se aplica apenas ao formato `m3u8`. O valor padrão é 30. Valores válidos: 5 a 30.	30
AutoCompose	string	Não	Especifica se a composição automática deve ser ativada. Valores válidos: `ON`: Ativa a composição automática. `OFF`: Desativa a composição automática.	ON
VideoProcess	string	Não	A fonte de vídeo a ser processada. Valores válidos: `origin` (padrão): Processa o vídeo de origem. `compose`: Processa o vídeo composto. Para processar tanto os vídeos de origem quanto os compostos, 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`: Processa o vídeo usando um grupo de modelos de transcodificação. `workflow`: Processa o vídeo usando um workflow.	transcode
ProcessTemplateId	string	Não	O ID do grupo de modelos de transcodificação ou do workflow. Nota O ID deve corresponder ao método de processamento de vídeo especificado em ProcessMethod. Por exemplo, se ProcessMethod estiver definido como transcode, você deverá usar um ID de grupo de modelos de transcodificação.	e2d796d3bb5fd8049d32bff62f94****
Tags	string	Não	Uma tag para classificação de vídeo.	sports
TranscodeTemplates	array	Não	Uma lista de modelos de transcodificação.
	string	Não	O modelo de transcodificação para gravar um stream transcodificado. Você pode especificar no máximo 10 modelos. Este parâmetro é obrigatório se você gravar streams transcodificados. Para gravar todos os streams transcodificados, defina `TranscodeTemplates.1` como o caractere curinga (``). Nota* O valor `raw` é reservado e não pode ser usado para `TranscodeTemplates`. O `N` em `TranscodeTemplates.N` é um índice para especificar várias configurações. 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.	61C96B9A-F203-4EC5-8E43-CB92E68F67DF

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "61C96B9A-F203-4EC5-8E43-CB92E68F67DF"
}

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.

ApsaraVideo Live:UpdateLiveRecordVodConfig

Descrição da operação

Experimente agora

Autorização RAM

Parâmetros da solicitação

O ID deve corresponder ao método de processamento de vídeo especificado em ProcessMethod. Por exemplo, se ProcessMethod estiver definido como transcode, você deverá usar um ID de grupo de modelos de transcodificação.

O valor `raw` é reservado e não pode ser usado para `TranscodeTemplates`. O `N` em `TranscodeTemplates.N` é um índice para especificar várias configurações. Por exemplo: `TranscodeTemplates.1=sd`, `TranscodeTemplates.2=hd`.

Elementos de resposta

Exemplos

Códigos de erro

Notas de versão

Descrição da operação

Experimente agora

Autorização RAM

Parâmetros da solicitação

O ID deve corresponder ao método de processamento de vídeo especificado em ProcessMethod. Por exemplo, se ProcessMethod estiver definido como transcode, você deverá usar um ID de grupo de modelos de transcodificação.

O valor raw é reservado e não pode ser usado para TranscodeTemplates. O N em TranscodeTemplates.N é um índice para especificar várias configurações. Por exemplo: TranscodeTemplates.1=sd, TranscodeTemplates.2=hd.

Elementos de resposta

Exemplos

Códigos de erro

Notas de versão

O valor `raw` é reservado e não pode ser usado para `TranscodeTemplates`. O `N` em `TranscodeTemplates.N` é um índice para especificar várias configurações. Por exemplo: `TranscodeTemplates.1=sd`, `TranscodeTemplates.2=hd`.