All Products
Search

This Product

    ApsaraVideo VOD:GetImageInfo

    Document Center

    ApsaraVideo VOD:GetImageInfo

    Last Updated:Jul 21, 2026

    Mengambil informasi dasar dan URL akses 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.

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

    get

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ImageId

    string

    Yes

    ID image. Anda dapat memperoleh ID image dengan menggunakan salah satu metode berikut:

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

    • Dapatkan ID dari tanggapan operasi CreateUploadImage saat Anda mengambil URL unggah dan kredensial.

    • Dapatkan ID dari tanggapan operasi SearchMedia saat Anda mengkueri image.

    3e34733b40b9a96ccf5c1ff6f69****
    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 pemutaran 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 sistem 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: URL asal.

    • cdn (default): URL yang dipercepat.

    cdn.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    RequestId

    string

    ID permintaan.

    AB99D4DF-FAFA-49DC-9C548C1E261E****
    ImageInfo

    object

    Informasi image.

    CreationTime

    string

    Pengatur waktu pembuatan image. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam 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 oleh 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 address of the uploaded source image file.

    ****.gif
    Width

    integer

    The image width. Unit: pixel.

    200
    Height

    integer

    The image height. Unit: pixel.

    200
    FileSize

    string

    The file size. Unit: bytes.

    8932

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "AB99D4DF-FAFA-49DC-9C548C1E261E****",
  "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"
    }
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.