initiate-multipart-upload用于通知OSS初始化一个Multipart Upload事件。
注意事项
调用接口会返回一个OSS服务器创建的全局唯一的Upload ID，用于标识本次Multipart Upload事件。您可以根据这个ID来发起相关的操作，例如中止Multipart Upload、查询Multipart Upload等。
初始化MultipartUpload请求，并不影响已存在的同名Object。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。
API | Action | 说明 |
InitiateMultipartUpload |
| 初始化分片上传任务。 |
| 初始化分片上传任务时，如果通过x-oss-tagging指定Object的标签，则需要此操作的权限。 | |
| 上传Object时，如果Object的元数据包含X-Oss-Server-Side-Encryption: KMS，则需要这两个操作的权限。 | |
|
命令格式
ossutil api initiate-multipart-upload --bucket value --key value [flags]参数 | 类型 | 说明 |
--bucket | string | Bucket名称。 |
--key | string | Object的完整路径。 |
--encoding-type | string | 指定对返回的内容进行编码，指定编码的类型。 |
--content-encoding | string | 指定该Object被下载时的内容编码格式。 |
--content-type | string | 对象的内容类型。 |
--content-disposition | string | 指定该Object被下载时的名称。 |
--cache-control | string | 指定该Object被下载时的网页的缓存行为。 |
--metadata | stringArray | 指定对象的用户元数据，使用key=value格式，如需要自定义携带的元数据，需配置以x-oss-meta-*为前缀的参数。 |
--server-side-data-encryption | string | 指定Object的加密算法。 |
--server-side-encryption | string | 指定上传该Object的每个part时使用的服务器端加密方式。 |
--server-side-encryption-key-id | string | 表示KMS托管的用户主密钥。 |
--storage-class | string | 指定Object的存储类型。 |
--tagging | string | 指定Object的标签。 |
--expires | string | 过期时间，单位为毫秒。 |
--forbid-overwrite | string | 指定CompleteMultipartUpload操作时是否覆盖同名Object。 |
initiate-multipart-upload命令对应API接口InitiateMultipartUpload。关于API中的具体参数含义，请参见InitiateMultipartUpload。
关于支持的全局命令行选项，请参见支持的全局命令行选项。
使用示例
通知OSS初始化一个Multipart Upload事件。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject通知OSS初始化一个Multipart Upload事件，以JSON格式显示。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json通知OSS初始化一个Multipart Upload事件，以YAML格式显示。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml通知OSS初始化一个Multipart Upload事件，携带自定义元数据。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com通知OSS初始化一个Multipart Upload事件，指定object的标签信息。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B"通知OSS初始化一个Multipart Upload事件，指定object服务器端加密方式。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****通知OSS初始化一个Multipart Upload事件，并禁止覆盖同名Object。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true通知OSS初始化一个Multipart Upload事件，指定该Object被下载时网页的缓存行为。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cach通知OSS初始化一个Multipart Upload事件，指定该Object被下载时的名称。
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"