Range および partNumber ヘッダーの操作

リクエストされた Range または partNumber を変換されたオブジェクトにマッピングします (推奨)。

Range または partNumber リクエストを処理する最も確実な方法は、以下を実行することです。

これを行うには、指定された署名付き URL を使用して Amazon S3 からオブジェクト全体をフェッチし、必要に応じてオブジェクトを処理します。例の Lambda 関数では、この方法で Range パラメータを設定し、AWS サンプル GitHub リポジトリの「このサンプル」を参照してください。

リクエストされた Range を署名付き URL にマッピングします。

場合によっては、Lambda 関数でリクエストされた Range を署名済み URL に直接マッピングして、Amazon S3 からオブジェクトの一部のみを取得できます。このアプローチは、変換が次の両方の条件を満たしている場合にのみ適切です。

たとえば、ASCII エンコードオブジェクト内のすべての文字を大文字に変換する変換関数は、上記の両方の条件を満たします。変換はオブジェクトの一部に適用でき、変換前に Range パラメータを適用すると、変換後にパラメータを適用するのと同じ結果が得られます。

対照的に、ASCII エンコードされたオブジェクトの文字を反転する関数は、これらの条件を満たしていません。このような関数は、部分的なオブジェクト範囲に適用できるため、基準 1 を満たしています。ただし、基準 2 を満たしていません。なぜなら、Range パラメータを変換前に適用した場合と、変換後にパラメータを適用する場合とは結果が異なるためです。

コンテンツ abcdefg を含むオブジェクトの最初の 3 文字に関数を適用するリクエストを考えてみましょう。変換前にの Range パラメータを適用すると abc のみが取得され、その後、データを逆にして戻すと cba が取得されます。しかし、変換後にパラメータが適用された場合、関数はオブジェクト全体を取得し、それを反転し、Range パラメータを適用して、gfe を返します。これらの結果は異なるため、この関数は Amazon S3 からオブジェクトを取得する際に、Range パラメータを適用すべきではありません。代わりに、オブジェクト全体を取得し、変換を実行してから、Range パラメータを適用する必要があります。

アプリケーションがアプローチ B の基準を満たしていれば、要求されたオブジェクト範囲のみをフェッチし、その範囲で変換を実行することで、AWS Lambda 関数を単純化することができます。

次の Java コードの例では、次の処理を実行する方法を示します。

private HttpRequest.Builder applyRangeHeader(ObjectLambdaEvent event, HttpRequest.Builder presignedRequest) {
    var header = event.getUserRequest().getHeaders().entrySet().stream()
            .filter(e -> e.getKey().toLowerCase(Locale.ROOT).equals("range"))
            .findFirst();

    // Add check in the query string itself.
    header.ifPresent(entry -> presignedRequest.header(entry.getKey(), entry.getValue()));
    return presignedRequest;
}