获取存储空间信息

注意事项

• 关于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。