リクエスト圧縮 - AWS SDKsとツール

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

リクエスト圧縮

注記

設定ページのレイアウトの理解、または以下の AWS SDKs「」を参照してくださいこのガイドの設定ページについて

AWS SDKsとツールは、圧縮されたペイロードの受信 AWS のサービス をサポートする にリクエストを送信するときに、ペイロードを自動的に圧縮できます。サービスに送信する前にクライアントでペイロードを圧縮すると、サービスにデータを送信するために必要なリクエストの総数と帯域幅が減り、ペイロードサイズに対するサービスの制限を理由として失敗するリクエストも減る可能性があります。圧縮では、SDK またはツールは、サービスと SDK の両方によってサポートされるエンコーディングアルゴリズムを選択します。ただし、可能なエンコーディングの現在のリストは gzip のみで構成されていますが、将来的には拡張される可能性があります。

リクエスト圧縮は、アプリケーションが Amazon CloudWatch を利用している場合に特に役立ちます。CloudWatch は、ログ、メトリクス、イベントの形式でモニタリングおよび運用データを収集するモニタリングおよびオブザーバビリティサービスです。圧縮をサポートするサービスオペレーションの一例として、CloudWatch の PutMetricDataAPI メソッドを挙げることができます。

この機能を設定するには、以下のように使用します。

disable_request_compression - 共有 AWS configファイル設定
AWS_DISABLE_REQUEST_COMPRESSION - 環境変数
aws.disableRequestCompression - JVM システムプロパティ: Java/Kotlin のみ

オンまたはオフにして、SDK またはツールがリクエストを送信する前にペイロードを圧縮するかどうかを決定します。

デフォルト値: false

有効な値:

  • true – リクエスト圧縮をオフにします。

  • false – 可能な場合はリクエスト圧縮を使用します。

request_min_compression_size_bytes - 共有 AWS configファイル設定
AWS_REQUEST_MIN_COMPRESSION_SIZE_BYTES - 環境変数
aws.requestMinCompressionSizeBytes - JVM システムプロパティ: Java/Kotlin のみ

SDK またはツールが圧縮する必要があるリクエスト本文の最小サイズ (バイト) を設定します。小さなペイロードは圧縮すると長くなる可能性があるため、圧縮を実行することが有意義である下限が存在します。この値は包括的であり、この値以上のリクエストサイズは圧縮されます。

デフォルト値: 10,240 バイト

有効な値: 0~10,485,760 バイトの整数値。

AWS SDKsとツールによるサポート

以下の SDK は、このトピックで説明する機能と設定をサポートします。部分的な例外があれば、すべて記載されています。JVM システムプロパティ設定は、 AWS SDK for Java と AWS SDK for Kotlin でのみサポートされます。