Get table record expiration job statustablearn

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1449192184.5 KB

Retrieves the status, metrics, and details of the latest record expiration job for a table. This includes when the job ran, and whether it succeeded or failed. If the job ran successfully, this also includes statistics about the records that were removed.

Permissions

You must have the s3tables:GetTableRecordExpirationJobStatus permission to use this operation.

get/table-record-expiration-job-status#tableArn

Query parameters

tableArnstring required

The Amazon Resource Name (ARN) of the table.

Response

Success

status'NotYetRun' | 'Successful' | 'Failed' | 'Disabled' required

The current status of the most recent expiration job.

lastRunTimestampstring date-time

The timestamp when the expiration job was last executed.

failureMessagestring

If the job failed, this field contains an error message describing the failure reason.