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

Mengkueri pekerjaan DNA.

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

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
JobIds	string	No	ID pekerjaan DNA yang akan dikueri. Anda dapat mengkueri hingga 10 ID pekerjaan per pengatur waktu. Pisahkan beberapa ID dengan koma (,).	88c6ca184c0e47098a5b665e2a12****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	25818875-5F78-4A13-BEF6-D7393642CA58
JobList	array<object>	Informasi pekerjaan DNA.
	array<object>	DNAJob.
DNAResult	string	URL hasil DNA.	http://test_bucket.oss-cn-shanghai.aliyuncs.com/fingerprint/video/search_result/5/5.txt
PrimaryKey	string	Kunci utama unik video. Anda harus memastikan keunikan kunci utama.	3ca84a39a9024f19853b21be9cf9****
DBId	string	ID pustaka DNA.	2288c6ca184c0e47098a5b665e2a12****
CreationTime	string	Pengatur waktu saat pekerjaan dibuat. Pengatur waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (berakhiran Z).	2022-12-28T03:21:37Z
FinishTime	string	Pengatur waktu saat pekerjaan selesai. Pengatur waktu mengikuti standar ISO 8601 dan ditampilkan dalam UTC (berakhiran Z).	2022-12-28T03:21:44Z
Status	string	Status pekerjaan. Nilai valid: Queuing: Pekerjaan berada dalam antrean. Analysing: Pekerjaan sedang dianalisis. Success: Pekerjaan berhasil. Fail: Pekerjaan gagal.	Queuing
Message	string	Paket kesalahan yang dikembalikan untuk eksekusi pekerjaan.	"The resource operated \"a887d0b***d805ef6f7f6786302\" cannot be found"
Config	string	Konfigurasi DNA.	{"SaveType": "save","MediaType"":"video"}
UserData	string	Data pengguna kustom.	testdna
Code	string	Kode kesalahan yang dikembalikan untuk eksekusi pekerjaan.	"InvalidParameter.ResourceNotFound"
Input	object	File input.
Type	string	Tipe file input. Nilai valid: OSS: URL objek OSS. Media: ID aset media.	Media
Media	string	Informasi tentang file input. URL OSS dan ID aset media didukung. URL OSS harus dalam salah satu format berikut: oss://bucket/object http(s)://bucket.oss-[regionId].aliyuncs.com/object Dalam format tersebut, bucket adalah nama Bucket OSS yang berada di Wilayah yang sama dengan Proyek saat ini, dan objek adalah jalur file.	1b1b9cd148034739af413150fded****
Id	string	ID pekerjaan.	88c6ca184c0e47098a5b665e2a12****

Parameter DNAResult berisi array objek VideoMatchInfo:

Detail VideoMatchInfo

Nama	Tipe	Deskripsi
PrimaryKey	String	Kunci utama unik file yang cocok.
GlobalSimilarity	Double	Tingkat kemiripan keseluruhan.
VideoMatchSegments	Array of VideoMatchSegment	Informasi tentang segmen video yang cocok dalam pencarian video-ke-video atau gambar-ke-video.
AudioMatchSegments	Array of AudioMatchSegment	Informasi tentang segmen audio yang cocok dalam pencarian audio-ke-audio.
TextMatchSegments	Array of TextMatchSegment	Informasi tentang segmen teks yang cocok dalam pencarian teks-ke-teks.

Detail VideoMatchSegment/AudioMatchSegment

Nama	Tipe	Deskripsi
StartTime	Double	Pengatur waktu mulai video atau audio input.
EndTime	Double	Pengatur waktu selesai video atau audio input.
MasterStartTime	Double	Pengatur waktu mulai video atau audio di pustaka.
MasterEndTime	Double	Pengatur waktu selesai video atau audio di pustaka.
Similarity	Double	Skor kepercayaan segmen yang cocok.

Detail TextMatchSegment

Nama	Tipe	Deskripsi
Start	Double	Pengatur waktu mulai segmen kueri yang cocok.
End	Double	Pengatur waktu selesai segmen kueri yang cocok.
QueryText	String	Segmen teks yang cocok dalam kueri.
MasterText	String	Segmen teks yang cocok di pustaka.
Similarity	Double	Skor kepercayaan segmen yang cocok.

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.