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

请求压缩

注意

如需获得相关帮助,以了解设置页面的布局或解释后面的 Amazon SDK 和工具支持表,请参阅了解本指南的设置页面

当向支持接收压缩有效负载的 Amazon Web Services 服务 发送请求时,Amazon SDK 和工具可以自动压缩有效负载。在将有效负载发送到服务之前在客户端上对其进行压缩,可以减少向服务发送数据所需的请求总数和带宽,还可以减少由于服务对有效负载大小的限制而导致的失败请求。进行压缩时,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 字节(包含首尾)之间的整数值。

Amazon SDK 和工具支持

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