Gunakan QuerySnapshotJobList untuk mengkueri job snapshot - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Mengkueri Pekerjaan snapshot.

Deskripsi operasi

Anda dapat menentukan beberapa ID Pekerjaan snapshot (SnapshotJobIds) untuk dikueri. Sebagai alternatif, Anda dapat melakukan kueri halaman tanpa menentukan ID Pekerjaan snapshot dengan memfilter berdasarkan kondisi seperti status Snapshot, pengatur waktu pembuatan, dan Antrian MPS.
Anda dapat mengkueri hingga 10 Pekerjaan snapshot dalam satu panggilan.
Secara default, hasil yang dikembalikan diurutkan berdasarkan CreationTime secara menurun.

Batas QPS

Batas QPS per pengguna untuk operasi ini adalah 100 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi layanan Anda. Panggil operasi dengan benar. 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:QuerySnapshotJobList

list

*Semua resource.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SnapshotJobIds	string	No	Daftar ID Pekerjaan snapshot. Anda dapat mengkueri hingga 10 ID sekaligus. Pisahkan beberapa ID dengan koma (,). Anda dapat memperoleh ID dari Konsol MPS dengan memilih Job Management > Snapshots, atau dari parameter tanggapan Submit a snapshot job.	72dfa5e679ab4be9a3ed9974c736****
NextPageToken	string	No	Token untuk halaman berikutnya, yang merupakan UUID 32 karakter. Jika hasil kueri melebihi satu halaman, parameter NextPageToken akan dikembalikan dan diperbarui di setiap kueri. Gunakan token yang dikembalikan dalam kueri berikutnya.	cc6cbef8e8d5481ca536f5d2a466****
MaximumPageSize	integer	No	Jumlah entri maksimum yang dikembalikan pada setiap halaman dalam kueri halaman. Nilai valid: [1,300]. Nilai default: 30.	30
State	string	No	Status Snapshot yang akan dikueri. Nilai valid: Submitted: Pekerjaan telah dikirim. Snapshoting: Snapshot sedang diambil. Success: Snapshot berhasil diambil. Fail: Snapshot gagal.	Snapshoting
StartOfJobCreatedTimeRange	string	No	Pengatur waktu paling awal saat Pekerjaan dibuat. Tentukan pengatur waktu dalam standar ISO 8601. Pengatur waktu harus dalam UTC. format: YYYY-MM-DDThh:mm:ssZ.	2014-01-10T12:00:00Z
EndOfJobCreatedTimeRange	string	No	Pengatur waktu paling akhir saat Pekerjaan dibuat. Tentukan pengatur waktu dalam standar ISO 8601. Pengatur waktu harus dalam UTC. format: YYYY-MM-DDThh:mm:ssZ.	2014-01-12T12:00:00Z
PipelineId	string	No	ID Antrian MPS. Untuk informasi selengkapnya, lihat Terms. Nilai valid: Anda dapat mengkueri dan membuat Antrian MPS di Konsol MPS dengan memilih Pengaturan Global > MPS Queues. Jika Anda memerlukan Notifikasi asinkron, ikatkan Paket MNS ke Antrian MPS. Untuk informasi selengkapnya, lihat Receive message notifications.	b11c171cced04565b1f38f1ecc39****

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
SnapshotJobList	object
SnapshotJob	array<object>	Daftar Pekerjaan snapshot.
	array<object>	Parameter tanggapan.
