Gunakan ListMediaWorkflowExecutions untuk kueri instans eksekusi workflow media - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Mengkueri instance eksekusi alur kerja media.

Deskripsi operasi

Operasi ini hanya mengembalikan instance eksekusi dalam 90 hari terakhir.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibatalkan dan Anda akan mengalami gangguan layanan. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mts:ListMediaWorkflowExecutions

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MediaWorkflowId	string	No	ID alur kerja media yang instance eksekusinya ingin Anda kueri. Untuk memperoleh ID alur kerja, Anda dapat masuk ke konsol ApsaraVideo Media Processing (MPS) dan pilih Workflows > Workflow Settings.	43b7335a4b1d4fe883670036affb****
MediaWorkflowName	string	No	Nama alur kerja media. Untuk memperoleh nama alur kerja, Anda dapat masuk ke konsol MPS dan pilih Workflows > Workflow Settings.	example-mediaworkflow-****
InputFileURL	string	No	URL Object Storage Service (OSS) dari file input alur kerja media. URL ini mematuhi RFC 3986 dan dikodekan dalam UTF-8, dengan karakter yang dicadangkan dikodekan persen. Untuk informasi selengkapnya, lihat Pengkodean URL.	http://example-**.cn-hangzhou.aliyuncs.com/test**.flv
NextPageToken	string	No	Token paginasi yang digunakan pada permintaan berikutnya untuk mengambil halaman hasil baru. Nilainya adalah UUID yang berisi 32 karakter. Saat Anda meminta halaman pertama hasil kueri, biarkan parameter NextPageToken kosong. Saat Anda meminta lebih banyak hasil kueri, tentukan nilai parameter NextPageToken yang dikembalikan dalam hasil kueri pada halaman sebelumnya.	39f8e0bc005e4f309379701645f4****
MaximumPageSize	integer	No	Jumlah maksimum instance eksekusi alur kerja media yang akan dikembalikan. Nilai yang valid: `[1,100]`. Nilai default: 10.	1

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
MediaWorkflowExecutionList	object
MediaWorkflowExecution	array<object>	Detail alur kerja media.
	array<object>	Detail alur kerja media.
CreationTime	string	The time when the media workflow was created.	2016-04-01T06:53:43Z
MediaWorkflowId	string	The ID of the media workflow.	43b7335a4b1d4fe883670036affb****
State	string	The status of the media workflow. Valid values: running: The execution is in progress. Completed: The execution is complete. Catatan A value of Completed indicates that the execution is complete. For the information about whether each activity, such as Transcode or Snapshot, is successful, check the status of the activity. Fail: The execution failed. Success: The execution was successful.	Success
ActivityList	object
Activity	array<object>	The activities that are executed in the media workflow.
	array<object>	The details of the media workflow activity.
EndTime	string	The end time of the activity.	2016-04-01T06:54:00Z
Type	string	The type of the media workflow activity. Valid values: Start, Snapshot, Transcode, Analysis, and Report. For more information, see Methods supported for media workflows.	Start
StartTime	string	The start time of the activity.	2016-04-01T06:53:45Z
State	string	The status of the activity. Valid values: Running: The activity is being executed. Fail: The activity failed to be executed. Skipped: The activity was skipped. Success: The activity was successfully executed. Catatan For example, the high-definition and standard-definition transcoding activities are to be run after the analysis activity is complete. The system determines the activity to run based on the analysis result. If the definition of the input video content is insufficient, the high-definition transcoding activity may be skipped.	Success
JobId	string	The ID of the job generated when the activity is executed. We recommend that you keep this ID for subsequent operation calls.	2376030d9d0849399cd20e20c876****
Code	string	The error code returned if the request failed. The specific error code appears if the state of the activity is Fail. This parameter is not returned if the state of the activity is Success.	null
Message	string	The error message returned if the request failed. The detailed error message appears if the state of the activity is Fail. This parameter is not returned if the state of the activity is Success.	null
Name	string	The name of the media workflow activity. Catatan The name of an activity in a media workflow is unique.	Act-2
MNSMessageResult	object	The message sent by Message Service (MNS) to notify the user of the job result.
MessageId	string	The ID of the success message. If the job failed, this parameter is not returned.	4f3bc83233de4e2f81c7dade443e****
ErrorMessage	string	The error message returned if the job failed. If the job was successful, this parameter is not returned.	MessageConfigEmpty
ErrorCode	string	The error code returned if the job failed. If the job was successful, this parameter is not returned.	The Topic/Queue config is empty, not send message
Name	string	The name of the media workflow.	example-mediaworkflow-****
Input	object	The custom data of the media workflow.
UserData	string	The custom data.	example data
InputFile	object	The information about the storage location of the input file of the media workflow in OSS.
Object	string	The name of the OSS object that is used as the input media file.	example-mediaWorkflow-**/example-object-**/example.mp4
Location	string	The OSS region in which the input file resides.	cn-shanghai
Bucket	string	The name of the OSS bucket in which the input media file is stored.	example-bucket-****
MediaId	string	The ID of the media file. A media file contains all the information about a media workflow.	512046582a924698a41e0f8b0d2b****
RunId	string	The ID of the execution instance.	48e33690ac19445488c706924321****
RequestId	string	ID permintaan.	D1D5C080-8E2F-5030-8AB4-13092F17631B
NextPageToken	string	Nilai NextPageToken yang dikembalikan adalah token paginasi, yang dapat digunakan pada permintaan berikutnya untuk mengambil halaman hasil baru.	39f8e0bc005e4f309379701645f4****

Contoh

Respons sukses

JSONformat

{
  "MediaWorkflowExecutionList": {
    "MediaWorkflowExecution": [
      {
        "CreationTime": "2016-04-01T06:53:43Z",
        "MediaWorkflowId": "43b7335a4b1d4fe883670036affb****",
        "State": "Success",
        "ActivityList": {
          "Activity": [
            {
              "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****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.