GetURLUploadInfos - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Vous pouvez consulter les informations d'une tâche de téléchargement basée sur une URL en spécifiant l'URL de téléchargement ou en utilisant l'ID de la tâche renvoyé lors du chargement des fichiers multimédias. Ces informations incluent le statut de la tâche, les configurations personnalisées, l'heure de création ainsi que l'heure de fin de la tâche.

En cas d'échec du téléchargement, vous pouvez consulter le code et le message d'erreur. Si le téléchargement réussit, vous obtenez l'ID de la vidéo.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation (throttling) se déclenche, ce qui peut affecter votre activité. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limites QPS des opérations API dans ApsaraVideo VOD.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	GetURLUploadInfos	L'opération que vous souhaitez effectuer. Définissez la valeur sur GetURLUploadInfos.
JobIds	String	No	86c1925fba0**,7afb201e7fa,2cc4997378**	Les ID des tâches de téléchargement. Vous pouvez obtenir ces ID dans le paramètre de réponse JobId de l'opération UploadMediaByURL. Vous pouvez spécifier au maximum 10 ID. Séparez plusieurs ID par des virgules (,). Remarque Vous devez définir l'un des paramètres JobIds ou UploadURLs. Si vous définissez les deux paramètres JobIds et UploadURLs, seule la valeur du paramètre JobIds est prise en compte.
UploadURLs	String	No	http://****.mp4	Les URL de téléchargement des fichiers sources. Séparez plusieurs URL par des virgules (,). Vous pouvez spécifier au maximum 10 URL. Remarque Vous devez encoder les URL avant de les utiliser. Si un fichier multimédia est chargé plusieurs fois, transmettez l'URL du fichier multimédia à ce paramètre une seule fois. Vous devez définir l'un des paramètres JobIds ou UploadURLs. Si vous définissez les deux paramètres JobIds et UploadURLs, seule la valeur du paramètre JobIds est prise en compte.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	25818875-5F78-4AF6-D7393642CA58****	L'ID de la requête.
NonExists	Array of String	["**1", "**2"]	Les ID de tâche ou les URL de téléchargement qui n'existent pas.
URLUploadInfoList	Array of UrlUploadJobInfoDTO		Les informations relatives aux tâches de téléchargement basées sur une URL. Pour plus d'informations, consultez la section « URLUploadInfo : informations relatives à une tâche de téléchargement basée sur une URL » de la rubrique Structures de base.
CreationTime	String	2019-01-01T01:01:01Z	L'heure de création de la tâche de téléchargement. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
Status	String	SUCCESS	Le statut de la tâche de téléchargement basée sur une URL. Pour plus d'informations sur les valeurs valides et la description des valeurs du paramètre, consultez la section « Status : statut d'une vidéo » de la rubrique Structures de base.
ErrorMessage	String	error_message	Le message d'erreur renvoyé.
ErrorCode	String	200	Le code d'erreur renvoyé.
CompleteTime	String	2019-01-01T01:11:01Z	L'heure de fin de la tâche de téléchargement. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
JobId	String	86c1925fba0****	L'ID de la tâche de téléchargement.
UserData	String	{"MessageCallback":"{"CallbackURL":"http://example.aliyundoc.com"}", "Extend":"{"localId":"***", "test":"www"}"}	Les configurations personnalisées. La valeur est une chaîne JSON. Pour plus d'informations, consultez la section « UserData : spécifie les configurations personnalisées pour le chargement de médias » de la rubrique Paramètres de requête.
UploadURL	String	http://****.mp4	L'URL de téléchargement du fichier source. Remarque Un maximum de 100 URL peut être renvoyé.
MediaId	String	93ab850b4f6f54b6e91d24d81d4****	L'ID du fichier multimédia chargé.
FileSize	String	24	La taille du fichier multimédia chargé. Unité : octet.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.