GetUploadDetails - - Alibaba Cloud Documentation Center

Mengambil detail unggah, seperti waktu unggah, rasio unggah, dan sumber unggah, untuk satu atau beberapa file media berdasarkan ID medianya.

Catatan penggunaan

Operasi ini hanya dapat dipanggil untuk mendapatkan detail unggah file audio dan video.
Jika Anda menggunakan Konsol ApsaraVideo VOD untuk mengunggah file audio dan video, Anda dapat memanggil operasi ini untuk menanyakan informasi seperti rasio unggah. Jika Anda menggunakan upload SDK untuk mengunggah file audio dan video, pastikan versi upload SDK memenuhi salah satu persyaratan berikut:
- Versi upload SDK untuk Java adalah 1.4.4 atau yang lebih baru.
- Versi upload SDK untuk C++ adalah 1.0.0 atau yang lebih baru.
- Versi upload SDK untuk PHP adalah 1.0.2 atau yang lebih baru.
- Versi upload SDK untuk Python adalah 1.3.0 atau yang lebih baru.
- Versi upload SDK untuk JavaScript adalah 1.4.0 atau yang lebih baru.
- Versi upload SDK untuk Android adalah 1.5.0 atau yang lebih baru.
- Versi upload SDK untuk iOS adalah 1.5.0 atau yang lebih baru.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas, Pembatasan kecepatan akan dipicu, yang berpotensi mengganggu bisnis Anda. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS pada Operasi API di ApsaraVideo VOD.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	GetUploadDetails	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke GetUploadDetails.
MediaIds	String	Ya	61ccbdb06fa83012be4d8083f6**,7d2fbc380b0e08e55f**	ID file media, yaitu ID audio atau video. Anda dapat menentukan maksimal 20 ID. Pisahkan beberapa ID dengan koma (,). Anda dapat menggunakan salah satu metode berikut untuk mendapatkan ID audio atau video: Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video. Pada halaman Video dan Audio, Anda dapat melihat ID audio atau video. Gunakan metode ini jika file audio atau video diunggah melalui Konsol ApsaraVideo VOD. Lihat nilai parameter VideoId yang dikembalikan oleh operasi CreateUploadVideo yang Anda panggil untuk mendapatkan URL dan kredensial unggah. Lihat nilai parameter VideoId yang dikembalikan oleh operasi SearchMedia yang Anda panggil untuk menanyakan informasi media setelah file audio atau video diunggah.
MediaType	String	Tidak	video	Tipe file media. Tetapkan nilainya ke video, yang menunjukkan file audio dan video.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	9E290613-04F4-47F4-795D30732077****	ID permintaan.
ForbiddenMediaIds	Array of String	7d2fbc380b0e08e55f****	ID file media yang tidak dapat diakses.
NonExistMediaIds	Array of String	dfsg****	ID file media yang tidak ada.
UploadDetails	Array of UploadDetail		Detail unggah.
Status	String	Uploading	Status video. Untuk informasi selengkapnya tentang nilai valid dan deskripsi nilai parameter ini, lihat bagian "Status: the status of a video" pada topik Basic structures.
CreationTime	String	2019-04-28T09:42:07Z	Waktu saat pekerjaan unggah dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
UploadSource	String	WebSDK	Metode yang digunakan untuk mengunggah file media.
UploadIP	String	192.168.0.1	Alamat IP server yang mengunggah file media.
DeviceModel	String	Chrome	Model perangkat.
ModificationTime	String	2019-04-28T09:43:12Z	Waktu saat informasi file media diperbarui. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
CompletionTime	String	2019-04-28T09:45:07Z	Waktu saat pekerjaan unggah selesai. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
MediaId	String	61ccbdb06fa83012be4d8083f6****	ID audio atau video yang diunggah.
UploadSize	Long	346	Ukuran unggah. Satuan: byte.
UploadRatio	Float	0.038	Rasio unggah.
UploadStatus	String	Uploading	Status pekerjaan unggah. Untuk informasi selengkapnya tentang nilai valid dan deskripsi nilai parameter ini, lihat bagian "Status: the status of a URL-based upload job" pada topik Basic structures.
Title	String	Upload details of the test file	Judul file media.
FileSize	Long	46	Ukuran file yang diunggah. Satuan: byte.

Contoh

Contoh permintaan

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetUploadDetails
&MediaIds=61ccbdb06fa83012be4d8083f6****,7d2fbc380b0e08e55f****
&MediaType=video
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<GetUploadDetailsResponse>
    <RequestId>9E290613-04F4-47F4-795D30732077****</RequestId>
    <ForbiddenMediaIds>7d2fbc380b0e08e55f****</ForbiddenMediaIds>
    <NonExistMediaIds>dfsg****</NonExistMediaIds>
    <UploadDetails>
      <UploadDetail>
        <Status>Uploading</Status>
        <CreationTime>2019-04-28T09:42:07Z</CreationTime>
        <UploadSource>WebSDK</UploadSource>
        <UploadIP>192.168.0.1</UploadIP>
        <DeviceModel>Chrome</DeviceModel>
        <ModificationTime>2019-04-28T09:43:12Z</ModificationTime>
        <CompletionTime>2019-04-28T09:45:07Z</CompletionTime>
        <MediaId>61ccbdb06fa83012be4d8083f6****</MediaId>
        <UploadSize>346</UploadSize>
        <UploadRatio>0.038</UploadRatio>
        <UploadStatus>Uploading</UploadStatus>
        <Title>Upload details of the test file</Title>
        <FileSize>46</FileSize>
      </UploadDetail>
    </UploadDetails>
</GetUploadDetailsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "9E290613-04F4-47F4-795D30732077****",
  "ForbiddenMediaIds" : [ "7d2fbc380b0e08e55f****" ],
  "NonExistMediaIds" : [ "dfsg****" ],
  "UploadDetails" : [ {
    "Status" : "Uploading",
    "CreationTime" : "2019-04-28T09:42:07Z",
    "UploadSource" : "WebSDK",
    "UploadIP" : "192.168.0.1",
    "DeviceModel" : "Chrome",
    "ModificationTime" : "2019-04-28T09:43:12Z",
    "CompletionTime" : "2019-04-28T09:45:07Z",
    "MediaId" : "61ccbdb06fa83012be4d8083f6****",
    "UploadSize" : 346,
    "UploadRatio" : 0.038,
    "UploadStatus" : "Uploading",
    "Title" : "Upload details of the test file",
    "FileSize" : 46
  } ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.

Kesalahan umum

Tabel berikut menjelaskan kesalahan umum yang dapat dikembalikan oleh operasi ini.

Kode kesalahan	Pesan kesalahan	Kode status HTTP	Deskripsi
LimitExceeded.MediaIds	The input parameter 'MediaIds' Exceed the limit.	400	Pesan kesalahan yang dikembalikan karena jumlah ID media melebihi 20.