GetTableMaintenanceConfiguration - 对象存储 OSS

注意事项

返回结果包含所有维护类型的配置，包括icebergCompaction（表压缩）和icebergSnapshotManagement（快照管理）。
每种维护类型的配置包含status（启用状态）和settings（配置参数）。

权限说明

API	Action	说明
GetTableMaintenanceConfiguration	oss:GetTableMaintenanceConfiguration	获取表维护配置（同时检查Table Policy；admin用户免检）

请求语法

GET /tables/{tableBucketARN}/{namespace}/{name}/maintenance 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}:{uid}:bucket/{bucketName}。位于URI中。
namespace	字符串	是	my_namespace	表所在的命名空间名称。位于URI中。
name	字符串	是	my_table	表名称。位于URI中。

响应参数

名称	数据类型	示例值	描述
tableARN	字符串	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table-id	表的ARN。
configuration	容器	-	维护配置对象，包含icebergCompaction（表压缩配置）和icebergSnapshotManagement（快照管理配置）两个子对象。每个子对象包含status（启用状态）和settings（配置参数）。

示例

请求示例

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/maintenance HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
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


{
   "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
   "configuration": {
      "icebergCompaction": {
         "status": "enabled",
         "settings": {
            "icebergCompaction": {
               "targetFileSizeMB": 512,
               "strategy": "auto"
            }
         }
      },
      "icebergSnapshotManagement": {
         "status": "enabled",
         "settings": {
            "icebergSnapshotManagement": {
               "minSnapshotsToKeep": 1,
               "maxSnapshotAgeHours": 120
            }
         }
      }
   }
}

SDK

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

命令行工具ossutil

GetTableMaintenanceConfiguration接口所对应的ossutil命令，请参见get-table-maintenance-configuration。

错误码

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