Skip to content

add code E12 = download erros #949

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

add code E12 = download erros #949

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
12e5232
add code E12 = download erros
lizk886 Nov 14, 2025
f01e226
be consistent with the existing table
lizk886 Nov 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 12 additions & 2 deletions docs/guides/operator-guide-aws-marketplace.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
Expand All @@ -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: <br/>**404 errors** - Verify operator key is valid and configuration paths are correct.<br/>**403 errors** - Check IAM permissions for S3 access and verify operator credentials.<br/>**Timeout errors** - Verify network connectivity, check firewall/security group settings allow outbound HTTPS, and ensure UID2 service endpoints are accessible.<br/>**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).
Loading