CreationTime	string	Pengatur waktu saat Pekerjaan dibuat. Pengatur waktu ditampilkan dalam UTC dan diformat sesuai standar ISO 8601 dalam format YYYY-MM-DDTHH:mm:ssZ.	2021-06-30T12:34:29Z
SnapshotConfig	object	Konfigurasi Snapshot.
Time	string	Waktu mulai Snapshot. Unit: milidetik.	4
TileOut	object	Konfigurasi gambar sprite.
Padding	string	Jarak antar gambar. Nilai default: 0. Unit: piksel.	0
Color	string	Warna latar belakang. Nilai default: black. Nilai valid: color keyword dan random. Catatan Kata kunci warna mendukung tiga format. Misalnya, black dapat direpresentasikan sebagai Black, black, atau #000000.	black
CellSelStep	string	Ukuran langkah untuk memilih satu gambar.	3
CellHeight	string	Tinggi satu gambar. Nilai default: tinggi resolusi keluaran Snapshot.	8
CellWidth	string	Lebar satu gambar. Nilai default: lebar resolusi keluaran Snapshot.	8
Margin	string	Lebar bingkai luar. Nilai default: 0. Unit: piksel.	0
Columns	string	Jumlah kolom dalam gambar sprite. Nilai default: 10.	10
IsKeepCellPic	string	Apakah akan mempertahankan gambar tunggal. Nilai default: true.	false
Lines	string	Jumlah baris dalam gambar sprite. Nilai default: 10.	10
Interval	string	Interval pengatur waktu antar Snapshot. Jika parameter ini ditentukan, Snapshot berurutan akan diambil, dan nilainya harus lebih besar dari 0. Unit: detik. Nilai default: 10.	10
FrameType	string	Tipe Snapshot. Nilai valid: normal: frame normal. intra: I-frame. Nilai default: intra.	intra
Width	string	Lebar gambar keluaran Snapshot.	8
Height	string	Tinggi gambar keluaran Snapshot.	8
OutputFile	object	Konfigurasi OSS untuk keluaran Snapshot.
RoleArn	string	Nama Sumber Daya Alibaba Cloud dari peran yang ditentukan. Format: acs:ram::$accountID:role/$roleName.	acs:ram::1:role/testrole
Object	string	File keluaran Snapshot (objek OSS).	example.png
Location	string	Pusat data lokal tempat Bucket OSS untuk keluaran Snapshot berada (lokasi OSS).	example-location
Bucket	string	Bucket OSS tempat file keluaran Snapshot disimpan.	example
Num	string	Jumlah Snapshot. Jika parameter ini ditentukan, Snapshot berurutan akan diambil.	10
TileOutputFile	object	Konfigurasi OSS untuk gambar sprite keluaran.
RoleArn	string	Nama Sumber Daya Alibaba Cloud dari peran yang ditentukan. Format: acs:ram::$accountID:role/$roleName.	acs:ram::1:role/testrole
Object	string	File keluaran (objek OSS).	example.png
Location	string	Pusat data lokal tempat Bucket OSS keluaran berada (lokasi OSS).	example-location
Bucket	string	Bucket OSS tempat file keluaran disimpan.	example
TimeArray	object
TimePointList	array	Array titik pengatur waktu yang ditentukan.
	integer	Array titik pengatur waktu yang ditentukan. Unit: milidetik. Nilainya adalah bilangan floating-point dengan dua tempat desimal. Nilainya dapat duplikat dan dikirim tidak sesuai Pesanan, serta diurutkan oleh MPS. Anda dapat menentukan hingga 100 pengatur waktu. Jika parameter ini ditentukan, jangan tentukan Num, Time, atau Interval. Jika tidak, kode kesalahan InvalidParameter.Ambiguity akan dilaporkan.	[10050, 50000, 110000, 1000500, 1100500]
