@aws-sdk/middleware-host-header

What is @aws-sdk/middleware-host-header?

The @aws-sdk/middleware-host-header npm package is part of the AWS SDK for JavaScript (v3). It is a middleware that is used for setting the host header in the request. This is particularly useful when making HTTP requests to AWS services, ensuring that the host header matches the service endpoint. This can be critical for the proper routing and handling of requests within AWS's infrastructure.

What are @aws-sdk/middleware-host-header's main functionalities?

Setting Host Header

This code demonstrates how to add the hostHeaderMiddleware to an AWS SDK client instance. In this example, an S3 client is created, and the middleware is added to automatically set the host header when sending a PutObjectCommand. This ensures that the request is properly routed to the intended AWS service endpoint.

"use strict";
const { S3Client, PutObjectCommand } = require('@aws-sdk/client-s3');
const { hostHeaderMiddleware } = require('@aws-sdk/middleware-host-header');

const client = new S3Client({});
client.middlewareStack.add(hostHeaderMiddleware(), {
  step: 'build',
  name: 'hostHeaderMiddleware',
  tags: { SET_HOST_HEADER: true },
  priority: 'high',
});

const command = new PutObjectCommand({
  Bucket: 'example-bucket',
  Key: 'example-object',
  Body: 'Hello, world!'
});

client.send(command).then((response) => {
  console.log('Success', response);
}).catch((error) => {
  console.error('Error', error);
});

Other packages similar to @aws-sdk/middleware-host-header

@aws-sdk/middleware-logger

Similar to @aws-sdk/middleware-host-header, @aws-sdk/middleware-logger is also a middleware for the AWS SDK for JavaScript (v3) but focuses on logging requests and responses. While host-header middleware ensures the correct host header is set for service requests, the logger middleware provides insights into the request lifecycle, making it easier to debug and monitor AWS SDK operations.

@aws-sdk/middleware-retry

Another middleware in the AWS SDK for JavaScript (v3), @aws-sdk/middleware-retry, provides automatic retry functionality for requests that fail due to transient errors. Unlike @aws-sdk/middleware-host-header, which ensures the correct host header, the retry middleware automatically retries requests based on predefined policies and strategies, helping to improve the robustness of applications interacting with AWS services.

README

@aws-sdk/middleware-host-header

Changelog

3.198.0 (2022-10-27)

Bug Fixes

• scripts: use since origin/main for ci (#4101) (1335bfb)
• types: make logger.trace an optional function (#4110) (7d95b34)
• update eventStreamPayloadHandler to also get prior signature from query string (#4100) (d6d9e10)

Features

• client-ec2: Feature supports the replacement of instance root volume using an updated AMI without requiring customers to stop their instance. (c980e67)
• client-fms: Add support NetworkFirewall Managed Rule Group Override flag in GetViolationDetails API (7586f6e)
• client-glue: Added support for custom datatypes when using custom csv classifier. (3711a1f)
• client-sagemaker: This change allows customers to provide a custom entrypoint script for the docker container to be run while executing training jobs, and provide custom arguments to the entrypoint script. (4978352)
• client-wafv2: This release adds the following: Challenge rule action, to silently verify client browsers; rule group rule action override to any valid rule action, not just Count; token sharing between protected applications for challenge/CAPTCHA token; targeted rules option for Bot Control managed rule group. (2d06b27)
• clients: update client endpoints as of 2022-10-27 (6eafddf)
• endpoint: log endpoint decisions at debug level (#4106) (d600213)