S3 Tables maintenance job status - Amazon Simple Storage Service

S3 Tables maintenance job status

S3 Tables maintenance jobs run periodically for your S3 tables or table buckets. You can query the status of these jobs with the GetTableMaintenanceJobStatus API.

To get the status of your maintenance jobs by using the AWS CLI

The following example will get the statuses of maintenance jobs using the 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"

For more information, see get-table-maintenance-job-status in the AWS CLI Command Reference.

S3 Tables maintenance jobs can transition between four possible statuses:

  • Successful

  • Failed

  • Disabled

  • Not_Yet_Run

Jobs with a failed status will include a failure message. The following table describes possible failure messages.

Failure message Description
Job has timed out and has been stopped The maintenance operation has reached a time limit and has stopped. The operation will retry automatically.
Commit conflict Commit failed due to a conflict with another concurrent operation.
Error loading table, table does not exist Table name not found. Please ensure table name exists.
Error loading namespace, namespace does not exist Namespace not found. Please ensure namespace exists.
Table is not supported Table property validation failure. For more information see, Considerations and limitations for maintenance jobs.
Table is not well-formed Table is unreadable. For more information see, Considerations and limitations for maintenance jobs.
Internal Error An internal service error has occurred.