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

桶存储类型

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

OBS允许您对桶配置不同的存储类型，桶中对象的存储类型默认将与桶的存储类型保持一致。不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。桶的存储类型分为以下几类，详见下表：

类型

说明

OBS PHP SDK对应值

标准存储

标准存储拥有低访问时延和较高的吞吐量，适用于有大量热点对象（平均一个月多次）或小对象（<1MB），且需要频繁访问数据的业务场景。

ObsClient::StorageClassStandard

低频访问存储

低频访问存储适用于不频繁访问（平均一年少于12次）但在需要时也要求能够快速访问数据的业务场景。

ObsClient::StorageClassWarm

归档存储

归档存储适用于很少访问（平均一年访问一次）数据的业务场景。

ObsClient::StorageClassCold

深度归档存储

深度归档存储适用于长期不访问（平均几年访问一次）数据的业务场景。

ObsClient::StorageClassDeepArchive

更多关于桶存储类型的内容请参考桶的存储类别。

设置桶存储类型

您可以通过ObsClient->setBucketStoragePolicy设置桶存储类型。以下代码展示如何设置桶存储类型：

<?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->setBucketStoragePolicy([
        'Bucket' => "bucketname",
        'StorageClass' => ObsClient::StorageClassWarm
    ]);

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

使用StorageClass参数指定桶的存储类型。

获取桶存储类型

您可以通过ObsClient->getBucketStoragePolicy获取桶存储类型。以下代码展示如何获取桶存储类型：

<?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->getBucketStoragePolicy([
        'Bucket' => "bucketname",
    ]);

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

相关文档