View a markdown version of this page

请求压缩 - Amazon 软件开发工具包和工具
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

请求压缩

注意

如需了解设置页面布局或解释后面的 Support by Amazon SDK 和工具表的帮助,请参阅了解本指南的设置页面

Amazon 当向支持接收压缩负载的请求时,SDK 和工具可以自动压缩有效负载。 Amazon Web Services 服务 在将有效负载发送到服务之前在客户端上对其进行压缩,可以减少向服务发送数据所需的请求总数和带宽,还可以减少由于服务对有效负载大小的限制而导致的失败请求。进行压缩时,SDK 或工具会选择服务和 SDK 都支持的编码算法。但是,当前可能的编码列表仅包含 gzip,但未来可能会扩展。

如果您的应用程序使用的是 Amazon,则请求压缩可能特别有用 CloudWatch。 CloudWatch 是一项监控和可观测性服务,它以日志、指标和事件的形式收集监控和操作数据。支持压缩的服务操作的一个示例 CloudWatch是PutMetricDataAPI的方法。

使用以下方法配置此功能:

disable_request_compression-共享 Amazon config文件设置
AWS_DISABLE_REQUEST_COMPRESSION - 环境变量
aws.disableRequestCompression-JVM 系统属性:仅限 Java/Kotlin

开启或关闭 SDK 或工具是否将在发送请求之前压缩有效负载。

默认值false

有效值:

  • true – 关闭请求压缩。

  • false – 尽可能使用请求压缩。

request_min_compression_size_bytes-共享 Amazon config文件设置
AWS_REQUEST_MIN_COMPRESSION_SIZE_BYTES - 环境变量
aws.requestMinCompressionSizeBytes-JVM 系统属性:仅限 Java/Kotlin

设置 SDK 或工具应压缩的请求正文的最小大小(以字节为单位)。压缩后,小型有效载荷可能会变得更长,因此,将会有一个下限,使执行压缩变得有意义。该值包含首尾,大于或等于该值的请求大小将被压缩。

默认值:10240 字节

有效值:介于 0 到 10485760 字节(包含首尾)之间的整数值。

Support by Amazon SDK 和工具

以下 SDK 支持本主题中所述的功能和设置。所有部分例外情况均已注明。 适用于 Java 的 Amazon SDK 和 适用于 Kotlin 的 Amazon SDK 唯一支持任何 JVM 系统属性设置。