GetTableBucketPolicy

更新時間:
Copy as MD

調用GetTableBucketPolicy介面擷取指定Table Bucket的資源策略(Resource Policy)。

注意事項

  • 如果Table Bucket未設定資源策略,將返回NotFoundException錯誤。

  • 返回的資源策略為IAM Policy格式的JSON字串。

許可權說明

API

Action

說明

GetTableBucketPolicy

oss:GetTableBucketPolicy

擷取Table Bucket策略

請求文法

GET /buckets/{tableBucketARN}/policy HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

請求參數

名稱

資料類型

是否必選

樣本值

描述

tableBucketARN

字串

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

Table BucketARN,格式為acs:osstables:{region}:{accountId}:bucket/{bucketName}。

響應參數

名稱

資料類型

樣本值

描述

resourcePolicy

字串

-

資源策略JSON字串(IAM Policy格式)。

樣本

請求樣本

GET /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/policy HTTP/1.1
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****

返回樣本

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

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

SDK

GetTableBucketPolicy介面所對應的各語言SDK如下:

命令列工具ossutil

GetTableBucketPolicy介面所對應的ossutil命令,請參見get-table-bucket-policy

錯誤碼

錯誤碼

HTTP狀態代碼

描述

ForbiddenException

403

調用者無權執行此請求。

NotFoundException

404

請求的資源不存在。