@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.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)