初始化分传段任务

功能说明

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

方法定义

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类型，常见的contentType（MIME）列表参见配置、编辑、查看对象元数据。
SseKms	string	可选	以SSE-KMS方式加密对象，支持的值： kms
SseKmsKey	string	可选	SSE-KMS加密方式下使用的KMS主密钥的ID值，为空则默认配置为默认密钥。密钥ID获取方法请参见查看密钥。
SseC	string	可选	以SSE-C方式加密对象，支持的值： AES256
SseCKey	string	可选	SSE-C方式下加密的密钥，该密钥需要您自定义，并由256bit的密钥经过base64编码得到。

返回结果

字段名	类型	说明
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加密方式下使用的KMS主密钥的ID值，为空则默认配置为默认密钥。密钥ID获取方法请参见查看密钥。
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 () );
}