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

管理桶策略

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

除了桶ACL外，桶的拥有者还可以通过桶策略，提供对桶和桶内对象的集中访问控制。

更多关于桶策略的内容请参考桶策略。

设置桶策略

您可以通过ObsClient->setBucketPolicy设置桶策略。示例代码如下： 
<?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 {
    // Principal 设为 '*' 表示授权所有用户，请根据业务需求谨慎配置。生产环境建议仅授权特定 IAM 用户或账号。
    $policy = json_encode(['Statement' => [['Principal' => '*', 'Effect' => 'Allow', 'Action' => 'ListBucket', 'Resource' => $bucketName]]]);
    // 设置桶策略
    $resp = $obsClient->setBucketPolicy([
        'Bucket' => "bucketname",
        'Policy' => $policy
    ]);

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

桶策略内容的具体格式（JSON格式字符串）请参考《对象存储服务PHP SDK API参考》。

获取桶策略

您可以通过ObsClient->getBucketPolicy获取桶策略。示例代码如下：

// 引入依赖库
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->getBucketPolicy([
        'Bucket' => "bucketname",
    ]);

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

删除桶策略

您可以通过ObsClient->deleteBucketPolicy删除桶策略。示例代码如下：

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

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

相关文档