存储空间(Bucket)是存储对象(Object)的容器。本文介绍如何获取存储空间的信息。
注意事项
关于OSS支持的Region与Endpoint的对应关系,请参见OSS地域和访问域名。
如果您使用RAM用户获取存储空间信息,需要授予RAM用户
oss:GetBucketInfo
权限。具体操作,请参见为RAM用户授权自定义的权限策略。
示例代码
以下代码用于获取存储空间的信息(Info),包括存储空间所在地域、创建日期等。
import Client, { RequestError } from '@aliyun/oss';
// 创建OSS客户端实例
const client = new Client({
// 请替换为STS临时访问凭证的Access Key ID
accessKeyId: 'yourAccessKeyId',
// 请替换为STS临时访问凭证的Access Key Secret
accessKeySecret: 'yourAccessKeySecret',
// 请替换为STS临时访问凭证的Security Token
securityToken: 'yourSecurityToken',
// 填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou
region: 'oss-cn-hangzhou',
});
// 获取bucket(Bucket)的详细信息
const getBucketInfo = async () => {
try {
// 调用getBucketInfo方法获取指定bucket的详细信息
const res = await client.getBucketInfo({
bucket: 'yourBucketName' // 替换为你的bucket名称
});
// 打印返回结果
console.log(JSON.stringify(res));
} catch (err) {
// 捕获并处理请求错误
if (err instanceof RequestError) {
console.log('错误码: ', err.code); // 错误代码
console.log('错误信息: ', err.message); // 错误描述
console.log('请求ID: ', err.requestId); // 请求的唯一标识
console.log('HTTP状态码: ', err.status); // HTTP响应状态码
console.log('错误类别: ', err.ec); // 错误类别
} else {
console.log('未知错误: ', err); // 非RequestError类型的错误
}
}
};
// 调用函数,获取bucket的详细信息
getBucketInfo();
相关文档
关于获取存储空间信息的API接口说明,请参见GetBucketInfo。
该文章对您有帮助吗?
- 本页导读 (1)
- 注意事项
- 示例代码
- 相关文档