AddMediaWorkflow - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération permet de définir la topologie, les activités et les dépendances d'un workflow multimédia. La topologie est représentée par un graphe orienté acyclique (DAG) dans la console. Pour plus d'informations, consultez la rubrique Activités de workflow multimédia. Vous pouvez afficher et exécuter les workflows créés via cette opération dans la console ApsaraVideo Media Processing (MPS).

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation (throttling) se déclenche et peut affecter votre activité. Tenez compte de cette limite lorsque vous appelez 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

Parameter	Type	Required	Example	Description
Action	String	Yes	AddMediaWorkflow	Opération à effectuer. Définissez la valeur sur AddMediaWorkflow.
Name	String	Yes	mediaworkflow-example	Nom du workflow multimédia. La valeur ne peut pas être vide. Le nom doit être unique au sein du compte Alibaba Cloud. Le nom peut comporter jusqu'à 64 caractères. Le nom ne peut contenir que des caractères UTF-8.
Topology	String	Yes	null	Topologie du workflow multimédia. La valeur doit être un objet JSON contenant la liste des activités et leurs dépendances. Pour plus d'informations, consultez la section Exemple de topologie de cette rubrique.
TriggerMode	String	No	OssAutoTrigger	Mode de déclenchement du workflow multimédia. Valeurs possibles : OssAutoTrigger : Le workflow multimédia est déclenché automatiquement. NotInAuto : Le workflow multimédia n'est pas déclenché automatiquement.

Exemple de topologie


{
  "Activities": {
    "Act-Transcode-M3U8": {
      "Parameters": {
        "Outputs": [
          {
            "OutputObject": "transcode%2F%7BObjectPrefix%7D%7BFileName%7D",
            "TemplateId": "957d1719ee85ed6527b90cf62726****"
          }
        ],
        "OutputBucket": "example-vod-hls",
        "OutputLocation": "oss-cn-hangzhou"
      },
      "Type": "Transcode"
    },
    "Act-Start": {
      "Name": "Act-Start",
      "Parameters": {
        "PipelineId": "130266f58161436a80bf07cb12c8****",
        "InputFile": {
          "Bucket": "example-vod",
          "Location": "oss-cn-hangzhou"
        }
      },
      "Type": "Start"
    },
    "Act-Report": {
      "Name": "Act-Report",
      "Parameters": {
      },
      "Type": "Report"
    }
  },
  "Dependencies": {
    "Act-Transcode-M3U8": [
      "Act-Report"
    ],
    "Act-Start": [
      "Act-Transcode-M3U8"
    ],
    "Act-Report": [
    ]
  }
}

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	F1D21261-ADB9-406A-1234-491382139D59	ID de la requête.
MediaWorkflow	Object		Informations relatives au workflow multimédia.
CreationTime	String	016-04-01T05:29:37Z	Date de création du workflow multimédia.
MediaWorkflowId	String	e00732b977da427d9177a4deb1aa****	ID du workflow multimédia. Conservez cet ID pour les opérations ultérieures sur ce workflow.
State	String	Active	État du workflow multimédia. Par défaut, le workflow créé est à l'état Active.
TriggerMode	String	OssAutoTrigger	Mode de déclenchement du workflow multimédia. Valeurs possibles : OssAutoTrigger : Le workflow multimédia est déclenché automatiquement. NotInAuto : Le workflow multimédia n'est pas déclenché automatiquement.
Name	String	mediaworkflow-example	Nom du workflow multimédia.
Topology	String	null	Topologie du workflow multimédia. La valeur est un objet JSON contenant la liste des activités et leurs dépendances.

Exemples

Exemple de requête

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=AddMediaWorkflow
&Name=mediaworkflow-example
&Topology={"Activities":{"Act-Transcode-M3U8":{"Parameters":{"Outputs":[{"OutputObject":"transcode%2F%7BObjectPrefix%7D%7BFileName%7D","TemplateId":"957d1719ee85ed6527b90cf62726****"}],"OutputBucket":"example-vod-hls","OutputLocation":"oss-cn-hangzhou"},"Type":"Transcode"},"Act-Start":{"Name":"Act-Start","Parameters":{"PipelineId":"130266f58161436a80bf07cb12c8****","InputFile":{"Bucket":"example-vod","Location":"oss-cn-hangzhou"}},"Type":"Start"},"Act-Report":{"Name":"Act-Report","Parameters":{},"Type":"Report"}},"Dependencies":{"Act-Transcode-M3U8":["Act-Report"],"Act-Start":["Act-Transcode-M3U8"],"Act-Report":[]}}
&TriggerMode=OssAutoTrigger
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<AddMediaWorkflowResponse>
    <RequestId>F1D21261-ADB9-406A-1234-491382139D59</RequestId>
    <MediaWorkflow>
        <CreationTime>016-04-01T05:29:37Z</CreationTime>
        <MediaWorkflowId>e00732b977da427d9177a4deb1aa****</MediaWorkflowId>
        <State>Active</State>
        <TriggerMode>OssAutoTrigger</TriggerMode>
        <Name>mediaworkflow-example</Name>
        <Topology>{"Activities":{"Act-Transcode-M3U8":{"Parameters":{"Outputs":[{"OutputObject":"transcode%2F%7BObjectPrefix%7D%7BFileName%7D","TemplateId":"957d1719ee85ed6527b90cf62726****"}],"OutputBucket":"example-vod-hls","OutputLocation":"oss-cn-hangzhou"},"Type":"Transcode"},"Act-Start":{"Name":"Act-Start","Parameters":{"PipelineId":"130266f58161436a80bf07cb12c8****","InputFile":{"Bucket":"example-vod","Location":"oss-cn-hangzhou"}},"Type":"Start"},"Act-Report":{"Name":"Act-Report","Parameters":{},"Type":"Report"}},"Dependencies":{"Act-Transcode-M3U8":["Act-Report"],"Act-Start":["Act-Transcode-M3U8"],"Act-Report":[]}}</Topology>
    </MediaWorkflow>
</AddMediaWorkflowResponse>

Format JSON

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

{
  "RequestId" : "F1D21261-ADB9-406A-1234-491382139D59",
  "MediaWorkflow" : {
    "CreationTime" : "016-04-01T05:29:37Z",
    "MediaWorkflowId" : "e00732b977da427d9177a4deb1aa****",
    "State" : "Active",
    "TriggerMode" : "OssAutoTrigger",
    "Name" : "mediaworkflow-example",
    "Topology" : "{\"Activities\":{\"Act-Transcode-M3U8\":{\"Parameters\":{\"Outputs\":[{\"OutputObject\":\"transcode%2F%7BObjectPrefix%7D%7BFileName%7D\",\"TemplateId\":\"957d1719ee85ed6527b90cf62726****\"}],\"OutputBucket\":\"example-vod-hls\",\"OutputLocation\":\"oss-cn-hangzhou\"},\"Type\":\"Transcode\"},\"Act-Start\":{\"Name\":\"Act-Start\",\"Parameters\":{\"PipelineId\":\"130266f58161436a80bf07cb12c8****\",\"InputFile\":{\"Bucket\":\"example-vod\",\"Location\":\"oss-cn-hangzhou\"}},\"Type\":\"Start\"},\"Act-Report\":{\"Name\":\"Act-Report\",\"Parameters\":{},\"Type\":\"Report\"}},\"Dependencies\":{\"Act-Transcode-M3U8\":[\"Act-Report\"],\"Act-Start\":[\"Act-Transcode-M3U8\"],\"Act-Report\":[]}}"
  }
}

Codes d'erreur

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