AWS Region-Specific Information Directory
Usage
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, ...
The RegionInfo class
The 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:
# Get the information for "eu-west-1":
region = region_info.RegionInfo.get("eu-west-1")
# Access attributes:
region.s3_static_website_endpoint
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.
Low-Level API
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:
static_website = region_info.Fact.find("ap-northeast-1", region_info.FactName.S3_STATIC_WEBSITE_ENDPOINT)
Supplying new or missing information
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:
@jsii.implements(region_info.IFact)
class MyFact:
region_info.Fact.register(MyFact())
Overriding incorrect information
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:
@jsii.implements(region_info.IFact)
class MyFact:
region_info.Fact.register(MyFact(), True)
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.
2 maintainers
Metadata
2 maintainers
Release files for aws-cdk.region-info 2.276.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aws_cdk_region_info-2.276.0.tar.gz | 308.8 kB | Without provenance | Details for aws_cdk_region_info-2.276.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aws_cdk_region_info-2.276.0-py3-none-any.whl | Python 3 | none | any | Details for aws_cdk_region_info-2.276.0-py3-none-any.whl |
Total release size: 615.8 kB
Release files / aws_cdk_region_info-2.276.0.tar.gz
| Download URL | aws_cdk_region_info-2.276.0.tar.gz |
|---|---|
| Size | 308.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7df4ff0da8c5318884d7bbf788ef224151f384373ffe688c4953f32552a479bb
|
|
BLAKE2b-256 checksum How to use checksums |
f8d097186d14190e0dc1d923d5e1b306340445a1af8d0604c31b5bbf73c09cfb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.18
|
Release files / aws_cdk_region_info-2.276.0-py3-none-any.whl
| Download URL | aws_cdk_region_info-2.276.0-py3-none-any.whl |
|---|---|
| Size | 307.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5c19c26b7ea489af677ebf70e606722b210ebef173271e55df4ba5f670e30436
|
|
BLAKE2b-256 checksum How to use checksums |
3c1c3a8108389a47211aab9072c854baf17ddea130047335f970c046386c7194
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.18
|
Security for aws-cdk.region-info 2.276.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
