调用PutTableBucketEncryption接口设置指定Table Bucket的服务端加密配置。
注意事项
-
设置加密配置后，新创建的 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: 3SDK
PutTableBucketEncryption接口所对应的各语言SDK如下：
命令行工具ossutil
PutTableBucketEncryption接口所对应的ossutil命令，请参见put-table-bucket-encryption。
错误码
|
错误码 |
HTTP状态码 |
描述 |
|
BadRequestException |
400 |
请求无效或格式错误。 |
|
ForbiddenException |
403 |
调用者无权执行此请求。 |
|
NotFoundException |
404 |
请求的资源不存在。 |