PutTableBucketEncryption -

注意事項

設定加密配置後，新建立的 Table 若未單獨指定加密配置，將自動繼承 Table Bucket 的加密設定，已有的 Table 不受影響。
目前僅支援AES256密碼編譯演算法。
如果Table Bucket已有加密配置，調用此介面將覆蓋原有配置。

許可權說明

API	Action	說明
PutTableBucketEncryption	oss:PutTableBucketEncryption	設定Table Bucket加密

請求文法

PUT /buckets/{tableBucketARN}/encryption 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****

{
   "encryptionConfiguration": {
      "kmsKeyArn": "string",
      "sseAlgorithm": "string"
   }
}

請求參數

名稱	資料類型	是否必選	樣本值	描述
tableBucketARN	字串	是	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Table Bucket的ARN，格式為acs:osstables:{region}:{accountId}:bucket/{bucketName}。
encryptionConfiguration	容器	是	-	服務端加密配置。父節點：無子節點：sseAlgorithm
sseAlgorithm	字串	是	AES256	密碼編譯演算法，目前僅支援AES256。父節點：encryptionConfiguration 子節點：無

樣本

以下樣本為指定的Table Bucket設定AES256服務端加密。

請求樣本

PUT /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/encryption 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****

{
   "encryptionConfiguration": {
      "sseAlgorithm": "AES256"
   }
}

返回樣本

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

SDK

PutTableBucketEncryption介面所對應的各語言SDK如下：

命令列工具ossutil

PutTableBucketEncryption介面所對應的ossutil命令，請參見put-table-bucket-encryption。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
BadRequestException	400	請求無效或格式錯誤。
ForbiddenException	403	調用者無權執行此請求。
NotFoundException	404	請求的資源不存在。