Todos os produtos
Search

Este produto

    ApsaraVideo Live:RestartLivePullToPush

    Central de documentação

    ApsaraVideo Live:RestartLivePullToPush

    Última atualização: Jun 28, 2026

    Reinicia uma tarefa de pulling de stream.

    Descrição da operação

    • Chama esta operação para reiniciar uma tarefa de pulling de stream.

    • Você pode reiniciar uma tarefa que está em execução (incluindo tarefas em status de nova tentativa anormal) ou parada. Uma tarefa em execução é parada e então iniciada novamente. Uma tarefa que não está em execução é iniciada diretamente.

    • Se a tarefa não atingiu o horário de início configurado, a reinicialização não entra em vigor.

    • A tarefa reiniciada é executada com base na configuração de tarefa mais recente, o que causa interrupção na ingestão de stream.

    • Após a reinicialização de uma tarefa de vídeo sob demanda, a reprodução começa do início com base na playlist mais recente. Você pode chamar a operação de atualização para definir o índice do vídeo e o progresso de reprodução do vídeo para retomar a reproduçã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, 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:RestartLivePullToPush

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

    string

    Sim

    O centro de transmissão ao vivo a ser consultado. 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 (Riad).

    preregion
    TaskId

    string

    Sim

    O ID da tarefa.

    6f869419-0692-4fd5-8cf0-66cab659****

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Schema da resposta.

    RequestId

    string

    O ID da solicitação.

    a05e6b15-15af-405b-a4a2-01522450****
    TaskId

    string

    O ID do nó retornado quando você cria a tarefa.

    fb0d4ac7-c7e3-4978-9743-0bf2f6e8****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "a05e6b15-15af-405b-a4a2-01522450****",
  "TaskId": "fb0d4ac7-c7e3-4978-9743-0bf2f6e8****"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidParameter %s. Parameter error
    400 LiveServiceNotFound Your account does not open Live service yet Your account has not yet activated ApsaraVideo Live.
    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.
    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.