PutTableBucketPolicy

更新时间:
复制 MD 格式

调用PutTableBucketPolicy接口设置指定Table Bucket的资源策略(Resource Policy)。

注意事项

  • 资源策略采用IAM Policy格式的JSON字符串。

  • 通过资源策略可以实现跨账号授权访问Table Bucket。

  • 如果Table Bucket已有资源策略,调用此接口将覆盖原有策略。

权限说明

API

Action

说明

PutTableBucketPolicy

oss:PutTableBucketPolicy

设置Table Bucket策略

请求语法

PUT /buckets/{tableBucketARN}/policy HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

{
   "resourcePolicy": "string"
}

请求参数

名称

数据类型

是否必选

示例值

描述

tableBucketARN

字符串

是

acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

Table Bucket的ARN,格式为acs:osstables:{region}:{accountId}:bucket/{bucketName}。

resourcePolicy

字符串

是

-

资源策略JSON字符串(IAM Policy格式)。策略内容需要进行JSON转义后作为字符串传入。

示例

为指定的Table Bucket设置资源策略。

请求示例

PUT /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/policy HTTP/1.1
Content-Type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

{
   "resourcePolicy": "{\"Version\":\"1\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"oss:GetTableBucket\"],\"Principal\":[\"1234567890\"],\"Resource\":[\"acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket\"]}]}"
}

返回示例

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3

SDK

PutTableBucketPolicy接口所对应的各语言SDK如下:

命令行工具ossutil

PutTableBucketPolicy接口所对应的ossutil命令,请参见put-table-bucket-policy。

错误码

错误码

HTTP状态码

描述

BadRequestException

400

请求无效或格式错误。

ForbiddenException

403

调用者无权执行此请求。

NotFoundException

404

请求的资源不存在。