All Products
Search

This Product

    ApsaraVideo VOD:GetImageInfos

    Document Center

    ApsaraVideo VOD:GetImageInfos

    Last Updated:Jul 21, 2026

    Mengkueri informasi dasar dan URL akses beberapa image berdasarkan ID image setelah image diunggah ke ApsaraVideo VOD.

    Deskripsi operasi

    • Operasi ini hanya mendukung pengkuerian informasi tentang image yang diunggah ke ApsaraVideo VOD. Untuk mengkueri informasi tentang snapshot yang dihasilkan dari snapshot video, panggil operasi ListSnapshots.

    • Anda dapat mengkueri informasi hingga 20 image sekaligus.

    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

    vod:GetImageInfos

    list

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ImageIds

    string

    Yes

    Daftar ID image. Pisahkan beberapa ID dengan koma (,). Maksimal 20 ID didukung. Anda dapat memperoleh ID image dengan menggunakan metode berikut:

    • Masuk ke Konsol ApsaraVideo VOD dan pilih File Media > Gambar untuk Tampilan ID.

    • Memperoleh ID dari tanggapan saat Anda memanggil CreateUploadImage untuk mendapatkan URL unggah dan kredensial.

    • Memperoleh ID dari tanggapan saat Anda memanggil SearchMedia untuk mengkueri image.

    bbc65bba53fed90de118a7849****,594228cdd14b4d069fc17a8c4a****
    AuthTimeout

    integer

    No

    Periode validitas URL akses image. Unit: detik.

    • Jika OutputType diatur ke cdn:

      • URL image kedaluwarsa hanya jika penandatanganan URL diaktifkan. Jika tidak, URL berlaku permanen.

      • Nilai minimum: 1.

      • Nilai maksimum: tanpa batas.

      • Nilai default: Jika parameter ini tidak ditentukan, periode validitas default yang ditentukan dalam penandatanganan URL akan digunakan.

    • Jika OutputType diatur ke oss:

      • URL image kedaluwarsa hanya jika izin penyimpanan diatur ke privat. Jika tidak, URL berlaku permanen.

      • Nilai minimum: 1.

      • Nilai maksimum: Untuk mengurangi risiko keamanan pada server asal, nilai maksimum adalah 2592000 (30 hari) jika image disimpan di bucket yang dikelola oleh ApsaraVideo VOD, dan 129600 (36 jam) jika image disimpan di Bucket OSS Anda sendiri.

      • Nilai default: Jika parameter ini tidak ditentukan, nilainya adalah 3600.

    3600
    OutputType

    string

    No

    Tipe URL akses image yang akan dikembalikan. Nilai valid:

    • oss: alamat penyimpanan.

    • cdn (default): URL yang dipercepat CDN.

    cdn.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    25818875-5F78-4AF6-D7393642CA58*****
    ImageInfo

    array<object>

    Daftar informasi image.

    array<object>

    Daftar informasi image.

    CreationTime

    string

    Waktu pembuatan image. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).

    2018-11-21T02:37:23Z
    StorageLocation

    string

    Alamat penyimpanan file image.

    outin-****..oss-cn-shanghai.aliyuncs.com.
    Status

    string

    Status image. Nilai valid:

    • Uploading: Image sedang diunggah. Ini adalah status awal.

    • Normal: Image telah diunggah.

    • UploadFail: Image gagal diunggah.

    Uploading.
    CateId

    integer

    ID kategori.

    254766071
    Tags

    string

    Tag image. Beberapa tag dipisahkan dengan koma (,).

    tag1,tag2,tag3
    ImageType

    string

    Tipe image. Nilai valid:

    • default: image biasa.

    • cover: gambar mini video.

    default.
    CateName

    string

    Nama kategori.

    Test.
    Description

    string

    Deskripsi image.

    Test description.
    AppId

    string

    ID aplikasi.

    app-****
    URL

    string

    URL akses image. Jika nama domain CDN dikonfigurasi, URL CDN akan dikembalikan. Jika tidak, URL OSS akan dikembalikan.

    http://example.aliyundoc.com/image/default/****.gif?auth_key=****
    Title

    string

    Judul image.

    this is a sample.
    ImageId

    string

    ID image.

    bbc65bba53f9*****ed90de118a7849
    Mezzanine

    object

    Informasi mezzanine image.

    FileURL

    string

    The OSS URL of the image file.

    https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D
    OriginalFileName

    string

    The URL of the source file.

    ****.gif
    Width

    integer

    The width of the image. Unit: pixels.

    200
    Height

    integer

    The height of the image. Unit: pixels.

    200
    FileSize

    string

    The size of the file to be uploaded. Unit: bytes.

    8932
    NonExistImageIds

    array

    Daftar ID image yang tidak ada.

    string

    Daftar ID image yang tidak ada.

    f45cf4eba5c80233389558c39****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "25818875-5F78-4AF6-D7393642CA58*****",
  "ImageInfo": [
    {
      "CreationTime": "2018-11-21T02:37:23Z",
      "StorageLocation": "outin-****..oss-cn-shanghai.aliyuncs.com",
      "Status": "Uploading",
      "CateId": 254766071,
      "Tags": "tag1,tag2,tag3",
      "ImageType": "default",
      "CateName": "Test",
      "Description": "Test description",
      "AppId": "app-****",
      "URL": "http://example.aliyundoc.com/image/default/****.gif?auth_key=****",
      "Title": "this is a sample",
      "ImageId": "bbc65bba53f9*****ed90de118a7849",
      "Mezzanine": {
        "FileURL": "https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D",
        "OriginalFileName": "****.gif",
        "Width": 200,
        "Height": 200,
        "FileSize": "8932"
      }
    }
  ],
  "NonExistImageIds": [
    "f45cf4eba5c80233389558c39****"
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.