文档首页/ OBS PHP SDK/ API参考/ 对象相关接口/ 初始化分传段任务
更新时间:2021-03-18 GMT+08:00
分享

初始化分传段任务

功能说明

在指定桶中初始化分段上传任务。

方法定义

1. ObsClient->initiateMultipartUpload(array $parameter)
2. ObsClient->initiateMultipartUploadAsync(array $parameter, callable $callback)

请求参数

字段名

类型

约束

说明

Bucket

string

必选

桶名。

Key

string

必选

对象名。

ACL

string

可选

预定义访问策略

StorageClass

string

可选

对象的存储类型

Metadata

associative array

可选

对象的自定义元数据信息。

WebsiteRedirectLocation

string

可选

当桶设置了Website配置,该参数指明对象的重定向地址。

ContentType

string

可选

对象的MIME类型。

SseKms

string

可选

以SSE-KMS方式加密对象,支持的值:

  • kms

SseKmsKey

string

可选

SSE-KMS方式下加密的主密钥,可为空。

SseC

string

可选

以SSE-C方式加密对象,支持的值:

  • AES256

SseCKey

string

可选

SSE-C方式下加密的密钥,由AES256算法得到。

返回结果

字段名

类型

说明

HttpStatusCode

integer

HTTP状态码。

Reason

string

HTTP文本描述。

RequestId

string

OBS服务端返回的请求ID。

Bucket

string

分段上传任务的桶名。

Key

string

分段上传任务的对象名。

UploadId

string

分段上传任务的ID。

SseKms

string

SSE-KMS方式的算法。

SseKmsKey

string

SSE-KMS方式的密钥。

SseC

string

SSE-C方式的算法。

SseCKeyMd5

string

SSE-C方式的密钥的MD5值。

代码样例

try {
       $resp = $obsClient->initiateMultipartUpload( [ 
              'Bucket' => 'bucketname',
              'Key' => 'objectkey',
              'ContentType' => 'text/plain'
       ] );
       printf ( "RequestId:%s\n", $resp ['RequestId'] );
       printf ( "Bucket:%s\n", $resp ['Bucket'] );
       printf ( "Key:%s\n", $resp ['Key'] );
       printf ( "UploadId:%s\n", $resp ['UploadId'] );
} catch ( Obs\Common\ObsException $obsException ) {
       printf ( "ExceptionCode:%s\n", $obsException->getExceptionCode () );
       printf ( "ExceptionMessage:%s\n", $obsException->getExceptionMessage () );
}

相关文档