@aws-sdk/middleware-endpoint-discovery

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

@aws-sdk/middleware-endpoint-discovery is a middleware package for the AWS SDK for JavaScript. It provides functionality to automatically discover and cache endpoints for AWS services that support endpoint discovery. This can help improve performance and reliability by reducing the need to repeatedly look up endpoints.

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

Automatic Endpoint Discovery

This feature enables automatic endpoint discovery for AWS services. In this example, the S3Client is configured to enable endpoint discovery. When the ListBucketsCommand is sent, the middleware will automatically discover and cache the appropriate endpoint.

const { EndpointDiscoveryMiddleware } = require('@aws-sdk/middleware-endpoint-discovery');
const { S3Client, ListBucketsCommand } = require('@aws-sdk/client-s3');

const client = new S3Client({
  region: 'us-west-2',
  endpointDiscoveryEnabled: true
});

const command = new ListBucketsCommand({});

client.send(command).then((data) => {
  console.log(data);
}).catch((error) => {
  console.error(error);
});

Manual Endpoint Discovery

This feature allows for manual configuration of endpoint discovery. In this example, the EndpointDiscoveryMiddleware is manually added to the middleware stack of the S3Client. The middleware is configured to require a discovered endpoint.

const { EndpointDiscoveryMiddleware } = require('@aws-sdk/middleware-endpoint-discovery');
const { S3Client, ListBucketsCommand } = require('@aws-sdk/client-s3');

const client = new S3Client({
  region: 'us-west-2'
});

const command = new ListBucketsCommand({});

client.middlewareStack.add(EndpointDiscoveryMiddleware({
  isDiscoveredEndpointRequired: true
}), {
  step: 'build',
  priority: 'high'
});

client.send(command).then((data) => {
  console.log(data);
}).catch((error) => {
  console.error(error);
});

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

@aws-sdk/middleware-retry

@aws-sdk/middleware-retry provides retry logic for AWS SDK requests. It is similar to @aws-sdk/middleware-endpoint-discovery in that it enhances the reliability of AWS SDK operations, but it focuses on retrying failed requests rather than discovering endpoints.

@aws-sdk/middleware-signing

@aws-sdk/middleware-signing handles the signing of AWS SDK requests. While @aws-sdk/middleware-endpoint-discovery focuses on discovering and caching endpoints, @aws-sdk/middleware-signing ensures that requests are properly authenticated and authorized.

@aws-sdk/middleware-logger

@aws-sdk/middleware-logger provides logging capabilities for AWS SDK requests and responses. It is similar in that it adds additional functionality to the AWS SDK middleware stack, but it focuses on logging rather than endpoint discovery.

README

@aws-sdk/middleware-endpoint-discovery

Changelog

3.496.0 (2024-01-19)

Bug Fixes

• get full list of exports for esm compat in dist-cjs (#5694) (5d26da6)
• revert "feat(credential-provider-node): use dynamic import for credential providers (#5677)" (4cea583)

Features

• client-athena: Introducing new NotebookS3LocationUri parameter to Athena ImportNotebook API. Payload is no longer required and either Payload or NotebookS3LocationUri needs to be provided (not both) for a successful ImportNotebook API call. If both are provided, an InvalidRequestException will be thrown. (a8ed592)
• client-codebuild: Release CodeBuild Reserved Capacity feature (c0c445d)
• client-dynamodb: This release adds support for including ApproximateCreationDateTimePrecision configurations in EnableKinesisStreamingDestination API, adds the same as an optional field in the response of DescribeKinesisStreamingDestination, and adds support for a new UpdateKinesisStreamingDestination API. (2be6625)
• client-qconnect: Increased Quick Response name max length to 100 (b02d4af)
• clients: update client endpoints as of 2024-01-19 (cb1bc4e)
• credential-provider-node: use dynamic import for credential providers (#5677) (7841411)