/** * A database of regional information. */ export declare class Fact { /** * @returns the list of names of AWS regions for which there is at least one registered fact. This * may not be an exhaustive list of all available AWS regions. */ static get regions(): string[]; /** * Retrieves a fact from this Fact database. * * @param region the name of the region (e.g: `us-east-1`) * @param name the name of the fact being looked up (see the `FactName` class for details) * * @returns the fact value if it is known, and `undefined` otherwise. */ static find(region: string, name: string): string | undefined; /** * Retrieve a fact from the Fact database. (retrieval will fail if the specified region or * fact name does not exist.) * * @param region the name of the region (e.g: `us-east-1`) * @param name the name of the fact being looked up (see the `FactName` class for details) */ static requireFact(region: string, name: string): string; /** * Registers a new fact in this Fact database. * * @param fact the new fact to be registered. * @param allowReplacing whether new facts can replace existing facts or not. */ static register(fact: IFact, allowReplacing?: boolean): void; /** * Removes a fact from the database. * @param region the region for which the fact is to be removed. * @param name the name of the fact to remove. * @param value the value that should be removed (removal will fail if the value is specified, but does not match the * current stored value). */ static unregister(region: string, name: string, value?: string): void; private static readonly database; private constructor(); } /** * A fact that can be registered about a particular region. */ export interface IFact { /** * The region for which this fact applies. */ readonly region: string; /** * The name of this fact. Standardized values are provided by the `Facts` class. */ readonly name: string; /** * The value of this fact. */ readonly value: string | undefined; } /** * All standardized fact names. */ export declare class FactName { /** * The name of the partition for a region (e.g: 'aws', 'aws-cn', ...) */ static readonly PARTITION = "partition"; /** * The domain suffix for a region (e.g: 'amazonaws.com`) */ static readonly DOMAIN_SUFFIX = "domainSuffix"; /** * Whether the AWS::CDK::Metadata CloudFormation Resource is available in-region or not. The value is a boolean * modelled as `YES` or `NO`. */ static readonly CDK_METADATA_RESOURCE_AVAILABLE = "cdk:metadata-resource:available"; /** * The endpoint used for hosting S3 static websites */ static readonly S3_STATIC_WEBSITE_ENDPOINT = "s3-static-website:endpoint"; /** * The endpoint used for aliasing S3 static websites in Route 53 */ static readonly S3_STATIC_WEBSITE_ZONE_53_HOSTED_ZONE_ID = "s3-static-website:route-53-hosted-zone-id"; /** * The prefix for VPC Endpoint Service names, * cn.com.amazonaws.vpce for China regions, * com.amazonaws.vpce otherwise. */ static readonly VPC_ENDPOINT_SERVICE_NAME_PREFIX = "vpcEndpointServiceNamePrefix"; /** * The account for ELBv2 in this region */ static readonly ELBV2_ACCOUNT = "elbv2Account"; /** * The ID of the AWS account that owns the public ECR repository that contains the * AWS Deep Learning Containers images in a given region. */ static readonly DLC_REPOSITORY_ACCOUNT = "dlcRepositoryAccount"; /** * The name of the regional service principal for a given service. * * @param service the service name, either simple (e.g: `s3`, `codedeploy`) or qualified (e.g: `s3.amazonaws.com`). * The `.amazonaws.com` and `.amazonaws.com.cn` domains are stripped from service names, so they are * canonicalized in that respect. */ static servicePrincipal(service: string): string; }