QueryMediaWorkflowExecutionList - - Centre de documentation Alibaba Cloud

Description

Cette opération permet d'interroger jusqu'à 10 instances d'exécution de workflow multimédia à la fois.
Avant d'appeler cette opération, assurez-vous que le pipeline de workflow est activé. Sinon, le workflow risque de ne pas s'exécuter correctement. Par exemple, un nœud de workflow invalide peut empêcher l'exécution des tâches créées dans le workflow.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limite QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	QueryMediaWorkflowExecutionList	Nom de l'opération. Définissez la valeur sur QueryMediaWorkflowExecutionList.
RunIds	String	Oui	48e33690ac19445488c706924321****	ID des instances d'exécution de workflow multimédia. Pour obtenir l'ID d'instance, connectez-vous à la console ApsaraVideo Media Processing (MPS) et choisissez Workflows > Execution Instances dans le volet de navigation de gauche. Séparez les plusieurs ID par des virgules (,). Vous pouvez interroger jusqu'à 10 instances d'exécution de workflow multimédia à la fois.

Paramètres de réponse

Paramètre	Type	Exemple	Description
NonExistRunIds	Array of String	null	ID des instances d'exécution inexistantes. La valeur null est renvoyée si toutes les instances d'exécution spécifiées existent.
MediaWorkflowExecutionList	Array of MediaWorkflowExecution		Détails des workflows multimédias.
MediaWorkflowExecution
CreationTime	String	016-04-01T06:53:43Z	Date de création du workflow multimédia.
MediaWorkflowId	String	93ab850b4f6f44eab54b6e91****81d4	ID du workflow multimédia.
State	String	Completed	État du workflow multimédia. Valeurs valides : Running : le workflow multimédia est en cours d'exécution. Completed : le workflow multimédia est terminé. Remarque La valeur Completed indique uniquement que le workflow multimédia est terminé. Consultez l'état de chaque activité du workflow, telles que les activités de transcodage et de capture d'écran, pour vérifier si elles ont été exécutées. Fail : échec du workflow multimédia.
ActivityList	Array of Activity		Activités appelées dans le workflow multimédia.
Activity
EndTime	String	2016-04-01T06:53:44Z	Heure de fin de l'activité.
Type	String	Start	Types d'activités pris en charge dans le workflow multimédia. Valeurs valides : Start, Snapshot, Transcode, Analysis et Report. Pour plus d'informations, consultez la rubrique Activités prises en charge pour les workflows multimédias.
StartTime	String	2016-04-01T06:53:44Z	Heure de début de l'activité.
State	String	Running	État de l'activité. Valeurs valides : Running : l'activité est en cours d'exécution. Success : l'activité a réussi. Fail : échec de l'activité. Skipped : l'activité a été ignorée. Remarque Par exemple, une fois l'analyse terminée, l'activité de transcodage est appelée et des tâches de transcodage haute définition et définition standard sont créées. Le système détermine s'il faut exécuter les tâches en fonction du résultat de l'analyse. Si la résolution de la vidéo d'entrée est faible, la tâche de transcodage haute définition peut être ignorée.
JobId	String	2376030d9d0849399cd20e20f4f3****	ID des tâches générées lors de l'exécution des activités. Par exemple, les ID de tâche pour les activités d'analyse, de transcodage et de capture d'écran.
Code	String	InvalidParameter.ResourceContentBad	Code d'erreur renvoyé en cas d'échec de l'activité. Ce paramètre est renvoyé uniquement lorsque la valeur Fail est renvoyée pour le paramètre State.
Message	String	The resource operated InputFile is bad	Message d'erreur renvoyé en cas d'échec de l'activité. Ce paramètre est renvoyé uniquement lorsque la valeur Fail est renvoyée pour le paramètre State.
Name	String	Start	Nom de l'activité. Remarque Le nom de chaque activité dans un workflow multimédia est unique.
MNSMessageResult	Object		Message envoyé par Message Service (MNS) pour notifier l'utilisateur du résultat de la tâche.
MessageId	String	4f3bc83233de4e2f81c7dade443e****	ID du message indiquant que le message MNS a été envoyé. Ce paramètre n'est pas renvoyé si l'envoi du message MNS échoue.
ErrorMessage	String	MessageConfigEmpty	Message d'erreur renvoyé en cas d'échec de l'envoi du message MNS. Ce paramètre n'est pas renvoyé si le message MNS est envoyé.
ErrorCode	String	The Topic/Queue config is empty, not send message	Code d'erreur renvoyé en cas d'échec de l'envoi du message MNS. Ce paramètre n'est pas renvoyé si le message MNS est envoyé.
Name	String	example-mediaworkflow-****	Nom du workflow multimédia.
Input	Object		Données d'entrée du workflow multimédia.
UserData	String	example data ****	Données personnalisées.
InputFile	Object		Fichier d'entrée du workflow multimédia.
Object	String	example-mediaWorkflow-**/example-object-**/example.mp4	Nom de l'objet Object Storage Service (OSS) utilisé comme fichier d'entrée.
Location	String	mps-cn-shanghai	ID de la région où se trouve le fichier d'entrée.
Bucket	String	example-bucket-****	Nom du bucket OSS dans lequel le fichier d'entrée est stocké.
MediaId	String	512046582a924698a41e0f8b0d2b****	ID du fichier multimédia. Un fichier multimédia contient toutes les informations relatives à un workflow multimédia.
RunId	String	48e33690ac19445488c706924321****	ID de l'instance d'exécution.
RequestId	String	D1D5C080-8E2F-5030-8AB4-13092F17631B	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

Format 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"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.