@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.654.0 (2024-09-18)

Bug Fixes

• codegen: fix setting of default signing name (#6487) (108bb99)
• middleware-flexible-checksums: use union for new config types (#6489) (c43103f)

Features

• client-cost-explorer: This release extends the GetReservationPurchaseRecommendation API to support recommendations for Amazon DynamoDB reservations. (6976388)
• client-directory-service-data: Added new AWS Directory Service Data API, enabling you to manage data stored in AWS Directory Service directories. This includes APIs for creating, reading, updating, and deleting directory users, groups, and group memberships. (8c9372b)
• client-directory-service: Added new APIs for enabling, disabling, and describing access to the AWS Directory Service Data API (cca80dd)
• client-guardduty: Add launchType and sourceIPs fields to GuardDuty findings. (13c3582)
• client-mailmanager: Introduce a new RuleSet condition evaluation, where customers can set up a StringExpression with a MimeHeader condition. This condition will perform the necessary validation based on the X-header provided by customers. (900a39e)
• client-s3: Added SSE-KMS support for directory buckets. (a00b8b0)