列举桶内分段上传任务
功能说明
列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。
方法定义
1. ObsClient->listMultipartUploads(array $parameter) 2. ObsClient->listMultipartUploadsAsync(array $parameter, callable $callback)
请求参数
|
字段名 |
类型 |
约束 |
说明 |
|---|---|---|---|
|
Bucket |
string |
必选 |
桶名。 |
|
Delimiter |
string |
可选 |
用于对分段上传任务中的对象名进行分组的字符。对于对象名中包含Delimiter的任务，其对象名（如果请求中指定了Prefix，则此处的对象名需要去掉Prefix）中从首字符至第一个Delimiter之间的字符串将作为一个分组并作为CommonPrefix返回。 |
|
Prefix |
string |
可选 |
限定返回的分段上传任务中的对象名必须带有Prefix前缀。 |
|
MaxUploads |
integer |
可选 |
列举分段上传任务的最大数目，取值范围为1~1000，当超出范围时，按照默认的1000进行处理。 |
|
KeyMarker |
string |
可选 |
表示列举时返回指定的KeyMarker之后的分段上传任务。 |
|
UploadIdMarker |
string |
可选 |
只有与KeyMarker参数一起使用时才有意义，用于指定返回结果的起始位置，即列举时返回指定KeyMarker的UploadIdMarker之后的分段上传任务。 |
返回结果
|
字段名 |
类型 |
说明 |
||
|---|---|---|---|---|
|
HttpStatusCode |
integer |
HTTP状态码。 |
||
|
Reason |
string |
HTTP文本描述。 |
||
|
RequestId |
string |
OBS服务端返回的请求ID。 |
||
|
Bucket |
string |
桶名。 |
||
|
KeyMarker |
string |
列举分段上传任务的起始位置，与请求中的该参数对应。 |
||
|
UploadIdMarker |
string |
列举分段上传任务的起始位置（UploadId标识），与请求中的该参数对应。 |
||
|
NextKeyMarker |
string |
下次列举分段上传任务请求的起始位置。 |
||
|
NextUploadIdMarker |
string |
下次列举分段上传任务请求的起始位置（UploadId标识），与NextKeyMarker配合使用。 |
||
|
Delimiter |
string |
用于对分段上传任务中的对象名进行分组的字符，与请求中的该参数对应。 |
||
|
Prefix |
string |
分段上传任务中的对象名前缀，与请求中的该参数对应。 |
||
|
MaxUploads |
integer |
列举分段上传任务的最大数目，与请求中的该参数对应。 |
||
|
IsTruncated |
boolean |
表明本次请求是否返回了全部结果，“true”表示没有返回全部结果；“false”表示已返回了全部结果。 |
||
|
Uploads |
indexed array |
分段上传任务列表。 |
||
|
Key |
string |
分段上传任务的对象名。 |
||
|
UploadId |
string |
分段上传任务的ID。 |
||
|
Initiator |
associative array |
分段上传任务的创建者。 |
||
|
ID |
string |
创建者的DomainId。 |
||
|
Owner |
associative array |
和Initiator相同，代表分段上传任务的创建者。 |
||
|
ID |
string |
创建者的DomainId。 |
||
|
Initiated |
string |
分段上传任务的初始化时间。 |
||
|
StorageClass |
string |
分段上传对象的存储类型。 |
||
|
CommonPrefixes |
indexed array |
当请求中设置了Delimiter分组字符时，返回按Delimiter分组后的对象名称前缀列表。 |
||
|
Prefix |
string |
按Delimiter分组后的对象名称前缀。 |
||
代码样例
try{
$resp = $obsClient -> listMultipartUploads([
'Bucket' => 'bucketname',
'Prefix' => 'prefix',
'MaxUploads' => 100
]);
printf("RequestId:%s\n", $resp['RequestId']);
foreach ($resp['Uploads'] as $index => $upload){
printf("Versions[%d]\n", $index + 1);
printf("UploadId:%s\n", $upload['UploadId']);
printf("Initiated:%s\n", $upload['Initiated']);
printf("StorageClass:%s\n", $upload['StorageClass']);
printf("Key:%s\n", $upload['Key']);
printf("Initiator[ID]:%s\n", $upload['Initiator']['ID']);
printf("Initiator[DisplayName]:%s\n", $upload['Initiator']['DisplayName']);
printf("Owner[ID]:%s\n", $upload['Owner']['ID']);
printf("Owner[DisplayName]:%s\n", $upload['Owner']['DisplayName']);
}
}catch (Obs\Common\ObsException $obsException){
printf("ExceptionCode:%s\n", $obsException->getExceptionCode());
printf("ExceptionMessage:%s\n", $obsException->getExceptionMessage());
}
