@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.168.0 (2022-09-09)

Bug Fixes

• e2e: fix "eventually" helper in e2e tests (#3917) (fac9c18)

Features

• client-cloudtrail: This release adds CloudTrail getChannel and listChannels APIs to allow customer to view the ServiceLinkedChannel configurations. (3c7cfa2)
• client-lex-models-v2: This release is for supporting Composite Slot Type feature in AWS Lex V2. Composite Slot Type will help developer to logically group coherent slots and maintain their inter-relationships in runtime conversation. (b45fc65)
• client-lex-runtime-v2: This release is for supporting Composite Slot Type feature in AWS Lex V2. Composite Slot Type will help developer to logically group coherent slots and maintain their inter-relationships in runtime conversation. (e01fa5e)
• client-pi: Increases the maximum values of two RDS Performance Insights APIs. The maximum value of the Limit parameter of DimensionGroup is 25. The MaxResult maximum is now 25 for the following APIs: DescribeDimensionKeys, GetResourceMetrics, ListAvailableResourceDimensions, and ListAvailableResourceMetrics. (2f5c346)
• clients: update client endpoints as of 2022-09-09 (a5dc90b)