Test the AWS connection for PD AWS DocumentDB in WHMCS
Use PD AWS DocumentDB’s module-panel connection test to check whether it can authenticate to AWS and read DocumentDB clusters. This is an infrastructure check, separate from connecting an application to a customer database.
Run the test
- Save the AWS connection using the account guide.
- Open PD Modules → PD AWS DocumentDB → Settings.
- Choose Test Connection and read the result.
- Confirm separately that the intended product uses the correct account and region.
The module-panel test uses the first configured active account and its default test region. It lists DocumentDB clusters; it does not test every account or automatically follow every product’s region. The test creates no cluster and changes no firewall. A passing result confirms that read rather than provisioning, snapshots, password changes or application access.
Investigate a refusal
Check the saved key pair, accidental spaces and whether the key remains active. A lost AWS secret cannot be displayed again: use an approved replacement pair if needed. For an access refusal, ask the AWS administrator to check the permission to describe DocumentDB clusters. Do not confuse an instance-list permission with the cluster read used here.
A generic failure is not proof of bad credentials alone. Outbound HTTPS access and provider availability also matter. Keep the redacted error and test time rather than sharing the key itself.
Verify readiness separately
Review the offering defaults and private-network prerequisites before a controlled first service. A successful AWS read does not prove that a customer’s database is ready or reachable. If an earlier creation outcome is uncertain, investigate the original service before requesting another cluster.
See the PD AWS DocumentDB WHMCS guide for related tasks, or explore PD AWS DocumentDB.