PutObject_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

注意事项

添加的 Object 大小不能超过 5 GB。
默认情况下，如果已存在同名 Object 且对该 Object 有访问权限，则新添加的 Object 将覆盖原有的 Object，并返回 200 OK。
OSS 没有文件夹的概念，所有资源都是以文件来存储，但您可以通过创建一个以正斜线（/）结尾，大小为 0 的 Object 来创建模拟文件夹。

版本控制

在已开启版本控制的 Bucket 中，OSS 会为新添加的 Object 自动生成唯一的版本 ID，并在响应 Header 中通过 x-oss-version-id 形式返回。
在暂停了版本控制的 Bucket 中，新添加的 Object 的版本 ID 为 null。OSS 会保证同一个 Object 仅有一个 null 的版本 ID。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:PutObject	Create	Object acs:oss:oss-{#regionId}:{#accountId}:{#BucketName}/{#ObjectName}	oss:RequestObjectTag acs:UserAgent acs:AccessId oss:BucketTag oss:DataAccessPointArn oss:AccessPointNetworkOrigin oss:DataAccessPointAccount oss:TLSVersion oss:x-oss-object-acl oss:x-oss-server-side-data-encryption oss:x-oss-server-side-encryption oss:x-oss-server-side-encryption-key-id	oss:DeleteObject oss:PutObjectTagging oss:GetObject

请求语法

PUT /{key} HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-forbid-overwrite: boolean
x-oss-server-side-encryption: string
x-oss-server-side-data-encryption: string
x-oss-server-side-encryption-key-id: string
x-oss-object-acl: string
x-oss-storage-class: string
x-oss-tagging: string
x-oss-meta-*: object

路径参数

字段名称	字段详情
keystring	Object 的完整路径。示例值:exampledir/exampleobject/txt

请求参数

字段名称	字段详情
bucketstring	Bucket 名称。示例值:examplebucket
x-oss-forbid-overwriteboolean	指定 PutObject 操作时是否覆盖同名 Object。当目标 Bucket 处于已开启或已暂停的版本控制状态时，x-oss-forbid-overwrite请求 Header 设置无效，即允许覆盖同名 Object。展开详情示例值:false
x-oss-server-side-encryptionstring	创建 Object 时，指定服务器端加密方式。展开详情示例值:AES256
x-oss-server-side-data-encryptionstring	创建 Object 时，指定服务器端加密方式。展开详情示例值:AES256
x-oss-server-side-encryption-key-idstring	KMS 托管的用户主密钥。展开详情示例值:9468da86-3509-4f8d-a61e-6eab1eac****
x-oss-object-aclObjectACL	指定 OSS 创建 Object 时的访问权限。展开详情示例值:public-read枚举值:privatepublic-readpublic-read-writedefault
x-oss-storage-classStorageClass	Bucket 的存储类型。取值范围如下：展开详情示例值:Standard枚举值:ArchiveColdArchiveIAStandard
x-oss-taggingstring	指定 Object 的标签，可同时设置多个标签，例如 TagA=A&TagB=B。展开详情示例值:a:1
x-oss-meta-*map<string>	使用 PutObject 接口时，如果配置以x-oss-meta-*为前缀的参数，则该参数视为元数据，例如`x-oss-meta-location`。一个 Object 可以有多个类似的参数，但所有的元数据总大小不能超过 8 KB。展开详情示例值:x-oss-meta-location
bodystring<binary>	请求体。示例值:二进制内容

变更历史

暂无变更历史

PutObject_对象存储_API文档

接口说明

流控信息

授权信息

请求语法

路径参数

请求参数

变更历史

相关示例