Todos os produtos
Search

Este produto

    ApsaraVideo Live:CreateLivePullToPush

    Central de documentação

    ApsaraVideo Live:CreateLivePullToPush

    Última atualização: Jun 28, 2026

    Cria uma tarefa de pull-to-push.

    Descrição da operação

    Importante O recurso de pull-to-push é pago. A cobrança começa oficialmente a partir das 00:00 de 5 de dezembro de 2025.

    • Para detalhes de preços, consulte Preços do pull-to-push.

    • Chame esta operação para criar uma tarefa de pull-to-push.

    • Suporta a criação de tarefas de pull de transmissão ao vivo e tarefas de pull de VOD.

    • Após a criação de uma tarefa, ela começa a ser executada no horário de início especificado e é interrompida e excluída automaticamente no horário de término especificado.

    • A URL de destino de push especificada na tarefa não deve ser usada por outras tarefas. Caso contrário, várias tarefas fazendo push para a mesma URL simultaneamente causarão falhas de push.

    • Os eventos de callback de pull-to-push incluem callbacks de alteração de status de execução da tarefa e callbacks de saída da tarefa. Para mais informações, consulte Callbacks de eventos de pull-to-push.

    Limite de QPS

    O limite de QPS para usuário único desta operação é de 10 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Chame esta operação de forma adequada.

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

    create

    *All Resource

    *

    		 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-beijing
    Region

    string

    Sim

    Especifica a região onde a tarefa é iniciada. Valores válidos:

    • ap-southeast-1 (Singapura)

    • ap-southeast-5 (Indonésia)

    • cn-beijing (Pequim)

    • cn-shanghai (Xangai)

    • cn-shenzhen (Shenzhen)

    Valores válidos:

    • cn-shenzhen :

      Shenzhen.

    • cn-qingdao :

      Qingdao.

    • preregion :

      Pré-lançamento.

    • cn-beijing :

      Pequim.

    • cn-shanghai :

      Xangai.

    • ap-southeast-1 :

      Singapura.

    • eu-central-1 :

      Alemanha - Frankfurt.

    • ap-northeast-1 :

      Japão - Tóquio.

    • ap-southeast-5 :

      Indonésia.

    • me-central-1 :

      Arábia Saudita - Riade.

    cn-shanghai
    TaskName

    string

    Não

    O nome da tarefa, usado para suportar consultas difusas. Valor padrão: "".

    test
    StartTime

    string

    Sim

    O horário de início da tarefa.

    Nota

    • Formato: yyyy-MM-ddTHH:mm:ssZ (horário UTC).

    2024-08-26T10:30:00Z
    EndTime

    string

    Sim

    O horário de término da tarefa.

    Nota

    • Formato: yyyy-MM-ddTHH:mm:ssZ (horário UTC).

    • O EndTime deve ser posterior ao StartTime.

    • O EndTime deve ser posterior ao horário atual.

    2024-08-27T14:30:00Z
    SourceType

    string

    Sim

    O tipo de fluxo de origem. Valores válidos:

    • live: transmissão ao vivo.

    • vod: recurso do ApsaraVideo VOD.

    • url: recurso de arquivo de vídeo de terceiros.

    Valores válidos:

    • vod :

      Recurso do ApsaraVideo VOD.

    • live :

      Transmissão ao vivo.

    • url :

      Recurso de arquivo de vídeo de terceiros.

    live
    SourceProtocol

    string

    Não

    O nome do protocolo do fluxo de origem.

    Valores válidos:

    • rtmp

    • srt

    • http-flv

    • hls

    Nota

    Este parâmetro é obrigatório apenas quando o parâmetro SourceType está definido como live, e é inválido quando o valor é vod ou url.

    rtmp
    SourceUrls

    array

    Sim

    A lista de endereços URL do fluxo de origem.

    Nota

    • Para o tipo live, apenas uma URL completa de reprodução ao vivo é suportada.

    • Para os tipos vod e url, podem ser especificadas no máximo 30 URLs.

    • O tipo live suporta os protocolos: rtmp, srt e http-flv.

    • Para o tipo vod, especifique os IDs de ativos de mídia do ApsaraVideo VOD.

    • O tipo url suporta os protocolos: mp4 e http-flv.

    string

    Não

    O endereço URL do fluxo de origem.

    Nota

    • Para o tipo live, apenas uma URL completa de reprodução ao vivo é suportada.

    • Para os tipos vod e url, podem ser especificadas no máximo 30 URLs.

    • O tipo live suporta os protocolos: rtmp, srt e http-flv.

    • Para o tipo vod, especifique os IDs de ativos de mídia do ApsaraVideo VOD.

    • O tipo url suporta os protocolos: mp4 e http-flv.

    rtmp://pulltest.****.aliyunlive.com/pulltest493/pulltest-w434
    DstUrl

    string

    Sim

    O endereço URL de destino para o push do fluxo.

    Nota

    • O protocolo rtmp é suportado.

    • O comprimento máximo é de 2000 caracteres.

    rtmp://pushtest.********.aliyunlive.com/pulltest493/pulltest-w434
    RepeatNumber

    integer

    Não

    O número de vezes para repetir a reprodução após a conclusão da reprodução inicial. Valores válidos:

    • 0 (padrão): sem repetição de reprodução.

    • -1: repetir indefinidamente.

    • Outros inteiros positivos: número de vezes para repetir a reprodução após a conclusão da reprodução inicial.

    Nota

    Este parâmetro se aplica apenas a fluxos de vídeo VOD ou de terceiros.

    0
    FileIndex

    integer

    Não

    O índice do arquivo. Inicia a reprodução a partir do enésimo arquivo.

    0
    Offset

    integer

    Não

    O deslocamento inicial. O valor de deslocamento a partir do início do arquivo de vídeo. Unidade: segundos. Valores válidos: maior que 0.

    Nota

    • Indica a posição a partir da qual começar a ler, em relação ao primeiro quadro (aplica-se ao primeiro vídeo).

    • Este parâmetro se aplica apenas a fluxos de vídeo VOD ou de terceiros.

    2
    CallbackUrl

    string

    Não

    A URL de callback HTTP. Valor padrão: vazio.

    Nota

    • A URL que recebe callbacks relacionados à tarefa.

    • O comprimento máximo é de 2000 caracteres.

    • Se este parâmetro não for especificado, nenhum callback de evento de tarefa será enviado.

    https://callback*****.com
    RetryInterval

    integer

    Não

    O intervalo de nova tentativa, em segundos. Valores válidos: [60, 300]. Valor padrão: 60 segundos.

    60
    RetryCount

    integer

    Não

    O número de novas tentativas. Valor padrão: 3.

    3

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Esquema da resposta.

    RequestId

    string

    O ID da solicitação.

    16A96B9A-F203-4EC5-8E43-CB92E68*****
    RetCode

    integer

    O código de retorno.

    Nota

    • "0" é retornado em condições normais.

    • Para condições anormais, consulte a lista de códigos de erro abaixo.

    0
    Description

    string

    A descrição do erro.

    OK
    TaskId

    string

    O ID da tarefa.

    fd245384-4067-4f91-9d75-9666a6bc9****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK",
  "TaskId": "fd245384-4067-4f91-9d75-9666a6bc9****"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidParameter %s. Parameter error
    400 InvalidParam.CodeIllegalDuration %s. The value of start time should be less than the value of end time .
    400 CodeInvalidAliUid This aliuid does not have a live domain name. This aluid does not have a live domain name.
    400 CodeNotEnoughResource Exceeded configuration limits or insufficient resources. Exceeded configuration limits or insufficient resources
    400 CodeConfigAlreadyExists Code Config Already Exists
    500 InternalError %s. error on the live liveapi server.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.