QueryMediaWorkflowExecutionList - : Central de Documentação do Alibaba Cloud

Descrição

Esta operação permite consultar até 10 instâncias de execução de fluxo de trabalho de mídia por vez.
Antes de chamar esta operação, verifique se o pipeline do fluxo de trabalho está ativado. Caso contrário, o fluxo pode não ser executado conforme o esperado. Por exemplo, podem ocorrer exceções como: nó de fluxo de trabalho inválido e impossibilidade de executar jobs criados no fluxo.

Limite de QPS

O limite para esta operação é de 100 chamadas por segundo. Solicitações que excedem esse limite são descartadas, o que pode causar interrupções no serviço. Recomendamos observar essa restrição ao utilizar a operação. Para mais informações, consulte Limite 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 solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	QueryMediaWorkflowExecutionList	A operação a ser executada. Defina o valor como QueryMediaWorkflowExecutionList.
RunIds	String	Sim	48e33690ac19445488c706924321****	Os IDs das instâncias de execução do fluxo de trabalho de mídia. Para obter o ID da instância, faça login no ApsaraVideo Media Processing (MPS) console e escolha Workflows > Execution Instances no painel de navegação à esquerda. Separe vários IDs com vírgulas (,). É possível consultar no máximo 10 instâncias de execução de fluxo de trabalho de mídia por vez.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NonExistRunIds	Array of String	null	IDs das instâncias de execução inexistentes. O valor null é retornado se todas as instâncias especificadas existirem.
MediaWorkflowExecutionList	Array of MediaWorkflowExecution		Detalhes dos fluxos de trabalho de mídia.
MediaWorkflowExecution
CreationTime	String	016-04-01T06:53:43Z	Horário de criação do fluxo de trabalho de mídia.
MediaWorkflowId	String	93ab850b4f6f44eab54b6e91****81d4	ID do fluxo de trabalho de mídia.
State	String	Completed	Status do fluxo de trabalho de mídia. Valores válidos: Running: O fluxo de trabalho de mídia está em execução. Completed: O fluxo de trabalho de mídia foi concluído. Nota Completed indica apenas que o fluxo de trabalho de mídia terminou. Visualize o status de cada método no fluxo, como os métodos de transcodificação e snapshot, para verificar se o método foi chamado. Fail: O fluxo de trabalho de mídia falhou.
ActivityList	Array of Activity		Métodos chamados no fluxo de trabalho de mídia.
Activity
EndTime	String	2016-04-01T06:53:44Z	Horário de término do método.
Type	String	Start	Métodos suportados no fluxo de trabalho de mídia. Valores válidos: Start, Snapshot, Transcode, Analysis e Report. Para mais informações, consulte Métodos suportados para fluxos de trabalho de mídia.
StartTime	String	2016-04-01T06:53:44Z	Horário em que o método é chamado.
State	String	Running	Status do método. Valores válidos: Running: O método está em execução. Success: O método foi chamado com sucesso. Fail: Falha na chamada do método. Skipped: O método foi ignorado. Nota Por exemplo, após a conclusão da análise, o sistema chama o método de transcodificação e cria jobs de transcodificação de alta definição e definição padrão. O sistema determina a execução dos jobs com base no resultado da análise. Se a resolução do vídeo de entrada for baixa, o job de transcodificação de alta definição poderá ser ignorado.
JobId	String	2376030d9d0849399cd20e20f4f3****	IDs dos jobs gerados durante a chamada dos métodos. Por exemplo, IDs de job para os métodos de análise, transcodificação e snapshot.
Code	String	InvalidParameter.ResourceContentBad	Código de erro retornado quando há falha na chamada do método. Este parâmetro é retornado apenas quando o parâmetro State retorna Fail.
Message	String	The resource operated InputFile is bad	Mensagem de erro retornada quando há falha na chamada do método. Este parâmetro é retornado apenas quando o parâmetro State retorna Fail.
Name	String	Start	Nome do método. Nota O nome de cada método em um fluxo de trabalho de mídia é único.
MNSMessageResult	Object		Mensagem enviada pelo Message Service (MNS) para notificar o usuário sobre o resultado do job.
MessageId	String	4f3bc83233de4e2f81c7dade443e****	ID da mensagem que indica o envio da mensagem MNS. Este parâmetro não é retornado se o envio da mensagem MNS falhar.
ErrorMessage	String	MessageConfigEmpty	Mensagem de erro retornada quando o envio da mensagem MNS falha. Este parâmetro não é retornado se a mensagem MNS for enviada com sucesso.
ErrorCode	String	The Topic/Queue config is empty, not send message	Código de erro retornado quando o envio da mensagem MNS falha. Este parâmetro não é retornado se a mensagem MNS for enviada com sucesso.
Name	String	example-mediaworkflow-****	Nome do fluxo de trabalho de mídia.
Input	Object		Dados de entrada do fluxo de trabalho de mídia.
UserData	String	example data ****	Dados personalizados.
InputFile	Object		Arquivo de entrada do fluxo de trabalho de mídia.
Object	String	example-mediaWorkflow-**/example-object-**/example.mp4	Nome do objeto do Object Storage Service (OSS) usado como arquivo de entrada.
Location	String	mps-cn-shanghai	ID da região onde o arquivo de entrada reside.
Bucket	String	example-bucket-****	Nome do bucket OSS onde o arquivo de entrada está armazenado.
MediaId	String	512046582a924698a41e0f8b0d2b****	ID do arquivo de mídia. Um arquivo de mídia contém todas as informações sobre um fluxo de trabalho de mídia.
RunId	String	48e33690ac19445488c706924321****	ID da instância de execução.
RequestId	String	D1D5C080-8E2F-5030-8AB4-13092F17631B	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaWorkflowExecutionList
&RunIds=48e33690ac19445488c706924321****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<QueryMediaWorkflowExecutionListResponse>
    <NonExistRunIds>null</NonExistRunIds>
    <MediaWorkflowExecutionList>
        <CreationTime>016-04-01T06:53:43Z</CreationTime>
        <MediaWorkflowId>93ab850b4f6f44eab54b6e91****81d4</MediaWorkflowId>
        <State>Completed</State>
        <ActivityList>
            <EndTime>2016-04-01T06:53:44Z</EndTime>
            <Type>Start</Type>
            <StartTime>2016-04-01T06:53:44Z</StartTime>
            <State>Running</State>
            <JobId>2376030d9d0849399cd20e20f4f3****</JobId>
            <Code>InvalidParameter.ResourceContentBad</Code>
            <Message>The resource operated InputFile is bad</Message>
            <Name>Start</Name>
            <MNSMessageResult>
                <MessageId>4f3bc83233de4e2f81c7dade443e****</MessageId>
                <ErrorMessage>MessageConfigEmpty</ErrorMessage>
                <ErrorCode>The Topic/Queue config is empty, not send message</ErrorCode>
            </MNSMessageResult>
        </ActivityList>
        <Name>example-mediaworkflow-****</Name>
        <Input>
            <UserData>example data ****</UserData>
            <InputFile>
                <Object>example-mediaWorkflow-****/example-object-****/example.mp4</Object>
                <Location>mps-cn-shanghai</Location>
                <Bucket>example-bucket-****</Bucket>
            </InputFile>
        </Input>
        <MediaId>512046582a924698a41e0f8b0d2b****</MediaId>
        <RunId>48e33690ac19445488c706924321****</RunId>
    </MediaWorkflowExecutionList>
    <RequestId>D1D5C080-8E2F-5030-8AB4-13092F17631B</RequestId>
