文档首页/ OBS PHP SDK/ API参考/ 桶相关接口/ 列举桶内分段上传任务
更新时间:2022-02-10 GMT+08:00

列举桶内分段上传任务

功能说明

列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。

方法定义

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());
}