initiate-multipart-upload

initiate-multipart-upload用于通知OSS初始化一个Multipart Upload事件。

注意事项

  • 阿里云账号默认拥有通知OSS初始化一个Multipart Upload事件的权限。如果您需要通过RAM用户或者STS的方式进行通知,您必须拥有oss:PutObject权限。具体操作,请参见RAM用户授权自定义的权限策略

  • 调用接口会返回一个OSS服务器创建的全局唯一的Upload ID,用于标识本次Multipart Upload事件。您可以根据这个ID来发起相关的操作,例如中止Multipart Upload、查询Multipart Upload等。

  • 初始化MultipartUpload请求,并不影响已存在的同名Object。

命令格式

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。

说明

使用示例

  • 通知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 --object-acl private --storage-class IA
  • 通知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"