ListMediaWorkflowExecutions - - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

Cette opération retourne uniquement les instances d'exécution des 90 derniers jours.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Si le nombre d'appels par seconde dépasse la limite, un mécanisme de limitation du débit se déclenche, ce qui risque d'impacter votre activité. Nous vous recommandons de tenir compte de cette limite lors de vos appels API. Pour plus d'informations, consultez Limites de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération via OpenAPI Explorer. Cet outil 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	ListMediaWorkflowExecutions	Opération à exécuter. Définissez la valeur sur ListMediaWorkflowExecutions.
MediaWorkflowId	String	Non	43b7335a4b1d4fe883670036affb****	ID du workflow multimédia dont vous souhaitez interroger les instances d'exécution. Pour obtenir cet identifiant, connectez-vous à la console ApsaraVideo Media Processing (MPS) et choisissez Workflows > Workflow Settings.
MediaWorkflowName	String	Non	example-mediaworkflow-****	Nom du workflow multimédia. Pour récupérer ce nom, connectez-vous à la console MPS et choisissez Workflows > Workflow Settings.
InputFileURL	String	Non	http://example-.cn-hangzhou.aliyuncs.com/test.flv	URL Object Storage Service (OSS) du fichier d'entrée du workflow multimédia. Cette URL est conforme à la norme RFC 3986 et encodée en UTF-8, avec un encodage en pourcentage des caractères réservés.
NextPageToken	String	Non	39f8e0bc005e4f309379701645f4****	Jeton utilisé pour récupérer la page suivante des résultats de requête. La valeur correspond à un UUID de 32 bits. Lors de la demande de la première page, laissez le paramètre NextPageToken vide. Pour les pages suivantes, spécifiez la valeur NextPageToken retournée dans les résultats de la page précédente.
MaximumPageSize	Long	Non	1	Nombre maximal d'instances d'exécution de workflow multimédia à retourner. Valeurs valides : `[1,100]`. Valeur par défaut : 10.

Paramètres de réponse

Paramètre	Type	Exemple	Description
MediaWorkflowExecutionList	Array of MediaWorkflowExecution		Liste des instances d'exécution du workflow multimédia.
MediaWorkflowExecution
CreationTime	String	2016-04-01T06:53:43Z	Heure de création de l'instance d'exécution.
MediaWorkflowId	String	43b7335a4b1d4fe883670036affb****	ID du workflow multimédia.
State	String	Success	État de l'instance d'exécution. Valeurs valides : running : L'exécution est en cours. Completed : L'exécution est terminée. Remarque La valeur Completed indique que l'instance d'exécution est achevée. Pour vérifier la réussite de chaque activité (Transcode, Snapshot, etc.), consultez l'état spécifique de l'activité concernée. Fail : Échec de l'exécution. Success : Exécution réussie.
ActivityList	Array of Activity		Liste des activités exécutées dans le workflow multimédia.
Activity
EndTime	String	2016-04-01T06:54:00Z	Heure de fin de l'activité.
Type	String	Start	Type d'activité du workflow multimédia. Valeurs valides : Start, Snapshot, Transcode, Analysis et Report. Pour plus d'informations, consultez Activités de workflow multimédia.
StartTime	String	2016-04-01T06:53:45Z	Heure de début de l'activité.
State	String	Success	État de l'activité. Valeurs valides : Running : L'activité est en cours d'exécution. Fail : Échec de l'exécution de l'activité. Skipped : L'activité a été ignorée. Success : L'activité s'est exécutée avec succès. Remarque Par exemple, les activités de transcodage haute définition et définition standard s'exécutent après la fin de l'analyse. Le système détermine l'activité à lancer selon le résultat de cette analyse. Si la définition du contenu vidéo d'entrée est insuffisante, l'activité de transcodage haute définition peut être ignorée.
JobId	String	2376030d9d0849399cd20e20c876****	ID de la tâche générée lors de l'exécution de l'activité. Nous vous conseillons de conserver cet identifiant pour de futurs appels API.
Code	String	null	Code d'erreur retourné. Le code d'erreur spécifique apparaît si l'état de l'activité est Fail. Ce paramètre n'est pas retourné si l'état de l'activité est Success.
Message	String	null	Message d'erreur retourné. Le message d'erreur détaillé apparaît si l'état de l'activité est Fail. Ce paramètre n'est pas retourné si l'état de l'activité est Success.
Name	String	Act-2	Nom de l'activité du workflow multimédia. Remarque Le nom d'une activité au sein d'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 de succès. Ce paramètre n'est pas retourné en cas d'échec de la tâche.
ErrorMessage	String	MessageConfigEmpty	Message d'erreur retourné lors de l'échec de la tâche. Ce paramètre n'est pas retourné si la tâche réussit.
ErrorCode	String	The Topic/Queue config is empty, not send message	Code d'erreur retourné lors de l'échec de la tâche. Ce paramètre n'est pas retourné si la tâche réussit.
Name	String	example-mediaworkflow-****	Nom du workflow multimédia.
Input	Object		Données personnalisées du workflow multimédia.
UserData	String	example data	Données personnalisées.
InputFile	Object		Informations sur l'emplacement de stockage du fichier d'entrée du workflow multimédia dans OSS.
Object	String	example-mediaWorkflow-**/example-object-**/example.mp4	Nom de l'objet OSS utilisé comme fichier d'entrée.
Location	String	cn-shanghai	ID de la région OSS où réside le fichier d'entrée.
Bucket	String	example-bucket-****	Nom du bucket OSS contenant le fichier d'entrée.
MediaId	String	512046582a924698a41e0f8b0d2b****	ID du fichier multimédia. Cet identifiant associe toutes les informations générées par le 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.
NextPageToken	String	39f8e0bc005e4f309379701645f4****	Jeton utilisé pour récupérer la page suivante des résultats de requête.

Exemples

Exemples de requêtes

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>

Exemples de réponses réussies

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

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

Codes d'erreur

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