GetURLUploadInfos - 擷取URL上傳資訊 -

擷取URL上傳資訊。

介面說明

通過 URL 上傳時返回的 JobId 或者上傳時使用的 URL 來擷取 URL 上傳資訊，包括 URL 上傳狀態、UserData、建立時間、完成時間等。
本介面僅支援查詢一年內的上傳任務資料。
本介面目前服務地址僅支援：華東 2（上海）、新加坡。
調用 UploadMediaByURL 介面將媒資檔案上傳到ApsaraVideo for VOD中後，可調用本介面通過 URL 拉取上傳任務 ID（JobIds）或者媒體源檔案 URL（UploadURLs）來查詢指定媒體檔案的上傳資訊。
調用本介面時，JobIds和UploadURLs必須傳入一個，二者同時傳入時只處理JobIds。
如果媒資上傳失敗，調用本介面可以查看錯誤碼和錯誤資訊；如果媒資上傳成功，調用本介面可以查看對應的媒資 ID。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:GetURLUploadInfos

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
JobIds	string	否	上傳任務 ID（JobId）列表。由一個或多個 JobId 組成，JobId 為通過 UploadMediaByURL 介面上傳時，返回參數 JobId 的值。最多支援 10 個 ID。多個 ID 之間使用半形逗號（,）分隔。說明 JobIds 和 UploadURLs 必須指定一個，二者同時傳入時只處理 JobIds。	86c1925fba0**,7afb201e7fa,2cc4997378**
UploadURLs	string	否	上傳視頻源檔案 URL 列表。多個 URL 之間使用半形逗號（,）分隔，最多支援 10 個。說明使用前，先進行 URL 編碼。如果同一 URL 視頻多次上傳，建議傳入單個 URL 進行查詢。 JobIds 和 UploadURLs 必須指定一個，二者同時傳入時只處理 JobIds。	http://****.mp4

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	25818875-5F78-4AF6-D7393642CA58****
NonExists	array	不存在的 URL 上傳任務 ID 或 URL 列表。
	string	不存在的 URL 上傳任務 ID 或 URL 列表。	["**1", "**2"]
URLUploadInfoList	array<object>	URL 上傳資訊列表。具體上傳名稱及描述，請參見URLUploadInfo：URL 上傳資訊。
	object	URL 上傳資訊詳情。
CreationTime	string	建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2019-01-01T01:01:01Z
Status	string	URL 拉取任務狀態。具體的拉取狀態取值及說明，請參見Status：URL 上傳任務狀態。	SUCCESS
ErrorMessage	string	錯誤資訊。	error_message
ErrorCode	string	錯誤碼。	200
CompleteTime	string	完成時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。	2019-01-01T01:11:01Z
JobId	string	上傳任務 ID。	86c1925fba0****
UserData	string	自訂設定。為 JSON 字串。更多資訊，請參見 UserData 。	{"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}
UploadURL	string	上傳視頻源檔案 URL。說明最多可以返回 100 條記錄。	http://****.mp4
MediaId	string	媒體 ID。	93ab850b4f6f54b6e91d24d81d4****
FileSize	string	檔案大小。單位：位元組。	24

樣本

正常返回樣本

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"
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。