创建桶

POST

/v4/oss/create-bucket

OperationId：createBucket

AZPolicy为multi-az时不支持storageType为(GLACIER)归档类型

请求参数

Body 参数application/json

regionID

string

资源池id

必需

bucket

string

必需

桶名称（长度3~63;只能有大小写字母、数字、.、-;禁止两个英文句号（.）或英文句号（.）和中划线（-）相邻;禁止以英文句号（.）和中划线（-）开头或结尾;禁止使用IP地址）

ACL

string

必需

桶权限。（'private', 'public-read', 'public-read-write', 'authenticated-read'）

isEncrypted

boolean

可选

是否开启服务端加密。默认为false。若开启加密，算法默认使用AES256

storageType

string

可选

存储类型，目前支持STANDARD、STANDARD_IA和GLACIER，默认STANDARD

AZPolicy

string

可选

AZ策略:可选值为single-az，multi-az，默认为single-az

otherBucketInfo

object

其他创建桶信息

可选

ObjectLockEnabledForBucket

boolean

可选

Bucket是否开启合规保留功能，开启之后才能设置保留策略

locationConstraint

string

可选

bucket的Region(资源池id)信息

示例

{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "ACL": "private",
    "isEncrypted": false,
    "storageType": "STANDARD",
    "AZPolicy": "multi-az",
    "otherBucketInfo": {
        "ObjectLockEnabledForBucket": false
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/oss/create-bucket' \
--header 'Content-Type: application/json' \
--data-raw '{
    "regionID": "TestRegionID",
    "bucket": "ztces-230404-create",
    "ACL": "private",
    "isEncrypted": false,
    "storageType": "STANDARD",
    "AZPolicy": "multi-az",
    "otherBucketInfo": {
        "ObjectLockEnabledForBucket": false
    }
}'

返回响应

🟢200successful operation

application/json

Body

description

string

描述

可选

errorCode

string | null

错误码

可选

message

string

错误说明

可选

returnObj

array [object]

响应对象

可选

statusCode

integer <int32> | null

请求状态码

可选

示例

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

修改于 2024-05-13 10:08:43

对象存储服务开通（工单）

复制对象(拷贝文件到其它桶)