初始化分传段任务
功能说明
在指定桶中初始化分段上传任务。
方法定义
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 () );
} 
