Répertorie toutes les parties chargées pour un ID de chargement spécifié.
Notes d'utilisation
Les résultats sont triés par ordre croissant des numéros de partie.
Constituez votre liste de parties à partir des numéros de partie et des ETags enregistrés localement, plutôt qu'à partir des réponses ListParts. Les parties peuvent être écrasées accidentellement et des erreurs de transmission réseau peuvent entraîner des incohérences de données. Si des parties sont écrasées, supprimez les parties inutiles avant d'appeler CompleteMultipartUpload. Sans enregistrements locaux, vous ne pouvez pas identifier les parties correctes ni vérifier l'intégrité des données.
Autorisations
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM sous un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via les politiques RAM ou la politique de bucket.
|
API |
Action |
Description |
|
ListParts |
|
Répertorie toutes les parties chargées à l'aide d'un ID de chargement. |
Syntaxe de la requête
Get /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureEn-têtes de requête
Tous les en-têtes d'une requête ListParts sont des en-têtes de requête communs. Pour plus d'informations, consultez En-têtes de requête communs.
Paramètres de requête
|
Paramètre |
Type |
Exemple |
Description |
|
uploadId |
String |
0004B999EF5A239BB9138C6227D6**** |
ID de la tâche de chargement multipartie. Par défaut : vide. |
|
max-parts |
Integer |
1000 |
Nombre maximal de parties à renvoyer. Valeur par défaut : 1000. Valeur maximale : 1000. |
|
part-number-marker |
Integer |
100 |
Répertorie les parties dont les numéros de partie sont supérieurs à cette valeur. Par défaut : vide. |
|
encoding-type |
String |
url |
Type d'encodage du nom de l'objet dans la réponse. XML 1.0 ne peut pas analyser certains caractères de contrôle, tels que ceux dont les valeurs ASCII vont de 0 à 10. Définissez ce paramètre pour encoder les noms d'objets contenant de tels caractères. Par défaut : vide. Valeur valide : url. |
En-têtes de réponse
Tous les en-têtes de la réponse à une requête ListParts sont des en-têtes de réponse communs. Pour plus d'informations, consultez En-têtes de réponse communs.
Éléments de réponse
|
Élément |
Type |
Exemple |
Description |
|
ListPartsResult |
Container |
N/A |
Conteneur racine pour la réponse ListParts. Nœuds enfants : Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated et Part Nœuds parents : aucun |
|
Bucket |
String |
multipart_upload |
Nom du bucket. Nœuds parents : ListPartsResult |
|
EncodingType |
String |
url |
Type d'encodage du nom de l'objet. Renvoyé lorsque encoding-type est spécifié dans la requête. Nœuds parents : ListPartsResult |
|
Key |
String |
multipart.data |
Nom de l'objet. Nœuds parents : ListPartsResult |
|
UploadId |
String |
0004B999EF5A239BB9138C6227D69F95 |
ID de la tâche de chargement. Nœuds parents : ListPartsResult |
|
PartNumberMarker |
Integer |
10 |
Marqueur de numéro de partie spécifié dans la requête. Les parties dont les numéros sont supérieurs à cette valeur sont répertoriées. Nœuds parents : ListPartsResult |
|
NextPartNumberMarker |
Integer |
5 |
Marqueur à utiliser comme part-number-marker dans la requête suivante lorsque les résultats sont tronqués. Nœuds parents : ListPartsResult |
|
MaxParts |
Integer |
1000 |
Nombre maximal de parties dans la réponse. Nœuds parents : ListPartsResult |
|
IsTruncated |
Enumerated string |
false |
Indique si la réponse est tronquée. true : d'autres parties sont disponibles. false : toutes les parties sont renvoyées. Valeurs valides : true et false. Nœuds parents : ListPartsResult |
|
Part |
Container |
N/A |
Conteneur pour les détails de la partie. Nœuds enfants : PartNumber, LastModified, ETag et Size Nœuds parents : ListPartsResult |
|
PartNumber |
Integer |
1 |
Numéro de la partie. Nœuds parents : ListPartsResult.Part |
|
LastModified |
Date |
2012-02-23T07:01:34.000Z |
Heure à laquelle la partie a été chargée. Nœuds parents : ListPartsResult.Part |
|
ETag |
String |
3349DC700140D7F86A0784842780**** |
ETag de la partie chargée. Nœuds parents : ListPartsResult.Part |
|
Size |
Integer |
6291456 |
Taille de la partie chargée. Nœuds parents : ListPartsResult.Part |
Exemples
Exemple de requête
Get /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6**** HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple de réponse réussie
HTTP/1.1 200
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
<Bucket>multipart_upload</Bucket>
<Key>multipart.data</Key>
<UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
<NextPartNumberMarker>5</NextPartNumberMarker>
<MaxParts>1000</MaxParts>
<IsTruncated>false</IsTruncated>
<Part>
<PartNumber>1</PartNumber>
<LastModified>2012-02-23T07:01:34.000Z</LastModified>
<ETag>"3349DC700140D7F86A0784842780****"</ETag>
<Size>6291456</Size>
</Part>
<Part>
<PartNumber>2</PartNumber>
<LastModified>2012-02-23T07:01:12.000Z</LastModified>
<ETag>"3349DC700140D7F86A0784842780****"</ETag>
<Size>6291456</Size>
</Part>
<Part>
<PartNumber>5</PartNumber>
<LastModified>2012-02-23T07:02:03.000Z</LastModified>
<ETag>"7265F4D211B56873A381D321F586****"</ETag>
<Size>1024</Size>
</Part>
</ListPartsResult>SDK OSS
Appelez ListParts avec les SDK OSS suivants :
ossutil
Pour obtenir des informations sur la commande ossutil correspondant à l'opération ListParts, consultez list-parts.