Todos os produtos
Search
Central de documentação

:SearchPipeline

Última atualização: Jun 27, 2026

Consulta filas do ApsaraVideo Media Processing (MPS) no estado especificado.

Observações de uso

Use esta operação para consultar filas do MPS em um estado específico. Se você não especificar o estado, o sistema consultará todas as filas do MPS por padrão.

Limites de QPS

Você pode chamar esta operação até 100 vezes por segundo. Se o número de chamadas por segundo exceder o limite, o throttling será acionado e seus negócios poderão ser afetados. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limites de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da requisição

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim SearchPipeline

A operação a ser executada. Defina o valor como SearchPipeline.

PageSize Long Não 10

Número de entradas a retornar em cada página.

  • Máximo de 100 entradas por página.
  • Valor padrão: 10.
PageNumber Long Não 1

Número da página a retornar. Valor padrão: 1.

State String Não Paused

Status das filas do MPS a consultar. Se este parâmetro estiver vazio, todas as filas serão consultadas.

  • All: consulta todas as filas do MPS.
  • Active: consulta as filas ativas do MPS.
  • Paused: consulta as filas pausadas do MPS.
  • Valor padrão: All.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
TotalCount Long 1

Número total de entradas retornadas.

PageSize Long 10

Número de entradas retornadas por página.

RequestId String 338CA33A-AE83-5DF4-B6F2-C6D3ED8143F5

ID da requisição.

PageNumber Long 1

Número da página retornada.

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 compatível com 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

Status da fila. Valores válidos:

  • Active: a fila do MPS está ativa.
  • Paused: a fila do MPS está pausada.
NotifyConfig Object

Configuração de notificação do MNS.

QueueName String example-queue-****

Nome da fila criada no MNS.

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.

Exemplos

Exemplos de requisições

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SearchPipeline
&PageSize=10
&PageNumber=1
&State=Paused
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<SearchPipelineResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>338CA33A-AE83-5DF4-B6F2-C6D3ED8143F5</RequestId>
    <PageNumber>1</PageNumber>
    <PipelineList>
        <Speed>Standard</Speed>
        <State>Paused</State>
        <NotifyConfig>
            <QueueName>example-queue-****</QueueName>
            <Topic>example-topic-****</Topic>
        </NotifyConfig>
        <Role>AliyunMTSDefaultRole</Role>
        <Name>example-pipeline-****</Name>
        <Id>d1ce4d3efcb549419193f50f1fcd****</Id>
    </PipelineList>
</SearchPipelineResponse>

Formato JSON

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

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "338CA33A-AE83-5DF4-B6F2-C6D3ED8143F5",
  "PageNumber" : 1,
  "PipelineList" : [ {
    "Speed" : "Standard",
    "State" : "Paused",
    "NotifyConfig" : {
      "QueueName" : "example-queue-****",
      "Topic" : "example-topic-****"
    },
    "Role" : "AliyunMTSDefaultRole",
    "Name" : "example-pipeline-****",
    "Id" : "d1ce4d3efcb549419193f50f1fcd****"
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.