GetURLUploadInfos - - Alibaba Cloud Documentation Center

Mengkueri informasi mengenai pekerjaan upload berbasis URL.

Catatan penggunaan

Anda dapat mengkueri informasi pekerjaan upload berbasis URL dengan menentukan URL upload atau menggunakan ID pekerjaan yang dikembalikan saat mengupload file media. Informasi tersebut mencakup status pekerjaan upload, konfigurasi kustom, waktu pembuatan pekerjaan, dan waktu penyelesaian pekerjaan.

Jika upload gagal, Anda dapat melihat kode kesalahan dan pesan kesalahan. Jika upload berhasil, Anda akan memperoleh ID video.

Batas QPS

Operasi ini dapat dipanggil hingga 100 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas tersebut, 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 untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Contoh	Deskripsi
Action	String	Yes	GetURLUploadInfos	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke GetURLUploadInfos.
JobIds	String	No	86c1925fba0**,7afb201e7fa,2cc4997378**	Satu atau beberapa ID pekerjaan upload. Anda dapat memperoleh ID pekerjaan tersebut dari parameter respons JobId pada operasi UploadMediaByURL. Anda dapat menentukan maksimal 10 ID. Pisahkan beberapa ID dengan koma (,). Catatan Anda harus menetapkan salah satu dari parameter JobIds atau UploadURLs. Jika Anda menetapkan kedua parameter tersebut, hanya nilai parameter JobIds yang berlaku.
UploadURLs	String	No	http://****.mp4	Satu atau beberapa URL upload file sumber. Pisahkan beberapa URL dengan koma (,). Anda dapat menentukan maksimal 10 URL. Catatan Anda harus encode URL sebelum menggunakannya. Jika file media diupload beberapa kali, cukup berikan URL file media tersebut sekali saja ke parameter ini. Anda harus menetapkan salah satu dari parameter JobIds atau UploadURLs. Jika Anda menetapkan kedua parameter tersebut, hanya nilai parameter JobIds yang berlaku.

Parameter respons

Parameter	Type	Contoh	Deskripsi
RequestId	String	25818875-5F78-4AF6-D7393642CA58****	ID permintaan.
NonExists	Array of String	["**1", "**2"]	ID pekerjaan atau URL upload yang tidak ada.
URLUploadInfoList	Array of UrlUploadJobInfoDTO		Informasi tentang pekerjaan upload berbasis URL. Untuk informasi selengkapnya, lihat bagian "URLUploadInfo: informasi tentang pekerjaan upload berbasis URL" dalam topik Struktur dasar.
CreationTime	String	2019-01-01T01:01:01Z	Waktu pembuatan pekerjaan upload. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
Status	String	SUCCESS	Status pekerjaan upload berbasis URL. Untuk informasi selengkapnya tentang nilai yang valid dan deskripsi nilainya, lihat bagian "Status: status video" dalam topik Struktur dasar.
ErrorMessage	String	error_message	Pesan kesalahan yang dikembalikan.
ErrorCode	String	200	Kode kesalahan yang dikembalikan.
CompleteTime	String	2019-01-01T01:11:01Z	Waktu penyelesaian pekerjaan upload. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
JobId	String	86c1925fba0****	ID pekerjaan upload.
UserData	String	{"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}	Konfigurasi kustom. Nilainya berupa string JSON. Untuk informasi selengkapnya, lihat bagian "UserData: menentukan konfigurasi kustom untuk upload media" dalam topik Parameter permintaan.
UploadURL	String	http://****.mp4	URL upload file sumber. Catatan Maksimal 100 URL dapat dikembalikan.
MediaId	String	93ab850b4f6f54b6e91d24d81d4****	ID file media yang diupload.
FileSize	String	24	Ukuran file media yang diupload. Satuan: byte.

Contoh

Contoh permintaan

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetURLUploadInfos
&JobIds=86c1925fba0****,7afb201e7fa****,2cc4997378****
&<Common request parameters>

Contoh respons sukses

XML format

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

<GetURLUploadInfosResponse>
    <RequestId>25818875-5F78-4AF6-D7393642CA58****</RequestId>
    <NonExists>["****1", "****2"]</NonExists>
    <URLUploadInfoList>
      <UrlUploadJobInfoDTO>
        <CreationTime>2019-01-01T01:01:01Z</CreationTime>
        <Status>SUCCESS</Status>
        <ErrorMessage>error_message</ErrorMessage>
        <ErrorCode>200</ErrorCode>
        <CompleteTime>2019-01-01T01:11:01Z</CompleteTime>
        <JobId>86c1925fba0****</JobId>
        <UserData>{"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}</UserData>
        <UploadURL>http://****.mp4</UploadURL>
        <MediaId>93ab850b4f6f54b6e91d24d81d4****</MediaId>
        <FileSize>24</FileSize>
      </UrlUploadJobInfoDTO>
    </URLUploadInfoList>
</GetURLUploadInfosResponse>

JSON format

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

{
  "RequestId" : "25818875-5F78-4AF6-D7393642CA58****",
  "NonExists" : [ "[\"****1\", \"****2\"]" ],
  "URLUploadInfoList" : [ {
    "CreationTime" : "2019-01-01T01:01:01Z",
    "Status" : "SUCCESS",
    "ErrorMessage" : "error_message",
    "ErrorCode" : "200",
    "CompleteTime" : "2019-01-01T01:11:01Z",
    "JobId" : "86c1925fba0****",
    "UserData" : "{\"MessageCallback\":\"{\"CallbackURL\":\"http://example.aliyundoc.com\"}\", \"Extend\":\"{\"localId\":\"***\", \"test\":\"www\"}\"}",
    "UploadURL" : "http://****.mp4",
    "MediaId" : "93ab850b4f6f54b6e91d24d81d4****",
    "FileSize" : "24"
  } ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.