State	string	Status Snapshot. Nilai valid: Submitted: Pekerjaan telah dikirim. Snapshoting: Snapshot sedang diambil. Success: Snapshot berhasil diambil. Fail: Snapshot gagal.	Snapshoting
Message	string	Paket kesalahan yang dikembalikan saat Snapshot gagal. Parameter ini tidak dikembalikan jika Pekerjaan berhasil.	The resource operated InputFile is bad
MNSMessageResult	object	Hasil Notifikasi MNS yang dikirim ke pengguna setelah Pekerjaan selesai.
MessageId	string	ID Paket yang dikembalikan saat Notifikasi berhasil. Parameter ini tidak dikembalikan jika Notifikasi gagal.	799454621135656C7F815F198A76****
ErrorMessage	string	Paket kesalahan yang dikembalikan saat Notifikasi gagal. Parameter ini tidak dikembalikan jika Notifikasi berhasil.	The resource operated InputFile is bad
ErrorCode	string	kode kesalahan yang dikembalikan saat Notifikasi gagal. Parameter ini tidak dikembalikan jika Notifikasi berhasil.	InvalidParameter
Input	object	Masukan Pekerjaan.
RoleArn	string	Nama Sumber Daya Alibaba Cloud dari peran yang ditentukan. Format: acs:ram::$accountID:role/$roleName.	acs:ram::1:role/testrole
Object	string	File masukan (objek OSS).	example.flv
Location	string	Pusat data lokal tempat Bucket OSS masukan berada (lokasi OSS).	example-location
Bucket	string	Bucket OSS tempat file masukan disimpan.	example
Count	string	Jumlah gambar yang diambil.	1
TileCount	string	Jumlah gambar dalam gambar sprite.	7
UserData	string	Data pengguna kustom.	testid-001
Code	string	kode kesalahan yang dikembalikan saat Snapshot gagal. Parameter ini tidak dikembalikan jika Pekerjaan berhasil.	InvalidParameter
PipelineId	string	ID Antrian MPS.	b11c171cced04565b1f38f1ecc39****
Id	string	ID Pekerjaan snapshot.	cc6cbef8e8d5481ca536f5d2a466****
RequestId	string	ID permintaan.	34BCAB31-2833-43A7-9FBD-B34302AB23EQ
NonExistSnapshotJobIds	object
String	array	Daftar ID Pekerjaan snapshot yang tidak ada.
	string	Detail ID Pekerjaan snapshot yang tidak ada. Parameter ini tidak dikembalikan jika tidak ada data yang tersedia.	c6d973c33d1c4b21bc39907d3b29****
NextPageToken	string	Token untuk halaman berikutnya, yang merupakan UUID 32 karakter. Parameter ini dikembalikan dan diperbarui di setiap kueri saat hasil kueri melebihi satu halaman.	b11c171cced04565b1f38f1ecc39****

Contoh

Respons sukses

JSONformat

{
  "SnapshotJobList": {
    "SnapshotJob": [
      {
        "CreationTime": "2021-06-30T12:34:29Z",
        "SnapshotConfig": {
          "Time": "4",
          "TileOut": {
            "Padding": "0",
            "Color": "black",
            "CellSelStep": "3",
            "CellHeight": "8",
            "CellWidth": "8",
            "Margin": "0",
            "Columns": "10",
            "IsKeepCellPic": "false",
            "Lines": "10"
          },
          "Interval": "10",
          "FrameType": "intra",
          "Width": "8",
          "Height": "8",
          "OutputFile": {
            "RoleArn": "acs:ram::1:role/testrole",
            "Object": "example.png",
            "Location": "example-location",
            "Bucket": "example"
          },
          "Num": "10",
          "TileOutputFile": {
            "RoleArn": "acs:ram::1:role/testrole",
            "Object": "example.png",
            "Location": "example-location",
            "Bucket": "example"
          },
          "TimeArray": {
            "TimePointList": [
              0
            ]
          }
        },
        "State": "Snapshoting",
        "Message": "The resource operated InputFile is bad",
        "MNSMessageResult": {
          "MessageId": "799454621135656C7F815F198A76****",
          "ErrorMessage": "The resource operated InputFile is bad",
          "ErrorCode": "InvalidParameter"
        },
        "Input": {
          "RoleArn": "acs:ram::1:role/testrole",
          "Object": "example.flv",
          "Location": "example-location",
          "Bucket": "example"
        },
        "Count": "1",
        "TileCount": "7",
        "UserData": "testid-001",
        "Code": "InvalidParameter",
        "PipelineId": "b11c171cced04565b1f38f1ecc39****",
        "Id": "cc6cbef8e8d5481ca536f5d2a466****"
      }
    ]
  },
  "RequestId": "34BCAB31-2833-43A7-9FBD-B34302AB23EQ",
  "NonExistSnapshotJobIds": {
    "String": [
      "c6d973c33d1c4b21bc39907d3b29****"
    ]
  },
  "NextPageToken": "b11c171cced04565b1f38f1ecc39****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.