diff --git a/docs/guides/operator-guide-aws-marketplace.md b/docs/guides/operator-guide-aws-marketplace.md index 21f39b0a9..03ebc9128 100644 --- a/docs/guides/operator-guide-aws-marketplace.md +++ b/docs/guides/operator-guide-aws-marketplace.md @@ -361,12 +361,16 @@ The following table includes some additional commands that might help you manage ## UID2 Operator Error Codes -The following table lists errors that might occur during a Private Operator's startup sequence. +The following sections list error codes that might occur during a Private Operator's startup or runtime. :::note -Error codes for Private Operator startup issues are applicable only to release v5.49.7 and later. +Error codes for Private Operator issues are applicable only to release v5.49.7 and later. ::: +### Startup Errors + +The following errors occur during operator startup: + | Error Code | Issue | Steps to Resolve | | :--- | :--- | :--- | | E01 | InstanceProfileMissingError | Attach an IAM instance profile to the EC2 instance with the required permissions. The UID2 Operator needs these permissions to access configurations from AWS Secrets Manager. | @@ -376,6 +380,12 @@ Error codes for Private Operator startup issues are applicable only to release v | E05 | OperatorKeyValidationError | Ensure the operator key is correct for the environment and matches the one provided to you. | | E06 | UID2ServicesUnreachableError | Allow UID2 core and opt-out service IP addresses in the egress firewall. For IP addresses and DNS details, refer to the logs. | +The following errors occur during operator runtime (after startup): + +| Error Code | Issue | How to Identify in Logs | Steps to Resolve | +| :--- | :--- | :--- | :--- | +| E12 | Data Download Failure | Look for log messages containing `"E12: Data Download Failure"` along with `"Failed to load"` errors from `RotatingStoreVerticle`. These will include HTTP status codes (e.g., `"HTTP response code 403"`) or exception types (e.g., `"exception: IOException"`). | Check the HTTP status code or exception in the error message:
**404 errors** - Verify operator key is valid and configuration paths are correct.
**403 errors** - Check IAM permissions for S3 access and verify operator credentials.
**Timeout errors** - Verify network connectivity, check firewall/security group settings allow outbound HTTPS, and ensure UID2 service endpoints are accessible.
**500 errors** - Temporary UID2 service issue, retry or contact UID2 support if persistent. | + ## Technical Support If you have trouble subscribing to the product, or deploying, [contact us](mailto:aws-mktpl-uid@thetradedesk.com).