简介
本文介绍对象存储 COS 通过 JavaScript SDK 实现检索存储桶、删除存储桶的示例代码和描述。
注意事项
在您使用存储桶相关操作之前，需要先具有相关权限，具体而言：
若想检索存储桶，在您进行 授权策略 时，action 需要设置为
cos:HeadBucket ，更多授权请参见 支持CAM的业务接口。若想删除存储桶，在您进行 授权策略 时，action 需要设置为
cos:DeleteBucket ，更多授权请参见 支持CAM的业务接口。前期准备
使用案例
检索存储桶及其权限
cos.headBucket({Bucket: 'examplebucket-1250000000', // 填入您自己的存储桶，必须字段Region: 'COS_REGION', // 存储桶所在地域，例如 ap-beijing，必须字段}, function(err, data) {if (err && err.statusCode == 403) {console.log('没有该存储桶读权限');}});
判断存储桶是否存在
function doesBucketExist() {cos.headBucket({Bucket: 'examplebucket-1250000000', // 填入您自己的存储桶，必须字段Region: 'COS_REGION', // 存储桶所在地域，例如 ap-beijing，必须字段}, function(err, data) {if (data) {console.log('存储桶存在');}});}
参数说明
参数名 | 参数描述 | 类型 | 必填 |
Bucket | 存储桶的名称，命名规则为 BucketName-APPID，此处填写的存储桶名称必须为此格式 | String | 是 |
Region | 存储桶所在地域，枚举值请参见 地域和访问域名 | String | 是 |
回调函数说明
function(err, data) { ... }
参数名 | 参数描述 | 类型 |
err | Object | |
- statusCode | 请求返回的 HTTP 状态码，如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
data | 请求成功时返回的对象，如果请求发生错误，则为空 | Object |
- statusCode | 请求返回的 HTTP 状态码，如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
- RequestId | 请求 ID | String |
返回结果说明
当该存储桶存在且有读取权限时，返回 HTTP 状态码200。
当该存储桶无读取权限时，返回 HTTP 状态码403。
当该存储桶不存在时，返回 HTTP 状态码404。
删除存储桶
说明
删除存储桶前，请确保存储桶内的数据和未完成上传的分块数据已全部清空，否则会无法删除存储桶。
cos.deleteBucket({Bucket: 'examplebucket-1250000000', // 填入您自己的存储桶，必须字段Region: 'COS_REGION', // 存储桶所在地域，例如 ap-beijing，必须字段}, function(err, data) {console.log(err || data);});
参数说明
参数名 | 参数描述 | 类型 | 必填 |
Bucket | 存储桶的名称，命名规则为 BucketName-APPID，此处填写的存储桶名称必须为此格式 | String | 是 |
Region | 存储桶所在地域。枚举值请参见 地域和访问域名 | String | 是 |
回调函数说明
function(err, data) { ... }
参数名 | 参数描述 | 类型 |
err | Object | |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
data | 请求成功时返回的对象，如果请求发生错误，则为空 | Object |
- statusCode | 请求返回的 HTTP 状态码，例如200、403、404等 | Number |
- headers | 请求返回的头部信息 | Object |
- RequestId | 请求 ID | String |
返回结果说明
如果删除成功，返回的 HTTP 状态码为200或204。
API 操作
关于检索存储桶的API 接口说明，请参见 HEAD Bucket 文档。
关于删除存储桶的API 接口说明，请参见 DELETE Bucket 文档。
