Kueri informasi dasar aset media menggunakan ListMediaBasicInfos - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Mengkueri informasi dasar semua aset media yang sesuai dengan parameter yang ditentukan.

Deskripsi operasi

Jika bidang includeFileBasicInfo diatur ke true, informasi dasar file sumber, seperti durasi dan ukuran file, juga dikembalikan.
Maksimum 100 catatan yang sesuai dikembalikan.
Semua aset media yang sesuai harus sama persis dengan semua bidang yang tidak kosong. Bidang yang mendukung pencocokan persis meliputi tipe media, sumber, tipe bisnis, kategori, dan status resource aset media.
Jika semua informasi tidak dapat dikembalikan sekaligus, Anda dapat menggunakan nextToken untuk mengkueri halaman berikutnya.

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

get

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
StartTime	string	No	Waktu mulai pengatur waktu pembuatan (utcCreated). Interval bersifat terbuka, yang berarti waktu harus lebih lambat pengatur waktu mulai. Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu harus dalam UTC. Misalnya, 2017-01-11T12:00:00Z menunjukkan pukul 20:00:00 pada 11 Januari 2017 (UTC+8).	2020-12-20T12:00:00Z
EndTime	string	No	Waktu akhir dari waktu pembuatan (utcCreated). Interval bersifat tertutup, yang berarti waktu harus lebih awal dari atau sama dengan waktu akhir. Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu harus dalam UTC. Misalnya, 2017-01-11T12:00:00Z menunjukkan pukul 20:00:00 pada 11 Januari 2017 (UTC+8).	2020-12-20T13:00:00Z
MediaType	string	No	Tipe media dari aset media. Nilai valid: "image": Gambar. "video": Video. "audio": Audio. "text": Teks.	video
BusinessType	string	No	Tipe bisnis dari aset media. Nilai valid: "subtitles": Subtitle. "watermark": Watermark. "opening": Pembuka. "ending": Penutup. "general": Umum.	opening
Source	string	No	Sumber. Nilai valid: "oss": Penyimpanan OSS. "vod": VOD. "live": ApsaraVideo Live. "general": Sumber lain (default).	oss
Status	string	No	Status resource. Nilai valid: Init: Status awal. File sumber belum siap. Preparing: File sumber sedang disiapkan, seperti sedang diunggah atau diedit dan diproduksi. PrepareFail: File sumber gagal disiapkan, seperti gagal mendapatkan informasi file sumber. Normal: Normal. File sumber sudah siap.	Normal
NextToken	string	No	Token yang menunjukkan posisi dari mana pemanggilan saat ini mulai membaca. Nilai kosong menunjukkan bahwa semua data telah dibaca.	pSa1SQ0wCe5pzVrQ6mWZEw==
MaxResults	integer	No	Jumlah maksimum catatan yang dikembalikan untuk permintaan saat ini. Nilai maksimum: 100. Nilai default: 10.	5
SortBy	string	No	Urutan pengurutan berdasarkan utcCreated. Nilai default: desc. Nilai valid: "desc": Urutan menurun. "asc": Urutan menaik.	desc
IncludeFileBasicInfo	boolean	No	Apakah akan menyertakan informasi dasar file dalam tanggapan.	true
MediaId	string	No	ID aset media. Satu ID aset media mendukung pencocokan awalan.	**019b82e24b37a1c2958dec38**
AuthTimeout	integer	No	Waktu kedaluwarsa otentikasi. Unit: detik. Nilai minimum: 1. Nilai maksimum: 86400. Nilai default: 3600.	30

Elemen respons

Element	Type	Description	Example
	object	Skema respons.
RequestId	string	ID permintaan.	****B7-7F87-4792-BFE9-63CD21****
TotalCount	integer	Jumlah total item yang memenuhi kondisi permintaan.	4
MediaInfos	array<object>	Kumpulan aset media yang memenuhi kondisi permintaan.
	array<object>	Informasi aset media.
