How do I troubleshoot 5xx errors from Amazon SNS?

Last updated: 2021-09-03

I ran an Amazon Simple Notification Service (Amazon SNS) API action and received an error message with an HTTP 5xx status code. Why am I receiving these errors and how do I resolve them?

Resolution

A 5xx error indicates a server-side issue that must be resolved by AWS. To mitigate 5xx errors from Amazon SNS, it's a best practice to implement retry logic in your application for all requests that fail with a 5xx status code. The recommended retry count depends on your use case.

There are two types of 5xx errors that Amazon SNS returns:

InternalFailure
The request processing failed because of an unknown error, exception, or failure.
HTTP Status Code: 500

ServiceUnavailable
The request failed because of a temporary server failure.
HTTP Status Code: 503

Note: If you receive 5xx errors after implementing retries, go to the AWS Service Health dashboard to see if there are operational issues with Amazon SNS.


Common errors (Amazon SNS API reference)

Did this article help?


Do you need billing or technical support?