QueryAnalysisJobList - - Alibaba Cloud Documentation Center

Menanyakan satu atau beberapa pekerjaan analisis templat.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk menanyakan hingga 10 pekerjaan analisis templat sekaligus.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, pembatasan kecepatan (throttling) akan dipicu, yang berpotensi mengganggu bisnis Anda. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer juga secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter

Type

Wajib

Contoh

Deskripsi

Action

String

Yes

QueryAnalysisJobList

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryAnalysisJobList.

AnalysisJobIds

String

Yes

bb558c1cc25b45309aab5be44d19****

ID pekerjaan analisis templat.

Anda dapat menanyakan hingga 10 pekerjaan sekaligus.
Pisahkan beberapa ID dengan koma (,).

Parameter respons

Parameter	Type	Contoh	Deskripsi
RequestId	String	5CA6E020-4102-4FFF-AA56-5ED7ECD811A1	ID permintaan.
AnalysisJobList	Array of AnalysisJob		ID pekerjaan analisis templat.
AnalysisJob
CreationTime	String	2014-01-10T12:00:00Z	Waktu saat pekerjaan dibuat.
Percent	Long	86	Kemajuan transcoding.
State	String	Success	Status pekerjaan. Nilai yang valid: Submitted: Pekerjaan telah dikirim. Analyzing: Pekerjaan sedang dijalankan. Success: Pekerjaan berhasil. Fail: Pekerjaan gagal.
AnalysisConfig	Object		Konfigurasi pekerjaan.
QualityControl	Object		Kontrol kualitas pada output pekerjaan.
MethodStreaming	String	network	Mode pemutaran. Nilai yang valid: network: pemutaran online local: pemutaran pada perangkat on-premises Nilai default: network.
RateQuality	String	25	Tingkat kualitas output pekerjaan. Nilai default: 25.
PropertiesControl	Object		Kontrol atribut output pekerjaan.
Deinterlace	String	Auto	Menunjukkan apakah deinterlacing dipaksa dijalankan. Nilai yang valid: Auto: Deinterlacing dijalankan secara otomatis. Force: Deinterlacing dipaksa dijalankan. None: Deinterlacing dipaksa tidak dijalankan.
Crop	Object		Konfigurasi cropping gambar video.
Top	String	8	Batas atas yang di-crop. Catatan Parameter ini tidak valid jika parameter Mode diatur ke Auto atau None.
Width	String	8	Lebar video setelah batas dipotong. Catatan Parameter ini tidak valid jika parameter Mode diatur ke Auto atau None.
Height	String	8	Tinggi video setelah batas dipotong. Catatan Parameter ini tidak valid jika parameter Mode diatur ke Auto atau None.
Left	String	8	Batas kiri yang di-crop. Catatan Parameter ini tidak valid jika parameter Mode diatur ke Auto atau None.
Mode	String	Auto	Mode cropping. Nilai yang valid: Auto: Cropping dijalankan secara otomatis. Force: Cropping dipaksa dijalankan. None: Cropping dipaksa tidak dijalankan. Parameter ini wajib jika nilai parameter Crop bukan objek JSON kosong.
Message	String	The resource operated \"PipelineId\" cannot be found	Pesan kesalahan yang dikembalikan saat pekerjaan gagal.
Priority	String	8	Prioritas pekerjaan dalam antrian MPS tempat pekerjaan ditambahkan. Nilai yang valid: 1 hingga 10. Nilai 10 menunjukkan prioritas tertinggi. Nilai default: 10.
MNSMessageResult	Object		Pesan yang dikirim oleh Message Service (MNS) untuk memberi tahu pengguna tentang hasil pekerjaan.
MessageId	String	3ca84a39a9024f19853b21be9cf9****	ID pesan sukses. Parameter ini tidak dikembalikan jika pekerjaan gagal.
ErrorMessage	String	The resource operated \"PipelineId\" cannot be found	Pesan kesalahan yang dikembalikan saat pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.
ErrorCode	String	InvalidParameter.ResourceNotFound	Kode kesalahan yang dikembalikan saat pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil.
TemplateList	Array of Template		Daftar templat preset yang cocok.
Template
Video	Object		Konfigurasi kodek video.
Bufsize	String	6000	Ukuran buffer. Unit: KB. Nilai default: 6000.
Degrain	String	5	Tingkat algoritma penghilangan derau independen.
BitrateBnd	Object		Rentang bitrate rata-rata video.
Max	String	1500	Batas atas bitrate total. Unit: Kbit/s.
Min	String	800	Batas bawah bitrate total. Unit: Kbit/s.
PixFmt	String	yuv420p	Format piksel untuk encoding warna video. Nilai yang valid: format piksel standar seperti yuv420p dan yuvj420p.
Codec	String	H.264	Format kodek video. Nilai yang valid: H.264 dan H.265. Nilai default: H.264.
Height	String	720	Tinggi video. Unit: piksel. Nilai default: tinggi asli video.
Qscale	String	15	Tingkat kontrol kualitas video.
Bitrate	String	1000	Bitrate rata-rata video. Unit: Kbit/s.
Maxrate	String	2000	Bitrate video maksimum. Nilai yang valid: 10 hingga 50000. Unit: Kbit/s.
Profile	String	high	Profil codec. Nilai yang valid: baseline: berlaku untuk perangkat seluler. main: berlaku untuk perangkat definisi standar. high: berlaku untuk perangkat definisi tinggi. Nilai default: high.
Crf	String	26	Faktor laju konstan (constant rate factor), yang merupakan pengaturan kontrol kualitas default. Nilai default saat parameter Codec diatur ke H.264: 23. Nilai default saat parameter Codec diatur ke H.265: 26. Jika parameter ini dikembalikan, pengaturan parameter Bitrate tidak berlaku.
Gop	String	250	Jumlah maksimum frame antara dua keyframe. Nilai default: 250.
Width	String	1280	Lebar video. Unit: piksel. Nilai default: lebar asli video.
Fps	String	25	Laju frame. Nilainya adalah 60 jika laju frame file input melebihi 60. Nilai default: laju frame file input.
Preset	String	medium	Algoritma video preset. Nilai yang valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium.
ScanMode	String	interlaced	Mode pemindaian. Nilai yang valid: interlaced: Pemindaian interlaced dilakukan. progressive: Pemindaian progressive dilakukan.
TransConfig	Object		Konfigurasi transcoding umum.
TransMode	String	onepass	Mode transcoding. Nilai default: onepass. Nilai yang valid: onepass twopass CBR
State	String	Normal	Status templat. Nilai yang valid: Normal: Templat dalam kondisi normal. Deleted: Templat dihapus.
MuxConfig	Object		Konfigurasi transmuxing.
Gif	Object		Format GIF.
FinalDelay	String	0	Interval antara dua loop berturut-turut untuk format GIF. Unit: 0,01 detik. Misalnya, nilai 500 menunjukkan 5 detik.
Loop	String	0	Jumlah loop untuk format GIF atau WebP. Nilai default: 0.
Segment	Object		Konfigurasi segmen.
Duration	String	10	Panjang segmen. Unit: detik.
Name	String	FLV-UD	Nama templat.
Audio	Object		Konfigurasi kodek audio.
Profile	String	aac_low	Profil kodek file audio. Nilai yang valid saat parameter Codec diatur ke aac: aac_low aac_he aac_he_v2 aac_ld aac_eld
Codec	String	aac	Format kodek audio. Nilai default: aac. Nilai yang valid: aac mp3 vorbis flac
Samplerate	String	44100	Laju pengambilan sampel. Unit: Hz. Nilai default: 44100.
Qscale	String	15	Tingkat kontrol kualitas audio.
Channels	String	2	Jumlah saluran suara. Nilai default: 2.
Bitrate	String	128	Bitrate audio file output. Nilai yang valid: 8 hingga 1000. Unit: Kbit/s. Nilai default: 128.
Id	String	S00000000-00****	ID templat transcoding.
Container	Object		Konfigurasi kontainer.
Format	String	flv	Format kontainer.
UserData	String	testid-001	Data kustom.
Code	String	InvalidParameter.ResourceNotFound	Kode kesalahan yang dikembalikan saat pekerjaan gagal.
InputFile	Object		Informasi tentang input pekerjaan.
Object	String	example.flv	Nama file input yang diunggah ke bucket Object Storage Service (OSS).
Location	String	oss-cn-hangzhou	ID wilayah OSS.
Bucket	String	example-bucket	Nama bucket OSS tempat file input diunggah.
PipelineId	String	bb558c1cc25b45309aab5be44d19****	ID antrian ApsaraVideo Media Processing (MPS) tempat pekerjaan ditambahkan.
Id	String	57f6aa3f84824309bcba67231b406****	ID pekerjaan analisis templat.
NonExistAnalysisJobIds	Array of String	null	ID pekerjaan analisis templat yang tidak ada. Jika semua ID pekerjaan yang ditanyakan ada, respons tidak berisi parameter ini.

Contoh

Contoh permintaan

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryAnalysisJobList
&AnalysisJobIds=bb558c1cc25b45309aab5be44d19****
&<Common request parameters>

Contoh respons sukses

XML format

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

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

JSON format

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

{
    "RequestId": "5CA6E020-4102-4FFF-AA56-5ED7ECD811A1",
    "AnalysisJobList": [
        {
            "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****",
            },
            "TemplateList": [
                {
                    "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",
            "InputFile": {
                "Object": "example.flv",
                "Location": "oss-cn-hangzhou",
                "Bucket": "example-bucket"
            },
            "PipelineId": "bb558c1cc25b45309aab5be44d19****",
            "Id": "57f6aa3f84824309bcba67231b406****"
        }
    ],
    "NonExistAnalysisJobIds": [
        "null"
    ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.