</QueryMediaWorkflowExecutionListResponse>

Formato JSON

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

{
  "NonExistRunIds" : [ "null" ],
  "MediaWorkflowExecutionList" : [ {
    "CreationTime" : "016-04-01T06:53:43Z",
    "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91****81d4",
    "State" : "Completed",
    "ActivityList" : [ {
      "EndTime" : "2016-04-01T06:53:44Z",
      "Type" : "Start",
      "StartTime" : "2016-04-01T06:53:44Z",
      "State" : "Running",
      "JobId" : "2376030d9d0849399cd20e20f4f3****",
      "Code" : "InvalidParameter.ResourceContentBad",
      "Message" : "The resource operated InputFile is bad",
      "Name" : "Start",
      "MNSMessageResult" : {
        "MessageId" : "4f3bc83233de4e2f81c7dade443e****",
        "ErrorMessage" : "MessageConfigEmpty",
        "ErrorCode" : "The Topic/Queue config is empty, not send message"
      }
    } ],
    "Name" : "example-mediaworkflow-****",
    "Input" : {
      "UserData" : "example data ****",
      "InputFile" : {
        "Object" : "example-mediaWorkflow-****/example-object-****/example.mp4",
        "Location" : "mps-cn-shanghai",
        "Bucket" : "example-bucket-****"
      }
    },
    "MediaId" : "512046582a924698a41e0f8b0d2b****",
    "RunId" : "48e33690ac19445488c706924321****"
  } ],
  "RequestId" : "D1D5C080-8E2F-5030-8AB4-13092F17631B"
}

Códigos de erro

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