All Products
Search

This Product

    Intelligent Media Services:BatchGetMediaInfos

    Document Center

    Intelligent Media Services:BatchGetMediaInfos

    Last Updated:Aug 06, 2026

    Mengambil informasi beberapa aset media dengan menentukan beberapa nilai mediaId.

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

    get

    *Semua Sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    MediaIds

    string

    No

    ID aset media yang akan dikueri, dipisahkan dengan koma.

    ******b48fb04483915d4f2cd8******,******c48fb37407365d4f2cd8******
    AdditionType

    string

    No

    Informasi tambahan mengenai aset media yang akan dikembalikan dalam kueri batch. Secara default, hanya BasicInfo yang dikembalikan. Informasi tambahan mencakup:

    -FileInfo

    -DynamicMetaData

    FileInfo,DynamicMetaData
    AuthTimeout

    integer

    No

    Waktu kedaluwarsa otentikasi. Satuan: detik.

    • Nilai minimum: 1.

    • Nilai maksimum: 86400.

    • Nilai default: 3600.

    30

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons

    RequestId

    string

    ID permintaan.

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

    array<object>

    Kumpulan aset media yang memenuhi persyaratan yang ditentukan.

    array<object>

    Kumpulan aset media yang memenuhi persyaratan yang ditentukan.

    MediaId

    string

    ID aset media.

    ******c48fb37407365d4f2cd8******
    MediaBasicInfo

    object

    Informasi dasar mengenai aset media.

    MediaId

    string

    ID media.

    ******c48fb37407365d4f2cd8******
    InputURL

    string

    URL aset media di sistem sumbernya.

    https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
    MediaType

    string

    Jenis media. Nilai yang valid:

    • Image

    • Video

    • Audio

    • Text

    video
    BusinessType

    string

    Jenis bisnis dari aset media.

    general
    Source

    string

    Sumber. Nilai yang valid:

    • OSS

    • VOD

    oss
    Title

    string

    Judul.

    title
    Description

    string

    Deskripsi.

    description
    Category

    string

    Kategori.

    category1
    MediaTags

    string

    Tag.

    tag1, tag2
    CoverURL

    string

    URL sampul.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
    UserData

    string

    Data pengguna.

    userDataTest
    Snapshots

    string

    Cuplikan (snapshot).

    [ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
    Status

    string

    Status aset media.

    Normal
    TranscodeStatus

    string

    Status transkoding.

    Init
    CreateTime

    string

    Waktu pembuatan aset media.

    2020-12-26T04:11:10Z
    ModifiedTime

    string

    Waktu terakhir aset media dimodifikasi.

    2020-12-26T04:11:12Z
    DeletedTime

    string

    Waktu penghapusan aset media.

    2020-12-26T04:11:10Z
    SpriteImages

    string

    Gambar sprite.

    [{"bucket":"example-bucket","count":"32","iceJobId":"******83ec44d58b2069def2e******","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"******e438b14ff39293eaec25******","tileCount":"1"}]
    Biz

    string

    Bisnis yang terkait dengan aset media.

    ICE
    FileInfoList

    array<object>

    Daftar informasi dasar file.

    array<object>

    Informasi dasar file.

    FileBasicInfo

    object

    Informasi dasar mengenai file, seperti durasi dan ukuran file.

    FileName

    string

    Nama file.

    example
    FileStatus

    string

    Status file.

    Normal
    FileType

    string

    Jenis file.

    source_file
    FileSize

    string

    Ukuran file, dalam byte.

    30611502
    FileUrl

    string

    URL OSS file tersebut.

    http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
    Region

    string

    Wilayah tempat file disimpan.

    cn-shanghai
    FormatName

    string

    Format kontainer.

    mov,mp4,m4a,3gp,3g2,mj2
    Duration

    string

    Durasi.

    200
    Bitrate

    string

    Bitrate.

    1132.68
    Width

    string

    Lebar.

    1920
    Height

    string

    Tinggi.

    1080
    AudioStreamInfoList

    array<object>

    Aliran audio.

    object

    Detail aliran audio.

    Index

    string

    Indeks aliran.

    CodecName

    string

    Nama singkat kodek.

    CodecLongName

    string

    Nama lengkap kodek.

    CodecTimeBase

    string

    Basis waktu kodek.

    CodecTagString

    string

    String tag kodek.

    CodecTag

    string

    Tag kodek.

    Profile

    string

    Profil.

    SampleFmt

    string

    Format sampel.

    SampleRate

    string

    Laju sampel.

    Channels

    string

    Jumlah saluran audio.

    ChannelLayout

    string

    Tata letak saluran.

    Timebase

    string

    Basis waktu.

    StartTime

    string

    Waktu mulai.

    Duration

    string

    Durasi.

    Bitrate

    string

    Bitrate.

    Fps

    string

    Laju frame.

    NumFrames

    string

    Jumlah total frame.

    Lang

    string

    Bahasa.

    VideoStreamInfoList

    array<object>

    Aliran video.

    object

    Detail aliran video.

    Index

    string

    Indeks aliran.

    CodecName

    string

    Nama singkat kodek.

    CodecLongName

    string

    Nama lengkap kodek.

    Profile

    string

    Profil.

    CodecTimeBase

    string

    Basis waktu kodek.

    CodecTagString

    string

    String tag kodek.

    CodecTag

    string

    Tag kodek.

    Width

    string

    Lebar video.

    Height

    string

    Tinggi video.

    HasBFrames

    string

    Menunjukkan apakah terdapat B-frame.

    Sar

    string

    Rasio aspek sampel (SAR).

    Dar

    string

    Rasio aspek tampilan (DAR).

    PixFmt

    string

    Format piksel.

    Level

    string

    Tingkat.

    Fps

    string

    Laju frame.

    AvgFPS

    string

    Laju frame rata-rata.

    Timebase

    string

    Basis waktu.

    StartTime

    string

    Waktu mulai.

    Duration

    string

    Durasi.

    Bitrate

    string

    Bitrate.

    NumFrames

    string

    Jumlah total frame.

    Lang

    string

    Bahasa.

    Rotate

    string

    Sudut rotasi.

    Nb_frames

    string

    Parameter ini merupakan alias untuk NumFrames.

    SubtitleStreamInfoList

    array<object>

    Aliran subtitle.

    object

    Detail aliran subtitle.

    Index

    string

    Indeks aliran.

    CodecName

    string

    Nama singkat kodek.

    CodecLongName

    string

    Nama lengkap kodek.

    CodecTimeBase

    string

    Basis waktu kodek.

    CodecTagString

    string

    String tag kodek.

    CodecTag

    string

    Tag kodek.

    Timebase

    string

    Basis waktu.

    StartTime

    string

    Waktu mulai.

    Duration

    string

    Durasi.

    Lang

    string

    Bahasa.

    MediaDynamicInfo

    object

    Jenis aset media.

    DynamicMetaData

    object

    Jenis metadata dinamis. Nilai yang valid:

    • "ai": Data terstandarisasi yang berasal dari hasil AI mentah.

    • "user-defined": Metadata yang ditentukan pengguna.

    • "system": Data yang dihasilkan sistem.

    Data

    string

    Konten metadata dinamis.

    system
    IgnoredList

    array

    Daftar aset media yang gagal diambil.

    string

    Informasi aset media.

    ****20b48fb04483915d4f2cd8ac****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfos": [
    {
      "MediaId": "******c48fb37407365d4f2cd8******",
      "MediaBasicInfo": {
        "MediaId": "******c48fb37407365d4f2cd8******",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title",
        "Description": "description",
        "Category": "category1",
        "MediaTags": "tag1, tag2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userDataTest",
        "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:10Z",
        "ModifiedTime": "2020-12-26T04:11:12Z",
        "DeletedTime": "2020-12-26T04:11:10Z",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "Biz": "ICE"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "200",
            "Bitrate": "1132.68",
            "Width": "1920",
            "Height": "1080"
          },
          "AudioStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Profile": "",
              "SampleFmt": "",
              "SampleRate": "",
              "Channels": "",
              "ChannelLayout": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "Fps": "",
              "NumFrames": "",
              "Lang": ""
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "Profile": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Width": "",
              "Height": "",
              "HasBFrames": "",
              "Sar": "",
              "Dar": "",
              "PixFmt": "",
              "Level": "",
              "Fps": "",
              "AvgFPS": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "NumFrames": "",
              "Lang": "",
              "Rotate": "",
              "Nb_frames": ""
            }
          ],
          "SubtitleStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Lang": ""
            }
          ]
        }
      ],
      "MediaDynamicInfo": {
        "DynamicMetaData": {
          "Data": "system"
        }
      }
    }
  ],
  "IgnoredList": [
    "****20b48fb04483915d4f2cd8ac****"
  ]
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.