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 les 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 requête

Parameter	Type	Description
delimiter	String	Le 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, 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	Le nombre maximal de tâches de chargement en plusieurs parties 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 en plusieurs parties dont les noms d'objet viennent après la valeur key-marker dans l'ordre alphabétique. Si le paramètre upload-id-marker est défini, la réponse inclut les tâches suivantes : Tâches de chargement en plusieurs parties dont les noms d'objet viennent après la valeur key-marker dans l'ordre alphabétique Tâches de chargement en plusieurs parties 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	Le 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	L'ID de chargement de la tâche de chargement en plusieurs parties 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 en plusieurs parties dont les noms d'objet viennent après la valeur key-marker dans l'ordre alphabétique Tâches de chargement en plusieurs parties 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	Le type d'encodage du nom d'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 réponse

Element	Type	Description
ListMultipartUploadsResult	Container	Le 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	Le nom du bucket. Nœuds parents : ListMultipartUploadsResult
EncodingType	String	La méthode utilisée pour encoder le nom d'objet dans la réponse. Si encoding-type est spécifié dans la requête, les valeurs des éléments suivants, notamment Delimiter, KeyMarker, Prefix, NextKeyMarker et Key, sont encodées dans le résultat renvoyé. Nœuds parents : ListMultipartUploadsResult
KeyMarker	String	Le nom de l'objet correspondant à la tâche de chargement en plusieurs parties après laquelle la liste commence. Nœuds parents : ListMultipartUploadsResult
UploadIdMarker	String	L'ID de chargement de la tâche de chargement en plusieurs parties après laquelle la liste commence. Nœuds parents : ListMultipartUploadsResult
NextKeyMarker	String	Le 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	La valeur NextUploadMarker utilisée comme 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	Le nombre maximal de tâches de chargement en plusieurs parties renvoyées par OSS. Nœuds parents : ListMultipartUploadsResult
IsTruncated	Enumerated string	Indique si la liste des tâches de chargement en plusieurs parties 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 cette fois-ci. false : Tous les résultats sont renvoyés. Nœuds parents : ListMultipartUploadsResult
Upload	Container	Le conteneur qui stocke les informations sur les tâches de chargement en plusieurs parties. Nœuds enfants : Key, UploadId et Initiated Nœuds parents : ListMultipartUploadsResult
Key	String	Le nom de l'objet pour lequel une tâche de chargement en plusieurs parties 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 en plusieurs parties initiées pour charger le même objet sont répertoriées par ordre croissant des ID de chargement.
UploadId	String	L'ID de la tâche de chargement en plusieurs parties. Nœuds parents : Upload
Initiated	Date	L'heure à laquelle la tâche de chargement en plusieurs parties a été initialisée. Nœuds parents : Upload

Exemples

Exemple 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

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

Kits SDK OSS

Vous pouvez utiliser les kits SDK OSS pour les langages de programmation suivants afin d'appeler l'opération ListMultipartUploads :

ossutil

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