Kueri pekerjaan analisis sidik jari media menggunakan QueryDNAJobList - Intelligent Media Services

Mengkueri daftar pekerjaan analisis sidik jari media.

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

ice:QueryDNAJobList

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
JobIds	string	No	ID pekerjaan analisis sidik jari media yang ingin Anda kueri. Kami menyarankan agar Anda mengkueri maksimal 10 pekerjaan sekaligus. Pisahkan beberapa ID pekerjaan dengan koma (,).	88c6ca184c0e47098a5b665e2a12****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	25818875-5F78-4A13-BEF6-D7393642CA58
JobList	array<object>	Pekerjaan analisis sidik jari media yang dikueri.
	array<object>	Pekerjaan analisis sidik jari media yang dikueri.
DNAResult	string	URL hasil analisis sidik jari media.	http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt
PrimaryKey	string	Kunci utama video. Anda harus memastikan bahwa setiap kunci utama bersifat unik.	3ca84a39a9024f19853b21be9cf9****
DBId	string	ID perpustakaan sidik jari media.	2288c6ca184c0e47098a5b665e2a12****
CreationTime	string	Waktu saat pekerjaan dibuat.	2022-12-28T03:21:37Z
FinishTime	string	Waktu saat pekerjaan selesai.	2022-12-28T03:21:44Z
Status	string	Status pekerjaan. Nilai yang valid: Queuing: Pekerjaan sedang menunggu dalam antrian. Analysing: Pekerjaan sedang berlangsung. Success: Pekerjaan berhasil. Fail: Pekerjaan gagal.	Queuing
Message	string	Pesan yang dikembalikan.	"The resource operated \"a887d0b***d805ef6f7f6786302\" cannot be found"
Config	string	Konfigurasi pekerjaan analisis sidik jari media.	{"SaveType": "save","MediaType"":"video"}
UserData	string	Data yang ditentukan pengguna.	testdna
Code	string	Kode respons.	"InvalidParameter.ResourceNotFound"
Input	object	Detail file input.
Type	string	Jenis file input. Nilai yang valid: OSS: objek Object Storage Service (OSS). Media: aset media.	Media
Media	string	File input. File tersebut dapat berupa objek OSS atau aset media. Path objek OSS dapat menggunakan salah satu format berikut: 1. oss://bucket/object 2. http(s)://bucket.oss-[regionId].aliyuncs.com/object Pada path di atas, bucket menunjukkan bucket OSS yang berada di wilayah yang sama dengan proyek saat ini, dan object menunjukkan path objek dalam bucket tersebut.	1b1b9cd148034739af413150fded****
Id	string	ID pekerjaan.	88c6ca184c0e47098a5b665e2a12****

Nilai DNAResult merupakan array VideoMatchInfo.

VideoMatchInfo

Parameter	Type	Description
PrimaryKey	String	Kunci utama unik dari file.
GlobalSimilarity	Double	Tingkat kemiripan keseluruhan.
VideoMatchSegments	Array of VideoMatchSegment	Segmen video yang cocok berdasarkan pencarian video atau pencarian berdasarkan gambar.
AudioMatchSegments	Array of AudioMatchSegment	Segmen audio yang cocok berdasarkan pencarian audio.
TextMatchSegments	Array of TextMatchSegment	Segmen teks yang cocok berdasarkan pencarian teks.

VideoMatchSegment atau AudioMatchSegment

Parameter	Type	Description
StartTime	Double	Waktu mulai video atau audio input.
EndTime	Double	Waktu akhir video atau audio input.
MasterStartTime	Double	Waktu mulai video atau audio yang cocok dalam perpustakaan sidik jari media.
MasterEndTime	Double	Waktu akhir video atau audio yang cocok dalam perpustakaan sidik jari media.
Similarity	Double	Tingkat kemiripan segmen input terhadap segmen yang cocok yang memiliki sidik jari serupa dalam perpustakaan sidik jari media.

TextMatchSegment

Parameter	Type	Description
Start	Double	Waktu mulai segmen input.
End	Double	Waktu akhir segmen input.
QueryText	String	Teks input untuk analisis sidik jari teks.
MasterText	String	Segmen teks yang memiliki sidik jari serupa dengan teks input dalam perpustakaan sidik jari teks.
Similarity	Double	Tingkat kemiripan segmen input terhadap segmen yang cocok yang memiliki sidik jari serupa dalam perpustakaan sidik jari media.

Contoh

Respons sukses

JSONformat

{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobList": [
    {
      "DNAResult": "http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt",
      "PrimaryKey": "3ca84a39a9024f19853b21be9cf9****",
      "DBId": "2288c6ca184c0e47098a5b665e2a12****",
      "CreationTime": "2022-12-28T03:21:37Z",
      "FinishTime": "2022-12-28T03:21:44Z",
      "Status": "Queuing",
      "Message": "\"The resource operated \\\"a887d0b***d805ef6f7f6786302\\\" cannot be found\"",
      "Config": "{\"SaveType\": \"save\",\"MediaType\"\":\"video\"}",
      "UserData": "testdna",
      "Code": "\"InvalidParameter.ResourceNotFound\"",
      "Input": {
        "Type": "Media",
        "Media": "1b1b9cd148034739af413150fded****"
      },
      "Id": "88c6ca184c0e47098a5b665e2a12****"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.