Utilisation des en-têtes Range et partNumber

Mapper le paramètre Range ou partNumber demandé à l’objet transformé (recommandé)

La méthode la plus fiable pour traiter les requêtes Range et partNumber consiste à effectuer les opérations suivantes :

Pour ce faire, utilisez l’URL présignée fournie afin de récupérer l’objet entier d’Amazon S3, puis traitez l’objet au besoin. Pour voir une fonction Lambda qui traite un paramètre Range de cette façon, consultez cet exemple dans le référentiel AWS Samples GitHub.

Mappez l’élément Range demandé sur l’URL présignée.

Dans certains cas, votre fonction Lambda peut mapper l’élément Range demandé directement sur l’URL présignée pour récupérer uniquement une partie de l’objet à partir d’Amazon S3. Cette approche n’est appropriée que si votre transformation répond aux deux critères suivants :

Par exemple, une fonction de transformation qui convertit tous les caractères d’un objet codé en ASCII en majuscules répond aux deux critères précédents. La transformation peut être appliquée à une partie d’un objet, et l’application du paramètre Range avant la transformation donne le même résultat que son application après la transformation.

En revanche, une fonction qui rétablit les caractères d’un objet codé en ASCII ne répond pas à ces critères. Cette fonction répond au critère 1, car elle peut être appliquée à des plages d’objets partielles. Cependant, elle ne répond pas au critère 2, car le paramètre Range appliqué avant la transformation ne donne pas le même résultat que lorsqu’il est appliqué après la transformation.

Prenons une demande d’application de la fonction aux trois premiers caractères d’un objet avec le contenu abcdefg. Si le paramètre Range est appliqué avant la transformation, il récupère uniquement abc, puis rétablit les données et renvoie cba. Mais si le paramètre est appliqué après la transformation, la fonction récupère l’objet entier, le rétablit, puis applique le paramètre Range et renvoie gfe. Étant donné que ces résultats sont différents, cette fonction ne doit pas appliquer le paramètre Range lors de la récupération de l’objet à partir d’Amazon S3. À la place, elle doit récupérer l’objet entier, effectuer la transformation, et seulement alors appliquer le paramètre Range.

Si votre application répond aux critères décrits précédemment dans l’approche B, vous pouvez simplifier votre fonction AWS Lambda en extrayant uniquement la plage d’objet demandée, puis en exécutant votre transformation sur cette plage.

L’exemple de code Java suivant montre comment effectuer les opérations suivantes :

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;
}