初始化分传段任务
功能说明
在指定桶中初始化分段上传任务。
方法定义
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方式加密对象，支持的值：
|
|
SseKmsKey |
string |
可选 |
SSE-KMS加密方式下使用的KMS主密钥的ID值，为空则默认配置为默认密钥。密钥ID获取方法请参见查看密钥。 |
|
SseC |
string |
可选 |
以SSE-C方式加密对象，支持的值：
|
|
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 () );
}
