Todos os produtos
Search
Central de documentação

ApsaraVideo Live:InitializeAutoShowListTask

Última atualização: Jul 16, 2026

Cria uma tarefa agendada.

Descrição da operação

Esta operação permite configurar uma tarefa agendada para iniciar e parar uma lista de reprodução em horários especificados. Certifique-se de que os parâmetros estejam definidos corretamente ao chamar esta operação.

Limite de QPS

O limite de QPS por usuário para esta operação é de 10 chamadas por segundo. Se o limite for excedido, a chamada da API será limitada, 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:InitializeAutoShowListTask

none

*Caster.

acs:live:*:{#accountId}:caster/{#CasterId}

Nenhuma 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

ResourceIds

string

Não

A lista de IDs de arquivos de ativos de mídia de vídeo sob demanda na lista de reprodução. Atualmente, apenas arquivos de vídeo MP4 da plataforma de vídeo sob demanda são suportados.

São suportados no máximo três programas. Cada programa é reproduzido na ordem da lista até o EndTime, momento em que a reprodução termina automaticamente. Este parâmetro é obrigatório. Se estiver ausente, um erro MissingParameter será retornado.

Nota

["89e02xxxxfb349axxxxa0c350d**** ","6ae0xxxxxb349axxxxa0c350a****"]

StartTime

integer

Sim

O timestamp de início. Unidade: milissegundos.

1645688994000

EndTime

integer

Sim

O timestamp de término. Unidade: milissegundos.

1645688994000

CasterConfig

string

Sim

A configuração do estúdio de produção. Isso inclui:

  • (Obrigatório) CasterTemplate: a resolução de saída do estúdio de produção.

  • (Opcional) LiveTemplate: a lista de tarefas de transcodificação de saída.

Nota

Uma string formatada em JSON. Use upper camel case (PascalCase) para os nomes dos campos dentro da estrutura.

{"CasterTemplate": "lp_ld","LiveTemplates":["lhd", "lsd","lud"]}

DomainName

string

Sim

O domínio de streaming de saída.

example.aliyundoc.com

CallBackUrl

string

Não

A URL de callback.

http://***.com/callback

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

CasterId

string

O ID do estúdio de produção.

Nota

Este ID pode ser usado como parâmetro de solicitação para consultar URLs de stream do estúdio de produção, iniciar o estúdio de produção, adicionar recursos de vídeo ao estúdio de produção, adicionar layouts ao estúdio de produção, consultar a lista de layouts do estúdio de produção, adicionar componentes ao estúdio de produção e adicionar programas ao estúdio de produção.

b4810848-bcf9-4aef-bd4a-e6bba2d9****

RequestId

string

O ID da solicitação.

16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

StreamList

string

A lista de endereços de saída do estúdio de produção.

  • videoFormat: o formato da URL de streaming.

  • outputStreamUrl: a URL de pull de stream.

  • transcodeConfig: a descrição da resolução de transcodificação da URL de pull de stream.

[{"videoFormat":"flv","outputStreamUrl":"http://example.aliyundoc.com","transcodeConfig":"original"}]

Exemplos

Resposta de sucesso

JSON formato

{
  "CasterId": "b4810848-bcf9-4aef-bd4a-e6bba2d9****",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "StreamList": "[{\"videoFormat\":\"flv\",\"outputStreamUrl\":\"http://example.aliyundoc.com\",\"transcodeConfig\":\"original\"}]"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.PurchaseTime %s, please check and try again later. O parâmetro PurchaseTime é inválido. Verifique e tente novamente.
400 InvalidParameter.ExpireTime %s, please check and try again later. O parâmetro ExpireTime é inválido. Verifique a solicitação e tente novamente.
400 MissingParameter %s. Um parâmetro obrigatório está ausente.
400 InvalidChargeType.Malformed %s, please check and try again later. O parâmetro ChargeType é inválido. Verifique e tente novamente.
400 InvalidChargeType.PostSupport %s, please check and try again later. O ChargeType suporta apenas o modelo pago conforme o uso. Verifique e tente novamente.
400 InvalidCasterTemplate.Malformed %s, please check and try again later. O parâmetro CasterTemplate é inválido. Verifique e tente novamente.
400 InvalidParameter.Malformed There are invalid parameters: %s. O seguinte parâmetro é inválido: %s.
400 InvalidParameter.ChargeType %s, please check and try again later. O parâmetro ChargeType é inválido. Verifique e tente novamente.
400 InvalidPeriod.Malformed %s, please check and try again later. O intervalo de tempo é inválido. Verifique e tente novamente.
400 InvalidClientToken.Malformed %s, please check and try again later. O parâmetro ClientToken é inválido. Verifique e tente novamente.
400 IncorrectCasterStatus %s, please check and try again later. O estúdio de produção está em um estado incorreto. Verifique e tente novamente.
400 InvalidCasterId.Malformed %s, please check and try again later. O parâmetro CasterId é inválido. Verifique o parâmetro e tente novamente.
400 InvalidUserId.Malformed %s, please check userId. O userId especificado é inválido. Verifique o valor do parâmetro.
400 InvalidParameter.StartTime %s, please check and try again later. O parâmetro StartTime é inválido. Verifique e tente novamente.
401 CasterNumberExceed %s, please check and try again later. O número de estúdios de produção excedeu o limite. Verifique o limite e tente novamente.
401 IllegalOperation %s, please check and try again later. A operação é inválida. Verifique a solicitação e tente novamente.
500 InternalError %s, please try again later. Ocorreu um erro interno. Tente novamente mais tarde.
404 IncorrectCasterStatus.EnableChannel %s, please check and try again later. O status do estúdio de produção não suporta a configuração EnableChannel. Verifique o status e tente novamente.
404 InvalidParameter.NormType %s, please check and try again later. O parâmetro NormType é inválido. Verifique e tente novamente.
404 InvalidConfiguration.NotFound %s, please check and try again later. A configuração não existe. Verifique a configuração e tente novamente.
404 InvalidCaster.NotFound %s, please check and try again later. O estúdio de produção não existe. Verifique a configuração e tente novamente.
404 InvalidDomainName.NotFound %s, please check and try again later. O nome de domínio não existe. Verifique o nome de domínio e tente novamente.
408 CreateCaster.Timeout %s, please try again later. A operação CreateCaster expirou. Tente novamente mais tarde.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.