@aws-sdk/region-config-resolver

What is @aws-sdk/region-config-resolver?

The @aws-sdk/region-config-resolver package is part of the AWS SDK for JavaScript (v3). It provides utilities to resolve AWS region configurations in a flexible manner. This package is particularly useful when building applications that need to interact with various AWS services across different regions.

What are @aws-sdk/region-config-resolver's main functionalities?

Resolving region configuration

This feature allows the automatic resolution of the AWS region by checking environment variables, AWS configuration files, and other sources. It simplifies handling region-specific configurations in your application.

const { defaultRegionResolver } = require('@aws-sdk/region-config-resolver');

const region = defaultRegionResolver();
console.log(region);

Custom region resolution

This feature enables developers to define custom strategies for resolving the AWS region, such as prioritizing environment variables or specific profiles in shared configuration files. It provides flexibility in how regions are determined based on the application's needs.

const { fromEnv, fromSharedConfigFiles } = require('@aws-sdk/region-config-resolver');

const customRegion = fromEnv() || fromSharedConfigFiles({ profile: 'myProfile' });
console.log(customRegion);

Other packages similar to @aws-sdk/region-config-resolver

@aws-sdk/credential-provider-node

This package handles the resolution and provision of AWS credentials rather than regions. It is similar in that it also deals with configuration for AWS services, but focuses on authentication instead of regional settings.

@aws-sdk/client-s3

While primarily a client library for Amazon S3, this package includes utilities for handling region-specific endpoints. It is similar to @aws-sdk/region-config-resolver in that it also needs to manage region data, but it is specific to S3 interactions.

README

@aws-sdk/region-config-resolver

An internal package

This package provides utilities for AWS region config resolvers.

Usage

You probably shouldn't, at least directly.

Changelog

3.662.0 (2024-10-01)

Bug Fixes

• s3-request-presigner: enable overriding hoistable headers (#6535) (3c2e59c)

Features

• client-bedrock-agent: This release adds support to stop an ongoing ingestion job using the StopIngestionJob API in Agents for Amazon Bedrock. (ac89806)
• client-codeartifact: Add support for the dual stack endpoints. (cb499b9)
• client-rds: This release provides additional support for enabling Aurora Limitless Database DB clusters. (b7b061d)
• clients: update client endpoints as of 2024-10-01 (15702eb)