All Products
Search

This Product

    Intelligent Media Services:SubmitSnapshotJob

    Document Center

    Intelligent Media Services:SubmitSnapshotJob

    Last Updated:Sep 29, 2026

    Mengirimkan Pekerjaan snapshot. Anda dapat menentukan ID atau URL file media, pengatur waktu snapshot, dan format. Sistem menghasilkan snapshot berdasarkan parameter ini dan menyimpannya ke lokasi yang ditentukan.

    Deskripsi operasi

    Operasi ini adalah operasi asinkron. Setelah Anda mengirimkan Pekerjaan, ID Pekerjaan akan dikembalikan. Pekerjaan tidak langsung selesai dan masuk ke Antrian latar belakang untuk eksekusi asinkron. Hasil akhir dikirim melalui Notifikasi callback. Anda juga dapat memanggil operasi untuk mengkueri detail Pekerjaan snapshot guna secara aktif mengkueri status Pekerjaan.

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

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Name

    string

    No

    Nama Pekerjaan.

    SampleJob
    Input

    object

    Yes

    Input snapshot.

    Type

    string

    Yes

    Tipe input. Nilai valid:

    • OSS: URL objek OSS.

    • Media: ID Aset Media.

    Media
    Media

    string

    Yes

    Media input.

    • Jika Type diatur ke OSS, masukkan URL OSS.

    • Jika Type diatur ke Media, masukkan ID Aset Media.

    URL OSS harus mengikuti aturan berikut:

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object Dalam URL, bucket adalah nama bucket OSS yang berada di Wilayah yang sama dengan Proyek saat ini, dan objek adalah jalur file.

    Catatan

    Bucket OSS dalam URL harus ditambahkan ke manajemen penyimpanan IMS sebelum dapat digunakan.

    oss://bucket/object.mp4
    Output

    object

    Yes

    Output snapshot.

    Type

    string

    Yes

    Tipe input. Nilai valid:

    • OSS: URL objek OSS.

    • Media: ID Aset Media.

    OSS
    Media

    string

    Yes

    Media output.

    • Jika Type diatur ke OSS, masukkan URL OSS.

    • Jika Type diatur ke Media, masukkan ID Aset Media.

    URL OSS harus mengikuti aturan berikut:

    1. oss://bucket/object

    2. http(s)://bucket.oss-[RegionId].aliyuncs.com/object

    Dalam URL, bucket adalah nama bucket OSS yang berada di Wilayah yang sama dengan Proyek saat ini, dan objek adalah jalur file.

    • Saat mengambil beberapa snapshot statis, objek harus berisi placeholder "{Count}".

    • Saat mengambil snapshot Sprite, objek harus berisi placeholder "{TileCount}".

    • Untuk snapshot WebVTT, sufiks objek harus berupa ".vtt".

    Catatan

    Bucket OSS dalam URL harus ditambahkan ke manajemen penyimpanan IMS sebelum dapat digunakan.

    oss://test-bucket/output-{Count}.jpg
    TemplateConfig

    object

    Yes

    Konfigurasi Templat snapshot.

    TemplateId

    string

    Yes

    ID Templat.

    ****96e8864746a0b6f3****

    OverwriteParams

    object

    No

    Parameter penggantian.

    Type

    string

    No

    Tipe snapshot.

    Sprite
    FrameType

    string

    No

    Tipe frame.

    intra
    Count

    integer

    No

    Jumlah snapshot.

    5
    Interval

    integer

    No

    Interval snapshot. Unit: detik.

    10
    Time

    integer

    No

    Pengatur waktu mulai snapshot. Unit: milidetik.

    1000
    Width

    integer

    No

    Lebar gambar output.

    720
    Height

    integer

    No

    Tinggi gambar output.

    480
    BlackLevel

    integer

    No

    Ambang batas untuk memfilter gambar Layar hitam pada frame pertama snapshot multi-frame.

    30
    PixelBlackThreshold

    integer

    No

    Ambang batas untuk menentukan apakah sebuah piksel adalah piksel hitam.

    70
    SpriteSnapshotConfig

    object

    No

    Konfigurasi snapshot Sprite.

    CellWidth

    integer

    No

    Lebar satu gambar. Nilai default: lebar resolusi output snapshot.

    720
    CellHeight

    integer

    No

    Tinggi satu gambar. Nilai default: tinggi resolusi output snapshot.

    480
    Padding

    integer

    No

    Jarak antar gambar. Nilai default: 0. Unit: piksel.

    20
    Margin

    integer

    No

    Lebar margin. Nilai default: 0. Unit: piksel.

    20
    Columns

    integer

    No

    Jumlah kolom untuk penyambungan gambar.

    20
    Lines

    integer

    No

    Jumlah baris untuk penyambungan gambar.

    20
    Color

    string

    No

    Warna latar belakang.

    #000000
    IsSptFrag

    boolean

    No

    Konfigurasi snapshot WebVTT. Apakah akan menyambung output.

    true
    ScheduleConfig

    object

    No

    Konfigurasi penjadwalan.

    PipelineId

    string

    No

    ID pipeline.

    ****96e8864746a0b6f3****

    UserData

    string

    No

    Data pengguna kustom.

    {"test parameter": "test value"}

    Elemen respons

    Element

    Type

    Description

    Example

    object

    PlainResponse

    RequestId

    string

    ID permintaan.

    ******11-DB8D-4A9A-875B-275798******
    JobId

    string

    ID Pekerjaan.

    ****20b48fb04483915d4f2cd8ac****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "JobId": "****20b48fb04483915d4f2cd8ac****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.