JavaSDK
更新时间：2025-06-24
版本控制
getBucketVersioning
获取某个Bucket的version权限。
权限要求：需拥有该Bucket的READ权限
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| bucketName | string | 是 | Bucket名称 |
请求示例：
Plain Text
1import {BosClient} from '@baiducloud/sdk';
2
3const client = new BosClient({
4 endpoint: process.env.BOS_ENDPOINT,
5 credentials: {
6 ak: process.env.BOS_AK,
7 sk: process.env.BOS_SK
8 }
9 }
10);
11const res = await client.getBucketVersioning('multi-test');响应示例：
Plain Text
1{
2 http_headers: {
3 date: 'Mon, 23 Jun 2025 02:26:34 GMT',
4 'content-type': 'application/json; charset=utf-8',
5 'content-length': '20',
6 connection: 'close',
7 server: 'BceBos',
8 'x-bce-debug-id': 'rBQQRQ1IbInIIFkDMuZg7spX+c27zO/4xWnW2NZw4k28Q+3QRHtenJQwKON/oCvHaAB6RoNAeT/sZnUXFajb5g==',
9 'x-bce-flow-control-type': '-1',
10 'x-bce-is-transition': 'false',
11 'x-bce-request-id': 'd12c988c-37f9-4c6c-a6f2-743c6ba405c5',
12 'x-bce-version-id': 'null'
13 },
14 body: {
15 status: 'enabled'
16 }
17}putBucketVersioning
设置指定存储空间（Bucket）的版本控制状态。
- 在Bucket处于开启版本控制状态下，所有新添加的文件（Object）都将拥有唯一的版本ID，将累积所添加Object的多个版本。
- 在Bucket处于暂停版本控制状态下，所有新添加Object的版本ID将为null，将不再为此状态下添加的Object累积更多的版本。
权限要求：需拥有该Bucket的PutBucketVersioning权限
请求参数：
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| bucketName | string | 是 | Bucket名称 |
| status | string | 是 | 目标状态：enabled、suspended或notEnabled |
请求示例：
Plain Text
1import {BosClient} from '@baiducloud/sdk';
2
3const client = new BosClient({
4 endpoint: process.env.BOS_ENDPOINT,
5 credentials: {
6 ak: process.env.BOS_AK,
7 sk: process.env.BOS_SK
8 }
9 }
10);
11const res = await client.putBucketVersioning('multi-test', 'suspended');响应示例：
Plain Text
1{
2 http_headers: {
3 date: 'Mon, 23 Jun 2025 02:34:15 GMT',
4 'content-length': '0',
5 connection: 'close',
6 server: 'BceBos',
7 'x-bce-debug-id': 'k41Dyyj/W0JV5KU32pCrI14O2/P5lTt9OfDg5I/6bOl7IE1l8ATz0DH7LQoBu+kKr9K7SH7C1YVZab84Y9x7Zg==',
8 'x-bce-flow-control-type': '-1',
9 'x-bce-is-transition': 'false',
10 'x-bce-request-id': 'eea42f0b-15b1-44c7-9d52-7b08111fca96',
11 'x-bce-version-id': 'null'
12 },
13 body: {}
14}