@aws-cdk/region-info
Advanced tools
Package description
@aws-cdk/region-info is an AWS CDK library that provides information about AWS regions and services. It allows developers to programmatically access details about AWS regions, such as the services available in each region, region names, and partition information.
Get Region Information
This feature allows you to get information about a specific AWS region. In this example, it retrieves the name of the 'us-east-1' region.
const regionInfo = require('@aws-cdk/region-info');
const region = regionInfo.RegionInfo.get('us-east-1');
console.log(region.name); // Output: US East (N. Virginia)Check if a Service is Available in a Region
This feature allows you to check if a specific AWS service is available in a given region. In this example, it checks if the S3 service is available in the 'us-east-1' region.
const regionInfo = require('@aws-cdk/region-info');
const region = regionInfo.RegionInfo.get('us-east-1');
const isAvailable = region.servicePrincipal('s3') !== undefined;
console.log(isAvailable); // Output: trueGet Partition Information
This feature allows you to get the partition information for a specific region. In this example, it retrieves the partition for the 'us-east-1' region, which is 'aws'.
const regionInfo = require('@aws-cdk/region-info');
const partition = regionInfo.RegionInfo.get('us-east-1').partition;
console.log(partition); // Output: awsThe aws-sdk package is the official AWS SDK for JavaScript. It provides a comprehensive set of tools for interacting with AWS services, including region and service information. However, it is more general-purpose and not as focused on region-specific information as @aws-cdk/region-info.
The aws-regions package provides a list of AWS regions and their associated information. It is similar to @aws-cdk/region-info but is more lightweight and does not integrate with the AWS CDK.
Changelog
1.135.0 (2021-12-10)
authorizerName
in HttpJwtAuthorizerProps has changed.HttpJwtAuthorizer now takes the
construct id and the target jwt issuer as part of its constructor.HttpLambdaAuthorizer now takes
the construct id and the target lambda function handler as part of
its constructor.authorizerName in HttpUserPoolAuthorizerProps has changed.HttpIntegration and WebSocketIntegration
classes require an "id" parameter to be provided during its initialization.LambdaWebSocketIntegration is now
renamed to WebSocketLambdaIntegration. The new class accepts the
handler to the target lambda function directly in its constructor.HttpProxyIntegration and
HttpProxyIntegrationProps are now renamed to HttpUrlIntegration
and HttpUrlIntegrationProps respectively. The new class accepts the
target url directly in its constructor.LambdaProxyIntegration and
LambdaProxyIntegrationProps are now renamed to
HttpLambdaIntegration and HttpLambdaIntegrationProps respectively.
The new class accepts the lambda function handler directly in its
constructor.HttpAlbIntegration now accepts the
ELB listener directly in its constructor.HttpNlbIntegration now accepts the
ELB listener directly in its constructor.HttpServiceDiscoveryIntegration now
accepts the service discovery Service directly in its constructor.UserPoolAuthorizerProps is now
renamed to HttpUserPoolAuthorizerProps.IHttpRouteIntegration is replaced by
the abstract class HttpRouteIntegration.IWebSocketRouteIntegration is now
replaced by the abstract class WebSocketRouteIntegration.HttpApi instances
(or WebSocketApi instances). This is now disallowed, and separate
instances must be created for each instance of HttpApi or
WebSocketApi.fromGroupName() for IAM groups (#17243) (29b379c)stringLike() (#17692) (37596e6)Stage (#17730) (f17f29e), closes #17643waitForReplicationToFinish fails deployment (#17842) (36b8fdb), closes #16983nodeModules (#17851) (5737c33), closes #17830nodeModules fails with paths containing spaces (#17632) (986f291), closes #17631Readme
Some information used in CDK Applications differs from one AWS region to another, such as service principals used in IAM policies, S3 static website endpoints, ...
RegionInfo classThe library offers a simple interface to obtain region specific information in
the form of the RegionInfo class. This is the preferred way to interact with
the regional information database:
import { RegionInfo } from '@aws-cdk/region-info';
// Get the information for "eu-west-1":
const region = RegionInfo.get('eu-west-1');
// Access attributes:
region.s3StaticWebsiteEndpoint; // s3-website-eu-west-1.amazonaws.com
region.servicePrincipal('logs.amazonaws.com'); // logs.eu-west-1.amazonaws.com
The RegionInfo layer is built on top of the Low-Level API, which is described
below and can be used to register additional data, including user-defined facts
that are not available through the RegionInfo interface.
This library offers a primitive database of such information so that CDK
constructs can easily access regional information. The FactName class provides
a list of known fact names, which can then be used with the RegionInfo to
retrieve a particular value:
import * as regionInfo from '@aws-cdk/region-info';
const codeDeployPrincipal = regionInfo.Fact.find('us-east-1', regionInfo.FactName.servicePrincipal('codedeploy.amazonaws.com'));
// => codedeploy.us-east-1.amazonaws.com
const staticWebsite = regionInfo.Fact.find('ap-northeast-1', regionInfo.FactName.S3_STATIC_WEBSITE_ENDPOINT);
// => s3-website-ap-northeast-1.amazonaws.com
As new regions are released, it might happen that a particular fact you need is
missing from the library. In such cases, the Fact.register method can be used
to inject FactName into the database:
regionInfo.Fact.register({
region: 'bermuda-triangle-1',
name: regionInfo.FactName.servicePrincipal('s3.amazonaws.com'),
value: 's3-website.bermuda-triangle-1.nowhere.com',
});
In the event information provided by the library is incorrect, it can be
overridden using the same Fact.register method demonstrated above, simply
adding an extra boolean argument:
regionInfo.Fact.register({
region: 'us-east-1',
name: regionInfo.FactName.servicePrincipal('service.amazonaws.com'),
value: 'the-correct-principal.amazonaws.com',
}, true /* Allow overriding information */);
If you happen to have stumbled upon incorrect data built into this library, it is always a good idea to report your findings in a GitHub issue, so we can fix it for everyone else!
This module is part of the AWS Cloud Development Kit project.
FAQs
AWS region information, such as service principal names
The npm package @aws-cdk/region-info receives a total of 225,644 weekly downloads. As such, @aws-cdk/region-info popularity was classified as popular.
We found that @aws-cdk/region-info demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Deno's Standard Library has stabilized after four years of development, offering developers a collection of well-maintained tools compatible with Deno, Node.js, Cloudflare Workers, and browsers with bundlers.
Security News
Trivial packages, while convenient, can introduce significant risks such as dependency bloat, security vulnerabilities, and performance issues in modern software projects.
Security News
PyPI has drastically improved its malware response times, resolving 90% of issues in under 24 hours and removing 900 projects since March 2024.