Todos os produtos
Search
Central de documentação

:QueryPipelineList

Última atualização: Jun 27, 2026

Consulta filas do ApsaraVideo Media Processing (MPS) com base nos IDs das filas.

Observações de uso

  • Esta operação permite consultar até 10 filas do MPS por vez.

  • Se a chamada retornar "Code": "InvalidIdentity.ServiceDisabled","Message": "The request identity was not allowed operated.","Recommend", verifique se o usuário RAM possui a função AliyunMTSDefaultRole para obter as permissões necessárias no MPS e confirme se não há pagamentos pendentes na sua conta Alibaba Cloud.

Limite de QPS

O limite desta operação é de 100 chamadas por segundo por conta. Solicitações que excederem esse limite serão descartadas, causando interrupções no serviço. Considere essa restrição ao utilizar esta operação. Para mais detalhes, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, execute esta operação diretamente no OpenAPI Explorer, que também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

QueryPipelineList

Operação a ser executada. Defina o valor como QueryPipelineList.

PipelineIds

String

Sim

d1ce4d3efcb549419193f50f1fcd**,72dfa5e679ab4be9a3ed9974c736**

IDs das filas do MPS a serem consultadas. Para visualizar os IDs, faça login no MPS console e escolha Global Settings > Pipelines no painel de navegação à esquerda. É possível consultar até 10 filas do MPS simultaneamente. Separe múltiplos IDs de fila com vírgulas (,).

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String 1C538EAA-ACAF-5AD8-B091-A72C63007149

ID da solicitação.

PipelineList Array of Pipeline

Detalhes das filas do MPS.

Pipeline
Speed String Standard

Tipo da fila do MPS. Valor padrão: Standard. Valores válidos:

  • Boost: Fila do MPS com velocidade de transcodificação acelerada
  • Standard: Fila padrão do MPS
  • NarrowBandHDV2: Fila do MPS com suporte a Narrowband HD 2.0
  • AIVideoCover: Fila do MPS para captura inteligente de snapshots
  • AIVideoFPShot: Fila do MPS para fingerprinting de mídia
  • AIVideoCensor: Fila do MPS para revisão automatizada
  • AIVideoMCU: Fila do MPS para tagging inteligente
  • AIVideoSummary: Fila do MPS para sinopse de vídeo
  • AIVideoPorn: Fila do MPS para detecção de pornografia em vídeos
  • AIAudioKWS: Fila do MPS para reconhecimento de palavras-chave em áudio
  • AIAudioASR: Fila do MPS para conversão de fala em texto
State String Paused

Estado da fila do MPS. Valores válidos:

  • Active: A fila do MPS está ativa.
  • Paused: A fila do MPS está pausada.
SpeedLevel Long 2

Nível da fila do MPS.

NotifyConfig Object

Configuração do Message Service (MNS).

MqTopic String example1,example2

Fila de mensagens recebidas.

QueueName String example-queue-****

Nome da fila criada no MNS.

MqTag String mts-test

Tags das mensagens.

Topic String example-topic-****

Nome do tópico criado no MNS.

Role String AliyunMTSDefaultRole

Função atribuída ao usuário RAM atual.

Name String example-pipeline-****

Nome da fila do MPS.

Id String d1ce4d3efcb549419193f50f1fcd****

ID da fila do MPS.

QuotaAllocate Long 10

Cota alocada para a fila do MPS.

NonExistPids Array of String 72dfa5e679ab4be9a3ed9974c736****

IDs das filas do MPS inexistentes. Este parâmetro não é retornado caso todas as filas especificadas sejam encontradas.

Nota Este parâmetro é retornado quando os IDs de fila do MPS especificados são válidos, mas não existem. Verifique se o ID de usuário (UID) usado para enviar a solicitação corresponde ao UID proprietário das filas.

Exemplos

Exemplo de solicitação

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryPipelineList
&PipelineIds=d1ce4d3efcb549419193f50f1fcd****,72dfa5e679ab4be9a3ed9974c736****
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryPipelineListResponse>
    <RequestId>1C538EAA-ACAF-5AD8-B091-A72C63007149</RequestId>
    <PipelineList>
        <Speed>Standard</Speed>
        <State>Paused</State>
        <SpeedLevel>2</SpeedLevel>
        <NotifyConfig>
            <MqTopic>example1,example2</MqTopic>
            <QueueName>example-queue-****</QueueName>
            <MqTag>mts-test</MqTag>
            <Topic>example-topic-****</Topic>
        </NotifyConfig>
        <Role>AliyunMTSDefaultRole</Role>
        <Name>example-pipeline-****</Name>
        <Id>d1ce4d3efcb549419193f50f1fcd****</Id>
        <QuotaAllocate>10</QuotaAllocate>
    </PipelineList>
    <NonExistPids>72dfa5e679ab4be9a3ed9974c736****</NonExistPids>
</QueryPipelineListResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1C538EAA-ACAF-5AD8-B091-A72C63007149",
  "PipelineList" : [ {
    "Speed" : "Standard",
    "State" : "Paused",
    "SpeedLevel" : 2,
    "NotifyConfig" : {
      "MqTopic" : "example1,example2",
      "QueueName" : "example-queue-****",
      "MqTag" : "mts-test",
      "Topic" : "example-topic-****"
    },
    "Role" : "AliyunMTSDefaultRole",
    "Name" : "example-pipeline-****",
    "Id" : "d1ce4d3efcb549419193f50f1fcd****",
    "QuotaAllocate" : 10
  } ],
  "NonExistPids" : [ "72dfa5e679ab4be9a3ed9974c736****" ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.