Gunakan QueryAnalysisJobList untuk menganalisis pekerjaan template - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Mengkueri pekerjaan analisis templat dan mengembalikan daftar templat preset yang tersedia ketika pekerjaan analisis templat selesai.

Deskripsi operasi

The time when the job was created.

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:QueryAnalysisJobList

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
AnalysisJobIds	string	Yes	Daftar ID pekerjaan analisis templat.	bb558c1cc25b45309aab5be44d19****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	The status of the job. Valid values: Submitted: The job has been submitted. Analyzing: The job is being run. Success: The job is successful. Fail: The job fails.	5CA6E020-4102-4FFF-AA56-5ED7ECD811A1
AnalysisJobList	object
AnalysisJob	array<object>	The IDs of template analysis jobs.
	array<object>
CreationTime	string	The time when the job was created.	2014-01-10T12:00:00Z
Percent	integer	The transcoding progress.	86
State	string	The job status. Submitted: The job was submitted. Analyzing: The job is in progress. Success: The job was successful. Fail: The job failed.	Success
AnalysisConfig	object	The job configurations.
QualityControl	object	The quality control on the job output.
MethodStreaming	string	The playback mode. Valid values: network: online playback. local: playback on on-premises devices. Default value: network.	network
RateQuality	string	The quality level of the job output. Default value: 25.	25
PropertiesControl	object	The control on the attributes of the job output.
Deinterlace	string	Specifies whether deinterlacing was forced to run. Valid values: Auto: Deinterlacing was automatically run. Force: Deinterlacing was forced to run. None: Deinterlacing was forced not to run.	Auto
Crop	object	The cropping configuration of the video image.
Top	string	The top margin to be cropped out. Catatan This parameter is invalid if the Mode parameter is set to Auto or None.	8
Width	string	The width of the video image after the margins are cropped out. Catatan This parameter is invalid if the Mode parameter is set to Auto or None.	8
Height	string	The height of the video image after the margins are cropped out. Catatan This parameter is invalid if the Mode parameter is set to Auto or None.	8
Left	string	The left margin to be cropped out. Catatan This parameter is invalid if the Mode parameter is set to Auto or None.	8
Mode	string	The cropping mode. Valid values: Auto: Cropping was automatically run. Force: Cropping was forced to run. None: Cropping was forced not to run. This parameter is required if the value of the Crop parameter is not an empty JSON {}.	Auto
Message	string	The error message returned if the job failed.	The resource operated \"PipelineId\" cannot be found
Priority	string	The priority of the job in the ApsaraVideo Media Processing (MPS) queue to which the job was submitted. Valid values: 1 to 10. The value 10 indicates the highest priority. Default value: 10.	8
MNSMessageResult	object	The message sent by Message Service (MNS) to notify users of the job result.
MessageId	string	The ID of the message returned if the job was successful. This parameter is not returned if the job failed.	3ca84a39a9024f19853b21be9cf9****
ErrorMessage	string	The error message returned if the job failed. This parameter is not returned if the job was successful.	The resource operated \"PipelineId\" cannot be found
ErrorCode	string	The error code returned if the job failed. This parameter is not returned if the job was successful.	InvalidParameter.ResourceNotFound
TemplateList	object
Template	array<object>	The matched preset templates.
	array<object>
