列举已上传的段
功能说明
通过分段上传任务的ID，列举指定桶中已上传的段。
方法定义
1. ObsClient->listParts(array $parameter) 2. ObsClient->listPartsAsync(array $parameter, callable $callback)
请求参数
字段名 |
类型 |
约束 |
说明 |
|---|---|---|---|
Bucket |
string |
必选 |
桶名。 |
Key |
string |
必选 |
对象名。 |
UploadId |
string |
必选 |
分段上传任务的ID。 |
MaxParts |
integer |
可选 |
列举已上传段的返回结果最大段数目，即分页时每一页中段数目。 |
PartNumberMarker |
integer |
可选 |
列举已上传段的起始位置，只有Part Number大于该参数的段会被列出。 |
返回结果
字段名 |
类型 |
说明 |
|
|---|---|---|---|
HttpStatusCode |
integer |
HTTP状态码。 |
|
Reason |
string |
HTTP文本描述。 |
|
RequestId |
string |
OBS服务端返回的请求ID。 |
|
Bucket |
string |
桶名。 |
|
Key |
string |
对象名。 |
|
UploadId |
string |
分段上传任务的ID。 |
|
PartNumberMarker |
string |
列举已上传段的起始位置，与请求中的该参数对应。 |
|
NextPartNumberMarker |
string |
下次列举已上传段请求的起始位置。 |
|
MaxParts |
string |
列举已上传段的返回结果最大段数目，与请求中的该参数对应。 |
|
IsTruncated |
boolean |
表明本次请求是否返回了全部结果，“true”表示没有返回全部结果；“false”表示已返回了全部结果。 |
|
Parts |
indexed array |
已上传段列表。 |
|
PartNumber |
integer |
段号。 |
|
LastModified |
string |
段的最后上传时间。 |
|
ETag |
string |
段的ETag值。 |
|
Size |
integer |
段的大小。 |
|
Initiator |
associative array |
分段上传任务的创建者。 |
|
ID |
string |
创建者的DomainId。 |
|
DisplayName |
string |
创建者的名字。 |
|
Owner |
associative array |
和Initiator相同，代表分段上传任务的创建者。 |
|
ID |
string |
创建者的DomainId。 |
|
DisplayName |
string |
创建者的名字。 |
|
StorageClass |
string |
待分段上传对象的存储类型。 |
|
代码样例
try {
$resp = $obsClient->listParts( [
'Bucket' => 'bucketname',
'Key' => 'objectkey',
'UploadId' => 'uploadid',
'MaxParts' => 10
] );
printf ( "RequestId:%s\n", $resp ['RequestId'] );
printf ( "Initiator[ID]:%s\n", $resp ['Initiator']['ID'] );
printf ( "Initiator[DisplayName]:%s\n", $resp ['Initiator']['DisplayName'] );
foreach ($resp['Parts'] as $index => $part){
printf("Parts[%d]\n", $index + 1);
printf ( "PartNumber:%s\n", $part['PartNumber'] );
printf ( "LastModified:%s\n", $part['LastModified'] );
printf ( "ETag:%s\n", $part['ETag'] );
printf ( "Size:%s\n", $part['Size'] );
}
} catch ( Obs\Common\ObsException $obsException ) {
printf ( "ExceptionCode:%s\n", $obsException->getExceptionCode () );
printf ( "ExceptionMessage:%s\n", $obsException->getExceptionMessage () );
}
