GetURLUploadInfos - - Alibaba Cloud ドキュメントセンター

URLベースのアップロードジョブに関する情報を照会します。

使用上の注意

アップロードURLを指定するか、メディアファイルのアップロード時に返されるジョブIDを使用して、URLベースのアップロードジョブに関する情報を照会できます。情報には、アップロードジョブのステータス、カスタム設定、ジョブが作成された時刻、およびジョブが完了した時刻が含まれます。

アップロードが失敗した場合は、エラーコードとエラーメッセージを表示できます。アップロードが成功した場合、ビデオIDを取得できます。

QPS制限

この操作は、アカウントごとに1秒あたり最大100回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。その結果、あなたのビジネスが影響を受ける可能性があります。この操作を呼び出すときは、制限に注意することをお勧めします。詳細については、「ApsaraVideo VODのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	データ型	必須／任意	例	説明
操作	String	必須	GetURLUploadInfos	実行する操作です。値をGetURLUploadInfosに設定します。
ジョブ	String	任意	86c1925fba0 **,7afb201e7fa ,2cc4997378 **	アップロードジョブの1つ以上のID。ジョブIDは、UploadMediaByURL操作の応答パラメーターJobIdで取得できます。最大10個のIDを指定できます。 ID が複数ある場合は、カンマ (,) で区切ります。説明 JobIdsパラメーターとUploadURLパラメーターのいずれかを設定する必要があります。 JobIdsパラメーターとUploadURLパラメーターの両方を設定した場合、JobIdsパラメーターの値のみが有効になります。
UploadURL	String	任意	http:// ****.mp4	ソースファイルの1つ以上のアップロードURL。複数のURLはコンマ (,) で区切ります。最大10個のURLを指定できます。説明 You must encode the URLs before you use the URLs. メディアファイルを複数回アップロードする場合は、メディアファイルのURLをこのパラメーターに1回だけ渡します。 JobIdsパラメーターとUploadURLパラメーターのいずれかを設定する必要があります。 JobIdsパラメーターとUploadURLパラメーターの両方を設定した場合、JobIdsパラメーターの値のみが有効になります。

レスポンスパラメーター

パラメーター	データ型	例	説明
RequestId	String	25818875-5F78-4AF6-D7393642CA58 ****	リクエストの ID です。
非存在	文字列の配列	["** 1" 、"** 2"]	存在しないジョブIDまたはアップロードURL。
URLUploadInfoList	UrlUploadJobInfoDTOの配列		URLベースのアップロードジョブに関する情報。詳細については、基本構造の「URLUploadInfo: URLベースのアップロードジョブに関する情報」セクションを参照してください。
CreationTime	String	2019-01-01T01:01:01Z	アップロードジョブが作成された時刻。日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。時刻は UTC 表示です。
ステータス	String	SUCCESS	URLベースのアップロードジョブのステータス。パラメーターの有効な値と値の説明の詳細については、基本構造の「ステータス: ビデオのステータス」セクションを参照してください。
ErrorMessage	String	error_message	返されたエラーメッセージ。
ErrorCode	String	200	The error code returned.
CompleteTime	String	2019-01-01T01:11:01Z	アップロードジョブが完了した時刻。日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。時刻は UTC 表示です。
JobId	String	86c1925fba0 ****	アップロードジョブのID。
UserData	String	{"MessageCallback":"{" CallbackURL ":" http://example.aliyundoc.com "}", "Extend":"{" localId ":" *** ", " test ":" www "}"}	The custom configurations. 値はJSON文字列です。詳細については、「リクエストパラメーター」トピックの「UserData: メディアアップロードのカスタム設定を指定する」セクションをご参照ください。
UploadURL	String	http:// ****.mp4	ソースファイルのアップロードURL。説明最大100個のURLを返すことができます。
MediaId	String	93ab850b4f6f54b6e91d24d81d4 ****	アップロードされたメディアファイルのID。
FileSize	String	24	アップロードされたメディアファイルのサイズ。単位: バイト。

例

リクエストの例

http(s):// vod.cn-shanghai.aliyuncs.com/?Action=GetURLUploadInfos
&JobIds=86c1925fba0 ****,7afb201e7fa ****,2cc4997378 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

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 形式

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

{
  "RequestId" : "25818875-5F78-4AF6-D7393642CA58 ****" 、
  "NonExists" : [ "[\" **** 1\", \" **** 2\"]"]],
  "URLUploadInfoList" : [ {
    "CreationTime" : "2019-01-01T01:01:01Z" 、
    "ステータス" : "成功" 、
    "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"
  } ]
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。