Tous les produits
Search
Centre de documentation

:GetUserUploadFileJob

Dernière mise à jour :Aug 09, 2026

Interroge les informations relatives à une tâche de chargement de fichier.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la 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
JobKey String Yes 65254a49100e

La clé de la tâche de chargement de fichier. Appelez l'opération CreateUploadFileJob ou CreateUploadOSSFileJob pour interroger la clé.

Tid Long No -1

L'ID du locataire.

Remarque Pour afficher l'ID du locataire, placez le pointeur sur la photo de profil dans le coin supérieur droit de la console Data Management (DMS). Pour plus d'informations, consultez la section « View information about the current tenant » de la rubrique Manage DMS tenants.
RegionId String No cn-hangzhou

L'ID de la région où réside le service DMS. Pour plus d'informations sur les valeurs valides de ce paramètre, consultez RegionID parameter.

Remarque Définissez ce paramètre sur l'ID de la région proche de vos applications.

Paramètres de réponse

Parameter Type Example Description
RequestId String BDEFE9F2-B3B4-42D0-83AE-ECF9FC067DCD

L'ID de la requête.

Success Boolean true

Indique si la requête a abouti.

ErrorMessage String UnknownError

Le message d'erreur renvoyé.

ErrorCode String UnknownError

Le code d'erreur renvoyé.

UploadFileJobDetail object

Les détails de la tâche de chargement de fichier.

JobKey String 65254a4c1614235217749100e

La clé de la tâche de chargement de fichier.

FileName String test.sql

Le nom du fichier.

FileSize Long 2968269

La taille du fichier. Unité : octet.

FileSource String datacorrect

L'objectif du fichier chargé. Valeurs valides :

  • datacorrect : Le fichier est chargé pour modifier des données.
  • order_info_attachment : Le fichier est chargé en tant que pièce jointe dans un ticket.
  • big-file : Le fichier est chargé pour importer plusieurs enregistrements de données à la fois.
  • sqlreview : Le fichier est chargé pour l'examen SQL.
UploadType String URL

La méthode utilisée pour charger le fichier. Valeurs valides :

  • URL
  • OSS
UploadURL String http://xxxx/test.sql

L'URL du fichier.

Remarque Ce paramètre est renvoyé si le paramètre UploadType est défini sur URL.
UploadOSSParam object

Les informations relatives au bucket Object Storage Service (OSS) à partir duquel le fichier est chargé.

Remarque Ce paramètre est renvoyé si le paramètre UploadType est défini sur OSS.
Endpoint String http://oss-cn-hangzhou.aliyuncs.com

Le point de terminaison du bucket OSS.

BucketName String test_bucket

Le nom du bucket OSS.

ObjectName String test.sql

Le nom de l'objet OSS.

UploadedSize Long 2968269

La taille du fichier chargé. Unité : octet.

JobStatus String SUCCESS

L'état de la tâche de chargement de fichier. Valeurs valides :

  • INIT : La tâche a été initialisée.
  • PENDING : La tâche attendait d'être exécutée.
  • BE_SCHEDULED : La tâche attendait d'être planifiée.
  • FAIL : La tâche a échoué.
  • SUCCESS : La tâche s'est déroulée comme prévu.
  • RUNNING : La tâche était en cours d'exécution.
JobStatusDesc String success

Les informations relatives à l'état de la tâche de chargement de fichier.

AttachmentKey String upload_3c7edea3-e4c3-4403-857d-737043036f69_test.sql

La clé du fichier renvoyée après le chargement du fichier. Utilisez cette clé lorsque vous chargez le fichier en tant que pièce jointe dans un ticket.

Exemples

Exemple de requête

http(s)://dms-enterprise.aliyuncs.com/?JobKey=65254a4c1614235217749100e
&Tid=-1
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<GetUserUploadFileJobResponse>
    <RequestId>22FFF57C-6E85-4C3D-90AF-C1BFE79E1FAF</RequestId>
    <UploadFileJobDetail>
        <JobStatus>INIT</JobStatus>
        <JobKey>7000005000007000009000000</JobKey>
        <UploadURL>https://dbxxx.oss-cn-hangzhou.aliyuncs.com/dm/1.txt</UploadURL>
        <UploadedSize>0</UploadedSize>
        <JobStatusDesc/>
        <FileSource>datacorrect</FileSource>
        <FileName>1.txt</FileName>
        <UploadType>URL</UploadType>
        <FileSize>-1</FileSize>
    </UploadFileJobDetail>
    <Success>true</Success>
</GetUserUploadFileJobResponse>

JSON format

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

{
  "RequestId" : "22FFF57C-6E85-4C3D-90AF-C1BFE79E1FAF",
  "UploadFileJobDetail" : {
    "JobStatus" : "INIT",
    "JobKey" : "7000005000007000009000000",
    "UploadURL" : "https://dbxxx.oss-cn-hangzhou.aliyuncs.com/dm/1.txt",
    "UploadedSize" : 0,
    "JobStatusDesc" : "",
    "FileSource" : "datacorrect",
    "FileName" : "1.txt",
    "UploadType" : "URL",
    "FileSize" : -1
  },
  "Success" : true
}

Codes d'erreur

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