MediaId	string	ID aset media. Satu ID aset media mendukung pencocokan awalan.	**019b82e24b37a1c2958dec38**
MediaBasicInfo	object	Informasi dasar aset media.
MediaId	string	ID aset media. Satu ID aset media mendukung pencocokan awalan.	**019b82e24b37a1c2958dec38**
InputURL	string	URL aset media yang akan didaftarkan di sistem terkait.	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	Tipe media aset media.	video
BusinessType	string	Tipe bisnis aset media.	opening
Source	string	Sumber.	oss
Title	string	Judul.	Title
Description	string	Deskripsi konten.	Description
Category	string	Kategori.	Category
MediaTags	string	Tag.	tags,tags2
CoverURL	string	URL sampul.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	Data pengguna.	userData
Snapshots	string	Snapshot.	[{"bucket":"example-bucket","count":"3","iceJobId":"****f48f0e4154976b2b8c45**","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"**e6a6440b29eb60bd7c****"}]
Status	string	Status sumber daya.	Normal
TranscodeStatus	string	Status transkoding.	Init
CreateTime	string	Waktu ketika aset media dibuat. Waktu mengikuti standar ISO 8601 dan dalam UTC.	2021-01-08T16:52:04Z
ModifiedTime	string	Waktu ketika aset media dimodifikasi. Waktu mengikuti standar ISO 8601 dan dalam UTC.	2021-01-08T16:52:07Z
DeletedTime	string	Waktu ketika aset media dihapus. Waktu mengikuti standar ISO 8601 dan dalam UTC.	2021-01-08T16:52:07Z
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"}]
CateId	integer	ID kategori.	3049
Biz	string	Bisnis tempat aset media berada.	ICE
UploadSource	string	Sumber unggahan aset media.	general
ReferenceId	string	ID kustom. Panjangnya harus 6 hingga 64 karakter dan hanya dapat berisi huruf kecil, huruf besar, angka, tanda hubung, dan garis bawah. Harus unik per pengguna.	123-123
FileInfoList	array<object>	Daftar informasi file.
	array<object>	Informasi file.
FileBasicInfo	object	Informasi dasar file, termasuk durasi dan ukuran.
FileName	string	Nama file.	example.mp4
FileStatus	string	Status file.	Normal
FileType	string	Tipe file.	source_file
FileSize	string	Ukuran file dalam byte.	14340962
FileUrl	string	URL OSS file.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	Wilayah penyimpanan file.	cn-shanghai
FormatName	string	Format kontainer.	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	Durasi.	60.00000
Bitrate	string	Bitrate.	1912.13
Width	string	Lebar.	1280
Height	string	Tinggi.	720
CreateTime	string	Waktu ketika file dibuat. Waktu mengikuti standar ISO 8601 dan dalam UTC.	2021-01-08T16:52:04Z
ModifiedTime	string	Pengatur waktu saat file dimodifikasi. Pengatur waktu mengikuti standar ISO 8601 dan dalam UTC.	2021-01-08T16:52:07Z
NextToken	string	Token yang menunjukkan posisi dari mana pemanggilan saat ini mulai membaca. Nilai kosong menunjukkan bahwa semua data telah dibaca.	8EqYpQbZ6Eh7+Zz8DxVYoQ==
MaxResults	integer	Jumlah maksimum entri yang dikembalikan untuk permintaan saat ini.	2

Contoh

Respons sukses

JSONformat

{
  "RequestId": "******B7-7F87-4792-BFE9-63CD21******",
  "TotalCount": 4,
  "MediaInfos": [
    {
      "MediaId": "****019b82e24b37a1c2958dec38****",
      "MediaBasicInfo": {
        "MediaId": "****019b82e24b37a1c2958dec38****",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "opening",
        "Source": "oss",
        "Title": "Judul video saya",
        "Description": "Deskripsi singkat tentang media",
        "Category": "video",
        "MediaTags": "tags,tags2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userData",
        "Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2021-01-08T16:52:04Z",
        "ModifiedTime": "2021-01-08T16:52:07Z",
        "DeletedTime": "2021-01-08T16:52:07Z",
        "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\"}]",
        "CateId": 3049,
        "Biz": "ICE",
        "UploadSource": "general",
        "ReferenceId": "123-123"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example.mp4",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "14340962",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "60.00000",
            "Bitrate": "1912.13",
            "Width": "1280",
            "Height": "720",
            "CreateTime": "2021-01-08T16:52:04Z",
            "ModifiedTime": "2021-01-08T16:52:07Z"
          }
        }
      ]
    }
  ],
  "NextToken": "8EqYpQbZ6Eh7+Zz8DxVYoQ==",
  "MaxResults": 2
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.