翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
リクエスト圧縮
注記
設定ページのレイアウトを理解したり、 との互換性を解釈したりするのに役立ちます。 AWS SDKs 次の表については、「」を参照してください設定ページ。
AWS SDKs および ツールは、 にリクエストを送信するときにペイロードを自動的に圧縮できます。 AWS のサービス 圧縮ペイロードの受信をサポートする 。サービスに送信する前にクライアントでペイロードを圧縮すると、サービスにデータを送信するために必要なリクエストの総数と帯域幅が減り、ペイロードサイズに対するサービスの制限を理由として失敗するリクエストも減る可能性があります。圧縮の場合、 SDKまたは ツールは、サービスと の両方でサポートされているエンコーディングアルゴリズムを選択しますSDK。ただし、可能なエンコーディングの現在のリストは gzip のみで構成されていますが、将来的には拡張される可能性があります。
リクエスト圧縮は、アプリケーションが Amazon CloudWatchを使用している場合に特に役立ちます。 CloudWatch は、ログ、メトリクス、イベントの形式でモニタリングおよび運用データを収集するモニタリングおよびオブザーバビリティサービスです。圧縮をサポートするサービスオペレーションの一例は、 CloudWatchの PutMetricDataAPIメソッドです。
この機能を設定するには、以下のように使用します。
disable_request_compression
- 共有 AWSconfig
ファイル設定AWS_DISABLE_REQUEST_COMPRESSION
- 環境変数aws.disableRequestCompression
- JVMシステムプロパティ: Java/Kotlin のみ-
SDK またはツールがリクエストを送信する前にペイロードを圧縮するかどうかをオンまたはオフにします。
デフォルト値:
false
有効な値:
-
true
– リクエスト圧縮をオフにします。 -
false
– 可能な場合はリクエスト圧縮を使用します。
-
request_min_compression_size_bytes
- 共有 AWSconfig
ファイル設定AWS_REQUEST_MIN_COMPRESSION_SIZE_BYTES
- 環境変数aws.requestMinCompressionSizeBytes
- JVMシステムプロパティ: Java/Kotlin のみ-
SDK または ツールが圧縮するリクエストボディの最小サイズをバイト単位で設定します。小さなペイロードは圧縮すると長くなる可能性があるため、圧縮を実行することが有意義である下限が存在します。この値は包括的であり、この値以上のリクエストサイズは圧縮されます。
デフォルト値: 10,240 バイト
有効な値: 0~10,485,760 バイトの整数値。
との互換性 AWS SDKs
このトピックで説明されている機能と設定SDKsを以下に示します。部分的な例外があれば、すべて記載されています。すべてのJVMシステムプロパティ設定は、 でサポートされています。 AWS SDK for Java と AWS SDK for Kotlin のみ。
SDK | サポート | 注意または詳細情報 |
---|---|---|
AWS CLI v2 | あり | |
SDK C++ 用 | あり | |
SDK Go V2 用 (1.x) |
あり | |
SDK Go 1.x (V1) 用 | なし | |
SDK for Java 2.x | あり | |
SDK for Java 1.x | なし | |
SDK JavaScript 3.x 用 | あり | |
SDK JavaScript 2.x 用 | なし | |
SDK Kotlin 用 | あり | |
SDK の 。NET 3.x | あり | |
SDK 3.x PHP 用 | あり | |
SDK for Python (Boto3) |
あり | |
SDK Ruby 3.x 用 | あり | |
SDK Rust 用 | あり | |
SDK Swift 用 | なし | |
のツール PowerShell | あり |