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

Observações de uso

Use esta operação para definir a topologia, as atividades e as dependências de um workflow de mídia. No console, a topologia é representada por um grafo acíclico direcionado (DAG). Para mais informações, consulte Atividades de workflow de mídia. Você pode visualizar e executar os workflows criados por esta operação no console do ApsaraVideo Media Processing (MPS).

Limites de QPS

Esta operação permite até 100 chamadas por segundo por conta. Se o número de chamadas por segundo ultrapassar esse limite, ocorre limitação de taxa (throttling), o que pode afetar seus serviços. Recomendamos observar esse limite ao chamar esta operação. Para mais detalhes, 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	AddMediaWorkflow	A operação a ser executada. Defina o valor como AddMediaWorkflow.
Name	String	Sim	mediaworkflow-example	Nome do workflow de mídia. O valor não pode estar vazio. O nome deve ser único na conta Alibaba Cloud atual e não pode coincidir com um workflow de mídia existente. O comprimento máximo permitido é de 64 caracteres. Somente caracteres UTF-8 são aceitos.
Topology	String	Sim	null	Topologia do workflow de mídia. O valor deve ser um objeto JSON contendo a lista de atividades e suas dependências. Para mais informações, consulte a seção Exemplo de topologia deste tópico.
TriggerMode	String	Não	OssAutoTrigger	Modo de acionamento do workflow de mídia. Valores válidos: OssAutoTrigger: O workflow de mídia é acionado automaticamente. NotInAuto: O workflow de mídia não é acionado automaticamente.

Exemplo de topologia


{
  "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": [
    ]
  }
}

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	F1D21261-ADB9-406A-1234-491382139D59	ID da solicitação.
MediaWorkflow	Object		Informações sobre o workflow de mídia.
CreationTime	String	016-04-01T05:29:37Z	Horário de criação do workflow de mídia.
MediaWorkflowId	String	e00732b977da427d9177a4deb1aa****	ID do workflow de mídia. Recomendamos guardar este ID para operações futuras neste workflow.
State	String	Active	Status do workflow de mídia. Por padrão, o workflow criado assume o estado Active.
TriggerMode	String	OssAutoTrigger	Modo de acionamento do workflow de mídia. Valores válidos: OssAutoTrigger: O workflow de mídia é acionado automaticamente. NotInAuto: O workflow de mídia não é acionado automaticamente.
Name	String	mediaworkflow-example	Nome do workflow de mídia.
Topology	String	null	Topologia do workflow de mídia. O valor é um objeto JSON que contém a lista de atividades e as dependências entre elas.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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

Formato 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\":[]}}"
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.