GetTableBucketEncryption-对象存储(OSS)-阿里云帮助中心

GetTableBucketEncryption接口用于获取指定Table Bucket的服务端加密配置信息。

注意事项

返回的配置信息包括加密算法和KMS密钥ARN。

权限说明

API	Action	说明
GetTableBucketEncryption	oss:GetTableBucketEncryption	获取Table Bucket加密配置

请求语法

GET /buckets/{tableBucketARN}/encryption 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 Bucket的ARN，格式为acs:osstables:{region}:{accountId}:bucket/{bucketName}。

响应参数

名称	数据类型	示例值	描述
encryptionConfiguration	容器	-	加密配置容器。子节点：sseAlgorithm, kmsKeyArn
sseAlgorithm	字符串	AES256	加密算法，例如AES256。父节点：encryptionConfiguration
kmsKeyArn	字符串	-	KMS密钥ARN，未配置时为空字符串。父节点：encryptionConfiguration

示例

请求示例

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

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

SDK

GetTableBucketEncryption接口所对应的各语言SDK如下：

命令行工具ossutil

GetTableBucketEncryption接口所对应的ossutil命令，请参见get-table-bucket-encryption。

错误码

错误码	HTTP状态码	描述
ForbiddenException	403	调用者无权执行此请求。
NotFoundException	404	请求的资源不存在。