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

Observações de uso

Esta operação retorna apenas instâncias de execução dos últimos 90 dias.

Limite de QPS

Você pode chamar esta operação até 100 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, o throttling será acionado e poderá afetar seus negócios. 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 solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListMediaWorkflowExecutions	A operação a ser executada. Defina o valor como ListMediaWorkflowExecutions.
MediaWorkflowId	String	Não	43b7335a4b1d4fe883670036affb****	ID do fluxo de trabalho de mídia cujas instâncias de execução você deseja consultar. Para obter o ID do fluxo de trabalho, faça login no ApsaraVideo Media Processing (MPS) console e escolha Workflows > Workflow Settings.
MediaWorkflowName	String	Não	example-mediaworkflow-****	Nome do fluxo de trabalho de mídia. Para obter o nome do fluxo de trabalho, faça login no MPS console e escolha Workflows > Workflow Settings.
InputFileURL	String	Não	http://example-.cn-hangzhou.aliyuncs.com/test.flv	URL do Object Storage Service (OSS) do arquivo de entrada do fluxo de trabalho de mídia. A URL está em conformidade com a RFC 3986 e usa codificação UTF-8, com caracteres reservados codificados por porcentagem.
NextPageToken	String	Não	39f8e0bc005e4f309379701645f4****	Token usado para recuperar a próxima página dos resultados da consulta. O valor é um UUID de 32 bits. Ao solicitar a primeira página de resultados, deixe o parâmetro NextPageToken vazio. Para solicitar mais resultados, especifique o valor do parâmetro NextPageToken retornado nos resultados da página anterior.
MaximumPageSize	Long	Não	1	Número máximo de instâncias de execução de fluxo de trabalho de mídia a retornar. Valores válidos: `[1,100]`. Valor padrão: 10.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
MediaWorkflowExecutionList	Array of MediaWorkflowExecution		Lista de instâncias de execução do fluxo de trabalho de mídia.
MediaWorkflowExecution
CreationTime	String	2016-04-01T06:53:43Z	Horário de criação da instância de execução.
MediaWorkflowId	String	43b7335a4b1d4fe883670036affb****	ID do fluxo de trabalho de mídia.
State	String	Success	Status da instância de execução. Valores válidos: running: A instância de execução está em andamento. Completed: A instância de execução foi concluída. Nota O valor Completed indica que a instância de execução terminou. Para verificar se cada atividade, como Transcode ou Snapshot, foi bem-sucedida, consulte o status da atividade específica. Fail: A instância de execução falhou. Success: A instância de execução foi bem-sucedida.
ActivityList	Array of Activity		Lista de atividades executadas no fluxo de trabalho de mídia.
Activity
EndTime	String	2016-04-01T06:54:00Z	Horário de término da atividade.
Type	String	Start	Tipo da atividade do fluxo de trabalho de mídia. Valores válidos: Start, Snapshot, Transcode, Analysis e Report. Para mais informações, consulte Atividades de fluxo de trabalho de mídia.
StartTime	String	2016-04-01T06:53:45Z	Horário de início da atividade.
State	String	Success	Status da atividade. Valores válidos: Running: A atividade está em execução. Fail: Falha na execução da atividade. Skipped: A atividade foi ignorada. Success: A atividade foi executada com êxito. Nota Por exemplo, as atividades de transcodificação de alta definição e definição padrão são executadas após a conclusão da atividade de análise. O sistema determina qual atividade executar com base no resultado dessa análise. Se a definição do conteúdo de vídeo de entrada for insuficiente, a atividade de transcodificação de alta definição poderá ser ignorada.
JobId	String	2376030d9d0849399cd20e20c876****	ID do job gerado durante a execução da atividade. Recomendamos salve este ID para chamadas subsequentes de outras operações.
Code	String	null	Código de erro retornado. O código de erro específico aparece se o status da atividade for Fail. Este parâmetro não é retornado se o status da atividade for Success.
Message	String	null	Mensagem de erro retornada. A mensagem de erro detalhada aparece se o status da atividade for Fail. Este parâmetro não é retornado se o status da atividade for Success.
Name	String	Act-2	Nome da atividade do fluxo de trabalho de mídia. Nota O nome de uma atividade 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 de sucesso. Se o job falhar, este parâmetro não será retornado.
ErrorMessage	String	MessageConfigEmpty	Mensagem de erro retornada quando o job falha. Se o job for bem-sucedido, este parâmetro não será retornado.
ErrorCode	String	The Topic/Queue config is empty, not send message	Código de erro retornado quando o job falha. Se o job for bem-sucedido, este parâmetro não será retornado.
Name	String	example-mediaworkflow-****	Nome do fluxo de trabalho de mídia.
Input	Object		Dados personalizados do fluxo de trabalho de mídia.
UserData	String	example data	Dados personalizados.
InputFile	Object		Informações sobre o local de armazenamento do arquivo de entrada do fluxo de trabalho de mídia no OSS.
Object	String	example-mediaWorkflow-**/example-object-**/example.mp4	Nome do objeto do OSS usado como arquivo de entrada.
Location	String	cn-shanghai	ID da região do OSS onde o arquivo de entrada reside.
Bucket	String	example-bucket-****	Nome do bucket do OSS onde o arquivo de entrada está armazenado.
MediaId	String	512046582a924698a41e0f8b0d2b****	ID do arquivo de mídia. Este ID está associado a todas as informações geradas pelo 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.
NextPageToken	String	39f8e0bc005e4f309379701645f4****	Token usado para recuperar a próxima página dos resultados da consulta.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=ListMediaWorkflowExecutions
&MediaWorkflowId=43b7335a4b1d4fe883670036affb****
&MediaWorkflowName=example-mediaworkflow-****
&InputFileURL=http://example-****.cn-hangzhou.aliyuncs.com/test****.flv
&NextPageToken=39f8e0bc005e4f309379701645f4****
&MaximumPageSize=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ListMediaWorkflowExecutionsResponse>
    <MediaWorkflowExecutionList>
        <CreationTime>2016-04-01T06:53:43Z</CreationTime>
        <MediaWorkflowId>43b7335a4b1d4fe883670036affb****</MediaWorkflowId>
        <State>Success</State>
        <ActivityList>
            <EndTime>2016-04-01T06:54:00Z</EndTime>
            <Type>Start</Type>
            <StartTime>2016-04-01T06:53:45Z</StartTime>
            <State>Success</State>
            <JobId>2376030d9d0849399cd20e20c876****</JobId>
            <Code>null</Code>
            <Message>null</Message>
            <Name>Act-2</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>cn-shanghai</Location>
                <Bucket>example-bucket-****</Bucket>
            </InputFile>
        </Input>
        <MediaId>512046582a924698a41e0f8b0d2b****</MediaId>
        <RunId>48e33690ac19445488c706924321****</RunId>
    </MediaWorkflowExecutionList>
    <RequestId>D1D5C080-8E2F-5030-8AB4-13092F17631B</RequestId>
    <NextPageToken>39f8e0bc005e4f309379701645f4****</NextPageToken>
</ListMediaWorkflowExecutionsResponse>

Formato JSON

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

{
  "MediaWorkflowExecutionList" : [ {
    "CreationTime" : "2016-04-01T06:53:43Z",
    "MediaWorkflowId" : "43b7335a4b1d4fe883670036affb****",
    "State" : "Success",
    "ActivityList" : [ {
      "EndTime" : "2016-04-01T06:54:00Z",
      "Type" : "Start",
      "StartTime" : "2016-04-01T06:53:45Z",
      "State" : "Success",
      "JobId" : "2376030d9d0849399cd20e20c876****",
      "Code" : "null",
      "Message" : "null",
      "Name" : "Act-2",
      "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" : "cn-shanghai",
        "Bucket" : "example-bucket-****"
      }
    },
    "MediaId" : "512046582a924698a41e0f8b0d2b****",
    "RunId" : "48e33690ac19445488c706924321****"
  } ],
  "RequestId" : "D1D5C080-8E2F-5030-8AB4-13092F17631B",
  "NextPageToken" : "39f8e0bc005e4f309379701645f4****"
}

Códigos de erro

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