Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon SQS Amazon JSON protocol FAQs

Frequently asked questions about using Amazon JSON protocol with Amazon SQS.

What is Amazon JSON protocol, and how does it differ from existing Amazon SQS API requests and responses?

JSON is one of the most widely used and accepted wiring methods for communication between heterogeneous systems. Amazon SQS uses JSON as a medium to communicate between an Amazon SDK client (for example, Java, Python, Golang, JavaScript) and Amazon SQS server. An HTTP request of an Amazon SQS API operation accepts input in the form of JSON. The Amazon SQS operation is executed and the response of execution is shared back to the SDK client in the form of JSON. Compared to Amazon query, JSON is more efficient at transporting data between client and server.

How do I get started with Amazon JSON protocols for Amazon SQS?

To get started with the latest Amazon SDK version to achieve faster messaging for Amazon SQS, upgrade your Amazon SDK to the specified version or any subsequent version. To learn more about SDK clients, see the Guide column in the table below.

The following is a list of SDK versions across language variants for Amazon JSON protocol for use with Amazon SQS APIs:

What are the risks of enabling JSON protocol for my Amazon SQS workloads?

If you are using a custom implementation of Amazon SDK or a combination of custom clients and Amazon SDK to interact with Amazon SQS that generates Amazon Query based (aka XML-based) responses, it may be incompatible with Amazon JSON protocol. If you encounter any issues, contact Amazon Support.

What if I am already on the latest Amazon SDK version, but my open sourced solution does not support JSON?

You must change your SDK version to the version previous to what you are using. See How do I get started with Amazon JSON protocols for Amazon SQS? for more infomation. Amazon SDK versions listed in How do I get started with Amazon JSON protocols for Amazon SQS? uses JSON wire protocol for Amazon SQS APIs. If you change your Amazon SDK to the previous version, your Amazon SQS APIs will use the Amazon query.

What languages are supported for Amazon JSON protocol used in Amazon SQS APIs?

Amazon SQS supports all language variants where Amazon SDKs are generally available (GA). Currently, we don't support Kotlin, Rust, or Swift. To learn more about other language variants, see Tools to Build on Amazon.

What regions are supported for Amazon JSON protocol used in Amazon SQS APIs

Amazon SQS supports Amazon JSON protocol in all Amazon regions where Amazon SQS is available.

What latency improvements can I expect when upgrading to the specified Amazon SDK versions for Amazon SQS using the Amazon JSON protocol?

Amazon JSON protocol is more efficient at serialization and deserialization of requests and responses when compared to Amazon query protocol. Based on Amazon performance tests for a 5 KB message payload, JSON protocol for Amazon SQS reduces end-to-end message processing latency by up to 23%, and reduces application client side CPU and memory usage.

Will Amazon query protocol be deprecated?

Amazon query protocol will continue to be supported. You can continue using Amazon query protocol as long as your Amazon SDK version is set any previous version other that what is listed in How do I get started with Amazon JSON protocols for Amazon SQS?.

Where can I find more information about Amazon JSON protocol?

You can find more information about JSON protocol at Amazon JSON 1.0 protocol in the Smithy documentation. For more about Amazon SQS API requests using Amazon JSON protocol, see Making query API requests using Amazon JSON protocol.