AWS AmazonS3 documentation change
Summary
Updated failure messages list with more specific Iceberg-related validation errors
Security assessment
Improves error message documentation for maintenance job failures, but no security context or vulnerabilities addressed.
Diff
diff --git a/AmazonS3/latest/userguide/s3-tables-maintenance-status.md b/AmazonS3/latest/userguide/s3-tables-maintenance-status.md index 27d707fd1..25e164e4f 100644 --- a/AmazonS3/latest/userguide/s3-tables-maintenance-status.md +++ b/AmazonS3/latest/userguide/s3-tables-maintenance-status.md @@ -35,11 +35,16 @@ S3 Tables maintenance jobs can transition between four possible statuses: -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](./s3-tables-considerations.html). -Table is not well-formed | Table is unreadable. For more information see, [Considerations and limitations for maintenance jobs](./s3-tables-considerations.html). -`Internal Error` | An internal service error has occurred. +Jobs with a failed status will include a failure message. The following list describes possible failure messages. + + * Encountered Iceberg validation exception when trying to read table. Ensure that your table is readable, adheres to the Iceberg specification, and contains only S3 paths that begin with your S3 Table alias. + + * Iceberg Snapshot management does not currently support user defined tags or references. + + * Iceberg table maintenance configuration is incompatible with 'history.expire.max-snapshot-age-ms' and 'history.expire.min-snapshots-to-keep' table properties. + + * Iceberg snapshot management and unreferenced file removal is not supported when the 'gc.enabled' table property is false. Ensure that this property is unset or explicitly set to true. + + * Failed to commit because of out of date metadata. Maintenance will be retried at the next available opportunity. + + * Internal error + + +