# S3 表类数据存储服务维护任务状态
<a name="s3-tables-maintenance-status"></a>

S3 表类数据存储服务维护任务会定期为您的 S3 表或表存储桶运行。可以使用 `GetTableMaintenanceJobStatus` API 查询这些任务的状态。

**使用 AWS CLI 获取维护任务的状态**  
以下示例将使用 `GetTableMaintenanceJobStatus` API 获取维护任务的状态。  

```
aws s3tables get-table-maintenance-job-status \
   --table-bucket-arn="arn:aws:s3tables:arn:aws::111122223333:bucket/{{amzn-s3-demo-bucket1}}" \
   --namespace="{{mynamespace}}" \
   --name="{{testtable}}"
```
有关更多信息，请参阅《AWS CLI Command Reference》**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html)。

S3 表类数据存储服务维护任务可以在四种可能的状态之间转换：
+ `Successful`
+ `Failed`
+ `Disabled`
+ `Not_Yet_Run`

状态为失败的任务将包含一条失败消息。下面的列表介绍了可能的失败消息。
+ 尝试读取表时遇到 Iceberg 验证异常。确保您的表可读，符合 Iceberg 规范，并且仅包含以 S3 表别名开头的 S3 路径。
+ Iceberg 快照管理目前不支持用户定义的标签或引用。
+ Iceberg 表维护配置与“history.expire.max-snapshot-age-ms”和“history.expire.min-snapshots-to-keep”表属性不兼容。
+ 当“gc.enabled”表属性为 false 时，不支持 Iceberg 快照管理和未引用文件移除。确保此属性为未设置或显式设置为 true。
+ 由于元数据过期，提交失败。将在下次有机会时重试维护。
+ 访问权限不足，无法执行表维护。确保用于加密表的密钥处于活动状态、存在且具有向 S3 服务主体 `maintenance.s3tables.amazonaws.com` 授予访问权限的资源策略。
**注意**  
 有关 S3 表类数据存储服务的 AWS KMS 权限的更多信息，请参阅 [S3 表类数据存储服务 SSE-KMS 加密的权限要求](s3-tables-kms-permissions.md)。
+ 内部错误