---
id: aws-cdk-region-info
version: "2.265.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.region-info — AWS region information, such as service principal names

License: permissive · Maintenance: active · Downloads: 201.9K/mo

## What it is and what it does

aws-cdk.region-info is a reference database of AWS region-specific metadata needed by CDK constructs and applications. It exposes region information through a high-level RegionInfo class (querying by region name to get attributes like S3 static website endpoints) and a low-level Fact API for direct lookups by region and fact name. The library also allows registration of custom or corrected facts to override built-in data.

The package is a lightweight, pure-Python dependency with only jsii and publication as runtime requirements. It supports Python 3.10 through 3.14 and is part of the official AWS CDK ecosystem, maintained actively with no known security vulnerabilities.

Use it for:

- Retrieve S3 static website endpoints for a given AWS region in CDK constructs.
- Look up service principal names for IAM policies that vary by region.
- Register custom regional facts or override incorrect built-in data for your CDK application.
- Query region-specific configuration needed by cross-region CDK deployments.
- Inject region-dependent metadata into CDK stacks without hardcoding values.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a queryable database of AWS region-specific information such as service principals and S3 endpoints for use in CDK applications.

Yes. This is a stable, actively maintained library with low install friction, no security issues, and permissive licensing. Install it if you are building AWS CDK applications that need region-specific metadata such as service principals or S3 endpoints; it is the standard way to access such data in the CDK ecosystem.

## Install

pip install aws-cdk-region-info
uv add aws-cdk-region-info
poetry add aws-cdk-region-info

## Installing aws-cdk.region-info

Before you install: Low install friction with a pure Python wheel. Actively maintained as part of the AWS CDK project with a recent release and no known vulnerabilities.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in most commercial and open-source projects without significant restrictions.

Quickstart:

pip install aws-cdk.region-info

from aws_cdk import region_info

region = region_info.RegionInfo.get("eu-west-1")
endpoint = region.s3_static_website_endpoint

Requires Python 3.10 or later.

Verify before relying:

- Whether the regional fact database is kept current with new AWS regions and service changes.
- Performance characteristics when querying large numbers of regions or facts in succession.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 201.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws region info lookup, cdk regional data, aws service principals by region, s3 endpoint regional, region-specific aws facts, cdk region database, aws regional configuration, aws-cdk, infrastructure-as-code

[View on SkillFed](https://skillfed.io/packages/aws-cdk-region-info) · [View on PyPI](https://pypi.org/project/aws-cdk-region-info/)