Todos os produtos
Search

Este produto

    ApsaraVideo Live:UpdateLivePullToPush

    Central de documentação

    ApsaraVideo Live:UpdateLivePullToPush

    Última atualização: Jun 28, 2026

    Atualiza uma tarefa de pull e push de fluxo ao chamar UpdateLivePullToPush.

    Descrição da operação

    • Chame esta operação para atualizar uma tarefa de pull e push de fluxo.

    • Se a tarefa não tiver atingido o horário de início configurado, você poderá atualizar o parâmetro Region.

    • Enquanto a tarefa estiver em execução (inclusive durante estados de nova tentativa anormal), apenas CallbackUrl e RepeatTime podem ser atualizados, e as atualizações entram em vigor imediatamente.

    • Se a tarefa estiver parada, todos os parâmetros, exceto Region, poderão ser atualizados.

    Limite de QPS

    O limite de QPS para usuário único desta operação é de 10 chamadas por segundo. Se esse 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:UpdateLivePullToPush

    update

    *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
    TaskId

    string

    Sim

    O ID da tarefa.

    fd245384-4067-4f91-9d75-9666a6bc****
    Region

    string

    Sim

    A região na qual a tarefa é iniciada. Valores válidos:

    • ap-southeast-1 (Singapura)

    • ap-southeast-5 (Indonésia)

    • cn-beijing (Pequim)

    • cn-shanghai (Xangai)

    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
    StartTime

    string

    Não

    O horário de início da tarefa.

    Nota

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

    • Se a tarefa já tiver começado a ser executada, esta atualização não entrará em vigor.

    2024-08-23T15:30:00Z
    EndTime

    string

    Não

    O horário de término da tarefa.

    Nota

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

    • EndTime deve ser posterior a StartTime.

    • EndTime deve ser posterior ao horário atual.

    • Se a tarefa já tiver terminado, esta atualização não entrará em vigor.

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

    array

    Não

    A lista de URLs de fluxo de origem.

    Nota

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

    • Para os tipos vod e url, até 30 URLs podem ser especificadas.

    • 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.

    • Para fluxos de origem ao vivo, a atualização entra em vigor imediatamente. Para fluxos de origem de arquivos de vídeo, a atualização entra em vigor após o término do vídeo atualmente em reprodução, e a reprodução reinicia do início da lista de vídeos atualizada.

    • Atualize este parâmetro enquanto a tarefa estiver parada. A atualização entra em vigor após a tarefa ser reiniciada.

    changedtesturl

    string

    Não

    A URL do fluxo de origem.

    Nota

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

    • Para os tipos vod e url, até 30 URLs podem ser especificadas.

    • 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.

    • Para fluxos de origem ao vivo, a atualização entra em vigor imediatamente. Para fluxos de origem de arquivos de vídeo, a atualização entra em vigor após o término do vídeo atualmente em reprodução, e a reprodução reinicia do início da lista de vídeos atualizada.

    • Atualize este parâmetro enquanto a tarefa estiver parada. A atualização entra em vigor após a tarefa ser reiniciada.

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

    integer

    Não

    O número de vezes que a reprodução se repete após o término da lista de reprodução. Valores válidos:

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

    • -1: repetir indefinidamente.

    • Outros inteiros positivos: o número de vezes que a reprodução se repete após o término da lista de reprodução.

    Nota

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

    • A atualização entra em vigor imediatamente.

    0
    Offset

    integer

    Não

    O deslocamento inicial do arquivo de vídeo, em segundos. O valor deve ser maior que 0.

    Nota

    • Especifica a posição em relação ao primeiro quadro a partir da qual iniciar a leitura.

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

    • Este parâmetro entra em vigor apenas quando o primeiro vídeo da lista de reprodução é reproduzido.

    • Atualize este parâmetro enquanto a tarefa estiver parada. A atualização entra em vigor após a tarefa ser reiniciada.

    2
    CallbackUrl

    string

    Não

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

    Nota

    • A URL que recebe callbacks relacionados à tarefa.

    • Comprimento máximo: 2000 caracteres.

    • Se este parâmetro não for especificado, os eventos da tarefa não serão enviados como callbacks.

    • A atualização entra em vigor quando o próximo evento for acionado.

    https://callback*****.com
    FileIndex

    integer

    Não

    O índice de vídeo. Valor padrão: 0.

    Nota

    Atualize este parâmetro enquanto a tarefa estiver parada. A atualização entra em vigor após a tarefa ser reiniciada.

    0

    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

    • O valor "0" é retornado se a chamada for bem-sucedida.

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

    0
    Description

    string

    A descrição do erro.

    OK

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK"
}

    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 CodeTaskNotExist Task does not exist. The task does not exist.
    400 CodeTaskHasStarted The task has already started. The task has already started and cannot be updated.
    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.