上传文件（Object） - 混合云OpenAPI4.0

请求参数

Body 参数application/json

bucket

string

存储空间名

必需

regionID

string

资源池id

必需

key

string

文件key

必需

append

boolean

可选

是否以追加模式上传Object

appendPosition

integer <int32>

可选

追加模式下，指定追加的位置

acl

string

可选

Object的访问控制

body

string

可选

上传对象的内容，可以为文件流或字节流，不传递此参数默认为0字节内容

otherParams

object

其他相关设置

可选

cacheControl

string

缓存指令

可选

contentDisposition

string

文件名称

可选

contentEncoding

string

编码格式

可选

contentLanguage

string

编码语言

可选

contentLength

integer <int32>

可选

用于描述HTTP消息体的传输大小

contentType

string

编码格式

可选

expires

string

可选

缓存内容的绝对过期时间

grantFullControl

string

可选

赋予指定账户对存储桶的读写权限

grantRead

string

可选

赋予指定账户对存储桶的读权限

serverSideEncryption

string

服务器端加密规则

可选

storageClass

string

存储类型

可选

示例

{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "key": "ces2.txt",
    "acl": "private",
    "body": 1,
    "append": false,
    "otherParams": {
        "contentType": "utf-8"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/v4/oss/put-object' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "key": "ces2.txt",
    "acl": "private",
    "body": 1,
    "append": false,
    "otherParams": {
        "contentType": "utf-8"
    }
}'

返回响应

🟢200successful operation

application/json

Body

returnObj

array [object {2}]

响应

可选

bucket

string

可选

key

string

文件key

可选

statusCode

integer <int32>

可选

请求状态码 800-成功 900-失败

description

string

描述

可选

errorCode

string

错误码

可选

message

string

错误说明

可选

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": [
        {}
    ],
    "statusCode": 800
}