Metadata-Version: 2.1
Name: aws-cdk.region-info
Version: 1.87.0
Summary: AWS region information, such as service principal names
Home-page: https://github.com/aws/aws-cdk
Author: Amazon Web Services
License: Apache-2.0
Project-URL: Source, https://github.com/aws/aws-cdk.git
Description: # AWS Region-Specific Information Directory
        
        <!--BEGIN STABILITY BANNER-->---
        
        
        ![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)
        
        > The APIs of higher level constructs in this module are experimental and under active development.
        > They are subject to non-backward compatible changes or removal in any future version. These are
        > not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be
        > announced in the release notes. This means that while you may use them, you may need to update
        > your source code when upgrading to a newer version of this package.
        
        ---
        <!--END STABILITY BANNER-->
        
        ## 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:
        
        ```python
        # Example automatically generated. See https://github.com/aws/jsii/issues/826
        from aws_cdk.region_info import RegionInfo
        
        # Get the information for "eu-west-1":
        region = RegionInfo.get("eu-west-1")
        
        # Access attributes:
        region.s3_static_website_endpoint# s3-website-eu-west-1.amazonaws.com
        region.service_principal("logs.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.
        
        ### 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:
        
        ```python
        # Example automatically generated. See https://github.com/aws/jsii/issues/826
        import aws_cdk.region_info as region_info
        
        code_deploy_principal = region_info.Fact.find("us-east-1", region_info.FactName.service_principal("codedeploy.amazonaws.com"))
        # => codedeploy.us-east-1.amazonaws.com
        
        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:
        
        ```python
        # Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
        region_info.Fact.register(
            region="bermuda-triangle-1",
            name=region_info.FactName.service_principal("s3.amazonaws.com"),
            value="s3-website.bermuda-triangle-1.nowhere.com"
        )
        ```
        
        ## 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:
        
        ```python
        # Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
        region_info.Fact.register({
            "region": "us-east-1",
            "name": region_info.FactName.service_principal("service.amazonaws.com"),
            "value": "the-correct-principal.amazonaws.com"
        }, 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](https://github.com/aws/aws-cdk/issues), so we can fix
        it for everyone else!
        
        ---
        
        
        This module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Typing :: Typed
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved
Classifier: Framework :: AWS CDK
Classifier: Framework :: AWS CDK :: 1
Requires-Python: >=3.6
Description-Content-Type: text/markdown
