ListMultipartUploads - Object Storage Service - Centre de documentation Alibaba Cloud

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud n'ont aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder des autorisations d'opération via des politiques RAM ou une Bucket Policy.

Syntaxe de la requête

Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

Paramètres de la requête

Parameter	Type	Description
delimiter	String	Caractère utilisé pour regrouper les objets par nom. Si vous spécifiez le paramètre Delimiter dans la requête, la réponse contient l'élément CommonPrefixes. Les objets dont les noms contiennent la même chaîne de caractères, du préfixe jusqu'à la prochaine occurrence du délimiteur, sont regroupés en un seul élément de résultat dans CommonPrefixes.
max-uploads	Integer	Nombre maximal de tâches de chargement fractionné pouvant être renvoyées pour la requête actuelle. Valeur par défaut : 1000. Valeur maximale : 1000.
key-marker	String	Ce paramètre est utilisé conjointement avec le paramètre upload-id-marker pour spécifier la position à partir de laquelle la liste suivante commence. Si le paramètre upload-id-marker n'est pas défini, Object Storage Service (OSS) renvoie toutes les tâches de chargement fractionné dont les noms d'objet sont alphabétiquement postérieurs à la valeur key-marker. Si le paramètre upload-id-marker est défini, la réponse inclut les tâches suivantes : Tâches de chargement fractionné dont les noms d'objet sont alphabétiquement postérieurs à la valeur key-marker Tâches de chargement fractionné dont les noms d'objet sont identiques à la valeur du paramètre key-marker, mais dont les ID de chargement sont supérieurs à la valeur du paramètre upload-id-marker
prefix	String	Préfixe que les noms d'objet renvoyés doivent contenir. Si vous spécifiez un préfixe dans la requête, le préfixe spécifié est inclus dans la réponse. Remarque Vous pouvez utiliser des préfixes pour regrouper et gérer les objets dans les buckets de la même manière que vous gérez un dossier dans un système de fichiers.
upload-id-marker	String	ID de chargement de la tâche de chargement fractionné après laquelle la liste commence. Ce paramètre est utilisé conjointement avec le paramètre key-marker. Si le paramètre key-marker n'est pas défini, OSS ignore le paramètre upload-id-marker. Si le paramètre key-marker est configuré, le résultat de la requête inclut : Tâches de chargement fractionné dont les noms d'objet sont alphabétiquement postérieurs à la valeur key-marker Tâches de chargement fractionné dont les noms d'objet sont identiques à la valeur du paramètre key-marker, mais dont les ID de chargement sont supérieurs à la valeur du paramètre upload-id-marker
encoding-type	String	Type d'encodage du nom de l'objet dans la réponse. Les valeurs de Delimiter, KeyMarker, Prefix, NextKeyMarker et Key peuvent être encodées en UTF-8. Toutefois, la norme XML 1.0 ne permet pas d'analyser les caractères de contrôle, tels que les caractères dont la valeur ASCII (American Standard Code for Information Interchange) est comprise entre 0 et 10. Vous pouvez définir le paramètre encoding-type pour encoder les valeurs de Delimiter, KeyMarker, Prefix, NextKeyMarker et Key dans la réponse. Valeur par défaut : null

Éléments de la réponse

Element	Type	Description
ListMultipartUploadsResult	Container	Conteneur qui stocke la réponse à la requête ListMultipartUpload. Nœuds enfants : Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MaxUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated et Upload Nœuds parents : aucun
Bucket	String	Nom du bucket. Nœuds parents : ListMultipartUploadsResult
EncodingType	String	Méthode utilisée pour encoder le nom de l'objet dans la réponse. Si encoding-type est spécifié dans la requête, les valeurs de ces éléments, notamment Delimiter, KeyMarker, Prefix, NextKeyMarker et Key, sont encodées dans le résultat renvoyé. Nœuds parents : ListMultipartUploadsResult
KeyMarker	String	Nom de l'objet correspondant à la tâche de chargement fractionné après laquelle la liste commence. Nœuds parents : ListMultipartUploadsResult
UploadIdMarker	String	ID de chargement de la tâche de chargement fractionné après laquelle la liste commence. Nœuds parents : ListMultipartUploadsResult
NextKeyMarker	String	Marqueur de nom d'objet dans la réponse pour la requête suivante afin de renvoyer les résultats restants. Nœuds parents : ListMultipartUploadsResult
NextUploadMarker	String	Valeur NextUploadMarker utilisée pour la valeur UploadMarker dans la requête suivante si la réponse ne contient pas tous les résultats requis. Nœuds parents : ListMultipartUploadsResult
MaxUploads	Integer	Nombre maximal de tâches de chargement fractionné renvoyées par OSS. Nœuds parents : ListMultipartUploadsResult
IsTruncated	Enumerated string	Indique si la liste des tâches de chargement fractionné renvoyée dans la réponse est tronquée. Valeur par défaut : false. Valeurs valides : true : Seule une partie des résultats est renvoyée. false : Tous les résultats sont renvoyés. Nœuds parents : ListMultipartUploadsResult
Upload	Container	Conteneur qui stocke les informations sur les tâches de chargement fractionné. Nœuds enfants : Key, UploadId et Initiated Nœuds parents : ListMultipartUploadsResult
Key	String	Nom de l'objet pour lequel une tâche de chargement fractionné a été initiée. Nœuds parents : Upload Remarque Les résultats renvoyés par OSS sont répertoriés par ordre alphabétique croissant des noms d'objet. Plusieurs tâches de chargement fractionné initiées pour télécharger le même objet sont répertoriées par ordre croissant des ID de chargement.
UploadId	String	ID de la tâche de chargement fractionné. Nœuds parents : Upload
Initiated	Date	Heure à laquelle la tâche de chargement fractionné a été initialisée. Nœuds parents : Upload

Exemples

Exemples de requêtes

Get /?uploads  HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemples de réponses

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
Date: Thu, 23 Feb 2012 06:14:27 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
    <Bucket>oss-example</Bucket>
    <KeyMarker></KeyMarker>
    <UploadIdMarker></UploadIdMarker>
    <NextKeyMarker>oss.avi</NextKeyMarker>
    <NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
    <Delimiter></Delimiter>
    <Prefix></Prefix>
    <MaxUploads>1000</MaxUploads>
    <IsTruncated>false</IsTruncated>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>multipart.data</Key>
        <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
        <Initiated>2012-02-23T04:18:23.000Z</Initiated>
    </Upload>
    <Upload>
        <Key>oss.avi</Key>
        <UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
        <Initiated>2012-02-23T06:14:27.000Z</Initiated>
    </Upload>
</ListMultipartUploadsResult>

SDK OSS

Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler l'opération ListMultipartUploads :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération ListMultipartUploads, consultez list-multipart-uploads.