文档首页/ 对象存储服务 OBS/ SDK参考/ PHP/ 桶相关接口/ 桶基础操作/ 桶配额
更新时间：2026-09-07 GMT+08:00
查看PDF
分享

桶配额

开发过程中，您有任何问题可以在GitHub上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。

设置桶配额

您可以通过ObsClient->setBucketQuota设置桶配额。以下代码展示如何设置桶配额：

<?php

// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
use Obs\ObsException;
// 创建ObsClient实例
$obsClient = new ObsClient([ 
    //推荐通过环境变量获取访问密钥AK/SK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    'key' => getenv('ACCESS_KEY_ID'),
    'secret' => getenv('SECRET_ACCESS_KEY'),
    'endpoint' => 'https://your-endpoint',
]);

try {
    // 设置桶配额
    $resp = $obsClient->setBucketQuota([
        'Bucket' => "bucketname",
        'StorageQuota' => 1024 * 1024 * 100  // 100MB
    ]);

    printf("RequestId:%s\n",$resp['RequestId']);
} catch (ObsException $e) {
      // 操作失败，获取详细异常信息
      printf("SetBucketQuotaFailed: Status:%d, Code:%s, Message:%s\n",
         $e->getStatusCode(), $e->getExceptionCode(), $e->getExceptionMessage());
} finally {
      // 关闭ObsClient，释放资源
      $obsClient->close();
}
  • 使用StorageQuota参数指定桶的配额大小。
  • 桶配额值必须为非负整数，单位为字节，支持的最大值为263 - 1。

获取桶配额

您可以通过ObsClient->getBucketQuota获取桶配额。以下代码展示如何获取桶配额：

<?php

// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
use Obs\ObsException;
// 创建ObsClient实例
$obsClient = new ObsClient([ 
    //推荐通过环境变量获取访问密钥AK/SK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    'key' => getenv('ACCESS_KEY_ID'),
    'secret' => getenv('SECRET_ACCESS_KEY'),
    'endpoint' => 'https://your-endpoint',
]);

try {
    // 获取桶配额
    $resp = $obsClient->getBucketQuota([
        'Bucket' => "bucketname",
        'StorageQuota' => 1024 * 1024 * 100  // 100MB
    ]);

    printf("RequestId:%s\n",$resp['RequestId']);
    printf("StorageQuota:%s\n",$resp['StorageQuota']);
} catch (ObsException $e) {
      // 操作失败，获取详细异常信息
      printf("GetBucketQuotaFailed: Status:%d, Code:%s, Message:%s\n",
         $e->getStatusCode(), $e->getExceptionCode(), $e->getExceptionMessage());
} finally {
      // 关闭ObsClient，释放资源
      $obsClient->close();
}
父主题： 桶基础操作

相关文档