@aws-sdk/middleware-bucket-endpoint

What is @aws-sdk/middleware-bucket-endpoint?

The @aws-sdk/middleware-bucket-endpoint package is part of the AWS SDK for JavaScript (v3). It provides middleware that automatically configures the endpoint for S3 bucket operations, allowing users to interact with different S3 bucket configurations and regions more seamlessly. This package is particularly useful for managing requests to S3 buckets by modifying the endpoint based on the operation and the provided bucket parameters.

What are @aws-sdk/middleware-bucket-endpoint's main functionalities?

Automatic Endpoint Resolution

This code sample demonstrates how to integrate the bucketEndpointMiddleware into an S3 client instance. It automatically resolves the correct endpoint for the bucket specified in the command.

import { S3Client, GetObjectCommand } from '@aws-sdk/client-s3';
import { bucketEndpointMiddleware } from '@aws-sdk/middleware-bucket-endpoint';

const client = new S3Client({
  region: 'us-west-2',
  middlewareStack: {
    add: (middleware) => middleware(bucketEndpointMiddleware())
  }
});

const command = new GetObjectCommand({ Bucket: 'example-bucket', Key: 'example-object' });
client.send(command);

Other packages similar to @aws-sdk/middleware-bucket-endpoint

@aws-sdk/middleware-sdk-s3

This package includes various middleware utilities for S3 operations within the AWS SDK for JavaScript. It offers functionalities similar to @aws-sdk/middleware-bucket-endpoint but is broader in scope, covering more aspects of S3 interactions beyond just endpoint resolution.

@aws-sdk/s3-request-presigner

While primarily focused on generating pre-signed URLs for S3 requests, this package interacts with S3 endpoints in a manner that complements the functionalities provided by @aws-sdk/middleware-bucket-endpoint. It handles endpoint resolution implicitly when generating URLs.

README

@aws-sdk/middleware-bucket-endpoint

Changelog

3.433.0 (2023-10-20)

Bug Fixes

• codegen: use partial record for enum keyed types (#5391) (70c2107)
• credential-provider-http: add undeclared dependency (#5395) (b926b5b)

Features

• client-appconfig: Update KmsKeyIdentifier constraints to support AWS KMS multi-Region keys. (81a0ee6)
• client-appintegrations: Updated ScheduleConfig to be an optional input to CreateDataIntegration to support event driven downloading of files from sources such as Amazon s3 using Amazon Connect AppIntegrations. (14cf31c)
• client-application-discovery-service: This release introduces three new APIs: StartBatchDeleteConfigurationTask, DescribeBatchDeleteConfigurationTask, and BatchDeleteAgents. (e82998a)
• client-connect: This release adds support for updating phone number metadata, such as phone number description. (963f743)
• client-ssm: This release introduces a new API: DeleteOpsItem. This allows deletion of an OpsItem. (7120ec9)
• clients: update client endpoints as of 2023-10-20 (74b4aad)