@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.775.0 (2025-03-25)

Bug Fixes

• core/httpAuthSchemes: allow extensions to set signer credentials (#6971) (8b6fe4c)
• packages: maintain singleton config object (#6959) (6034850)

Features

• client-bedrock-agent: Adding support for Amazon OpenSearch Managed clusters as a vector database in Knowledge Bases for Amazon Bedrock (100062a)
• client-eks: Added support to override upgrade-blocking readiness checks via force flag when updating a cluster. (55f5a70)
• client-gameliftstreams: Minor updates to improve developer experience. (b6b01de)
• client-keyspaces: Removing replication region limitation for Amazon Keyspaces Multi-Region Replication APIs. (254cb39)
• client-marketplace-entitlement-service: This release enhances the GetEntitlements API to support new filter CUSTOMER_AWS_ACCOUNT_ID in request and CustomerAWSAccountId field in response. (17b1041)
• client-marketplace-metering: This release enhances the BatchMeterUsage API to support new field CustomerAWSAccountId in request and response and making CustomerIdentifier optional. CustomerAWSAccountId or CustomerIdentifier must be provided in request but not both. (540d2d0)
• client-sagemaker: This release adds support for customer-managed KMS keys in Amazon SageMaker Partner AI Apps (03a1150)
• client-workspaces-thin-client: Deprecate tags field in Get API responses (026ba53)
• clients: update client endpoints as of 2025-03-25 (5fd070a)