Video	object	The video codec configurations.
Bufsize	string	The buffer size. Unit: KB. Default value: 6000.	6000
Degrain	string	The strength of the independent noise reduction algorithm.	5
BitrateBnd	object	The average bitrate range of the video.
Max	string	The upper limit of the total bitrate. Unit: Kbit/s.	1500
Min	string	The lower limit of the total bitrate. Unit: Kbit/s.	800
PixFmt	string	The pixel format of the video. Valid values: standard pixel formats such as yuv420p and yuvj420p.	yuv420p
Codec	string	The codec. Valid values: H.264 and H.265. Default value: H.264.	H.264
Height	string	The height of the video. Unit: pixel. Default value: the height of the input video.	720
Qscale	string	The level of quality control on the video.	15
Bitrate	string	The average bitrate of the video. Unit: Kbit/s.	1000
Maxrate	string	The maximum bitrate of the video. Valid values: 10 to 50000. Unit: Kbit/s.	2000
Profile	string	The codec profile. Valid values: baseline: applicable to mobile devices. main: applicable to standard-definition devices. high: applicable to high-definition devices. Default value: high.	high
Crf	string	The constant rate factor. Default value when the the Codec parameter is set to H.264: 23, default value when the the Codec parameter is set to H.265: 26. If this parameter is specified, the value of the Bitrate parameter becomes invalid.	26
Gop	string	The maximum number of frames between two keyframes. Default value: 250.	250
Width	string	The width of the video. Unit: pixel. Default value: the width of the input video.	1280
Fps	string	The frame rate of the video. The value is 60 if the frame rate of the input file exceeds 60. Default value: the frame rate of the input video.	25
Preset	string	The preset video algorithm. Valid values: veryfast, fast, medium, slow, and slower. Default value: medium.	medium
ScanMode	string	The scan mode. Valid values: interlaced progressive	interlaced
TransConfig	object	The general transcoding configurations.
TransMode	string	The transcoding mode. Default value: onepass. Valid values: onepass twopass CBR	onepass
State	string	The state of the template. Valid values: Normal Deleted	Normal
MuxConfig	object	The transmuxing configurations.
Gif	object	The transmuxing configurations for the GIF format.
FinalDelay	string	The interval between two consecutive loops for the GIF format. Unit: 0.01 second. For example, a value of 500 indicates 5 seconds.	0
Loop	string	The number of loops for the GIF or WebP format. Default value: 0.	0
Segment	object	The segment configurations.
Duration	string	The segment length. Unit: seconds.	10
Name	string	The name of the template.	FLV-UD
Audio	object	The audio codec configurations.
Profile	string	The codec profile of the audio. Valid values when the Codec parameter is set to aac: aac_low aac_he aac_he_v2 aac_ld aac_eld	aac_low
Codec	string	The audio codec. Default value: aac. Valid values: aac mp3 vorbis flac	aac
Samplerate	string	The sampling rate. Unit: Hz. Default value: 44100.	44100
Qscale	string	The level of quality control on the audio.	15
Channels	string	The number of sound channels. Default value: 2.	2
Bitrate	string	The audio bitrate of the output file. Valid values: 8 to 1000. Unit: Kbit/s. Default value: 128.	128
Id	string	The transcoding template ID.	S00000000-00****
Container	object	The container format configurations.
Format	string	The container format.	flv
UserData	string	The custom data.	testid-001
Code	string	The error code returned if the job fails.	InvalidParameter.ResourceNotFound
InputFile	object	The information about the job input.
Object	string	The name of the Object Storage Service (OSS) object that is used as the input file.	example.flv
Location	string	The region in which OSS resides.	oss-cn-hangzhou
Bucket	string	The name of the OSS bucket in which the input file is stored.	example-bucket
PipelineId	string	The ID of the MPS queue to which the job was submitted.	bb558c1cc25b45309aab5be44d19****
Id	string	The ID of the template analysis job.	57f6aa3f84824309bcba67231b406****
NonExistAnalysisJobIds	object
String	array	The message sent by Message Service (MNS) to notify the user of the job result.
	string	The operation that you want to perform. Set the value to QueryAnalysisJobList.	null

Contoh

Respons sukses

JSONformat

{
  "RequestId": "5CA6E020-4102-4FFF-AA56-5ED7ECD811A1",
  "AnalysisJobList": {
    "AnalysisJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 86,
        "State": "Success",
        "AnalysisConfig": {
          "QualityControl": {
            "MethodStreaming": "network",
            "RateQuality": "25"
          },
          "PropertiesControl": {
            "Deinterlace": "Auto",
            "Crop": {
              "Top": "8",
              "Width": "8",
              "Height": "8",
              "Left": "8",
              "Mode": "Auto"
            }
          }
        },
        "Message": "The resource operated \\\"PipelineId\\\" cannot be found",
        "Priority": "8",
        "MNSMessageResult": {
          "MessageId": "3ca84a39a9024f19853b21be9cf9****",
          "ErrorMessage": "The resource operated \\\"PipelineId\\\" cannot be found",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        },
        "TemplateList": {
          "Template": [
            {
              "Video": {
                "Bufsize": "6000",
                "Degrain": "5",
                "BitrateBnd": {
                  "Max": "1500",
                  "Min": "800"
                },
                "PixFmt": "yuv420p",
                "Codec": "H.264",
                "Height": "720",
                "Qscale": "15",
                "Bitrate": "1000",
                "Maxrate": "2000",
                "Profile": "high",
                "Crf": "26",
                "Gop": "250",
                "Width": "1280",
                "Fps": "25",
                "Preset": "medium",
                "ScanMode": "interlaced"
              },
              "TransConfig": {
                "TransMode": "onepass"
              },
              "State": "Normal",
              "MuxConfig": {
                "Gif": {
                  "FinalDelay": "0",
                  "Loop": "0"
                },
                "Segment": {
                  "Duration": "10"
                }
              },
              "Name": "FLV-UD",
              "Audio": {
                "Profile": "aac_low",
                "Codec": "aac",
                "Samplerate": "44100",
                "Qscale": "15",
                "Channels": "2",
                "Bitrate": "128"
              },
              "Id": "S00000000-00****",
              "Container": {
                "Format": "flv"
              }
            }
          ]
        },
        "UserData": "testid-001",
        "Code": "InvalidParameter.ResourceNotFound",
        "InputFile": {
          "Object": "example.flv",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "PipelineId": "bb558c1cc25b45309aab5be44d19****",
        "Id": "57f6aa3f84824309bcba67231b406****"
      }
    ]
  },
  "NonExistAnalysisJobIds": {
    "String": [
      "null"
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.