{ "author": { "name": "Amazon Web Services", "organization": true, "roles": [ "author" ], "url": "https://aws.amazon.com" }, "description": "AWS region information, such as service principal names", "docs": { "stability": "stable" }, "homepage": "https://github.com/aws/aws-cdk", "jsiiVersion": "5.9.56 (build 0265a5f)", "keywords": [ "aws", "cdk" ], "license": "Apache-2.0", "metadata": { "jsii": { "compiledWithDeprecationWarnings": true, "pacmak": { "hasDefaultInterfaces": true }, "rosetta": { "strict": true } } }, "name": "@aws-cdk/region-info", "readme": { "markdown": "# AWS Region-Specific Information Directory\n\n## Usage\n\nSome information used in CDK Applications differs from one AWS region to\nanother, such as service principals used in IAM policies, S3 static website\nendpoints, ...\n\n### The `RegionInfo` class\n\nThe library offers a simple interface to obtain region specific information in\nthe form of the `RegionInfo` class. This is the preferred way to interact with\nthe regional information database:\n\n```ts\n// Get the information for \"eu-west-1\":\nconst region = regionInfo.RegionInfo.get('eu-west-1');\n\n// Access attributes:\nregion.s3StaticWebsiteEndpoint; // s3-website-eu-west-1.amazonaws.com\n```\n\nThe `RegionInfo` layer is built on top of the Low-Level API, which is described\nbelow and can be used to register additional data, including user-defined facts\nthat are not available through the `RegionInfo` interface.\n\n### Low-Level API\n\nThis library offers a primitive database of such information so that CDK\nconstructs can easily access regional information. The `FactName` class provides\na list of known fact names, which can then be used with the `RegionInfo` to\nretrieve a particular value:\n\n```ts\nconst staticWebsite = regionInfo.Fact.find(\n 'ap-northeast-1',\n regionInfo.FactName.S3_STATIC_WEBSITE_ENDPOINT\n);\n// => s3-website-ap-northeast-1.amazonaws.com\n```\n\n## Supplying new or missing information\n\nAs new regions are released, it might happen that a particular fact you need is\nmissing from the library. In such cases, the `Fact.register` method can be used\nto inject FactName into the database:\n\n```ts\nclass MyFact implements regionInfo.IFact {\n public readonly region = 'bermuda-triangle-1';\n public readonly name = regionInfo.FactName.S3_STATIC_WEBSITE_ENDPOINT;\n public readonly value = 's3-website.bermuda-triangle-1.nowhere.com';\n}\n\nregionInfo.Fact.register(new MyFact());\n```\n\n## Overriding incorrect information\n\nIn the event information provided by the library is incorrect, it can be\noverridden using the same `Fact.register` method demonstrated above, simply\nadding an extra boolean argument:\n\n```ts\nclass MyFact implements regionInfo.IFact {\n public readonly region = 'us-east-1';\n public readonly name = regionInfo.FactName.S3_STATIC_WEBSITE_ENDPOINT;\n public readonly value = 'the-correct-endpoint.amazonaws.com';\n}\n\nregionInfo.Fact.register(new MyFact(), true /* Allow overriding information */);\n```\n\nIf you happen to have stumbled upon incorrect data built into this library, it\nis always a good idea to report your findings in a [GitHub issue], so we can fix\nit for everyone else!\n\n[GitHub issue]: https://github.com/aws/aws-cdk/issues\n\n---\n\nThis module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project.\n" }, "repository": { "directory": "packages/@aws-cdk/region-info", "type": "git", "url": "https://github.com/aws/aws-cdk.git" }, "schema": "jsii/0.10.0", "targets": { "dotnet": { "iconUrl": "https://raw.githubusercontent.com/aws/aws-cdk/main/logo/default-256-dark.png", "namespace": "Amazon.CDK.RegionInfo", "packageId": "Amazon.CDK.RegionInfo" }, "java": { "maven": { "artifactId": "cdk-region-info", "groupId": "software.amazon.awscdk" }, "package": "software.amazon.awscdk.regioninfo" }, "js": { "npm": "@aws-cdk/region-info" }, "python": { "classifiers": [ "Framework :: AWS CDK", "Framework :: AWS CDK :: 2" ], "distName": "aws-cdk.region-info", "module": "aws_cdk.region_info" } }, "types": { "@aws-cdk/region-info.Default": { "assembly": "@aws-cdk/region-info", "docs": { "deprecated": "- Service principals are now globally `.amazonaws.com`, use iam.ServicePrincipal instead.", "remarks": "This class is no longer needed because service principals are no longer needed except in very specific cases\nthat are handled in the IAM ServicePrincipal class.", "stability": "deprecated", "summary": "Provides default values for certain regional information points." }, "fqn": "@aws-cdk/region-info.Default", "kind": "class", "locationInModule": { "filename": "lib/default.ts", "line": 7 }, "methods": [ { "docs": { "deprecated": "- Service principals are now globally `.amazonaws.com`, use iam.ServicePrincipal instead.", "remarks": "This is useful for example when\nyou need to compute a service principal name, but you do not have a synthesize-time region literal available (so\nall you have is `{ \"Ref\": \"AWS::Region\" }`). This way you get the same defaulting behavior that is normally used\nfor built-in data.", "stability": "deprecated", "summary": "Computes a \"standard\" AWS Service principal for a given service, region and suffix." }, "locationInModule": { "filename": "lib/default.ts", "line": 29 }, "name": "servicePrincipal", "parameters": [ { "docs": { "summary": "the name of the service (s3, s3.amazonaws.com, ...)." }, "name": "serviceFqn", "type": { "primitive": "string" } }, { "docs": { "summary": "the region in which the service principal is needed." }, "name": "region", "type": { "primitive": "string" } }, { "docs": { "summary": "deprecated and ignored." }, "name": "urlSuffix", "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true } ], "name": "Default", "properties": [ { "const": true, "docs": { "deprecated": "- Use VpceEndpointService.DEFAULT_PREFIX instead", "stability": "deprecated", "summary": "The default value for a VPC Endpoint Service name prefix, useful if you do not have a synthesize-time region literal available (all you have is `{ \"Ref\": \"AWS::Region\" }`)." }, "immutable": true, "locationInModule": { "filename": "lib/default.ts", "line": 15 }, "name": "VPC_ENDPOINT_SERVICE_NAME_PREFIX", "static": true, "type": { "primitive": "string" } } ], "symbolId": "lib/default:Default" }, "@aws-cdk/region-info.Fact": { "assembly": "@aws-cdk/region-info", "docs": { "stability": "stable", "summary": "A database of regional information." }, "fqn": "@aws-cdk/region-info.Fact", "kind": "class", "locationInModule": { "filename": "lib/fact.ts", "line": 20 }, "methods": [ { "docs": { "stability": "stable", "summary": "Return all pairs of (region, factName) that are defined." }, "locationInModule": { "filename": "lib/fact.ts", "line": 42 }, "name": "definedFacts", "returns": { "type": { "collection": { "elementtype": { "collection": { "elementtype": { "primitive": "string" }, "kind": "array" } }, "kind": "array" } } }, "static": true }, { "docs": { "returns": "the fact value if it is known, and `undefined` otherwise.", "stability": "stable", "summary": "Retrieves a fact from this Fact database." }, "locationInModule": { "filename": "lib/fact.ts", "line": 57 }, "name": "find", "parameters": [ { "docs": { "summary": "the name of the region (e.g: `us-east-1`)." }, "name": "region", "type": { "primitive": "string" } }, { "docs": { "summary": "the name of the fact being looked up (see the `FactName` class for details)." }, "name": "name", "type": { "primitive": "string" } } ], "returns": { "optional": true, "type": { "primitive": "string" } }, "static": true }, { "docs": { "stability": "stable", "summary": "Registers a new fact in this Fact database." }, "locationInModule": { "filename": "lib/fact.ts", "line": 85 }, "name": "register", "parameters": [ { "docs": { "summary": "the new fact to be registered." }, "name": "fact", "type": { "fqn": "@aws-cdk/region-info.IFact" } }, { "docs": { "summary": "whether new facts can replace existing facts or not." }, "name": "allowReplacing", "optional": true, "type": { "primitive": "boolean" } } ], "static": true }, { "docs": { "remarks": "(retrieval will fail if the specified region or\nfact name does not exist.)", "stability": "stable", "summary": "Retrieve a fact from the Fact database." }, "locationInModule": { "filename": "lib/fact.ts", "line": 69 }, "name": "requireFact", "parameters": [ { "docs": { "summary": "the name of the region (e.g: `us-east-1`)." }, "name": "region", "type": { "primitive": "string" } }, { "docs": { "summary": "the name of the fact being looked up (see the `FactName` class for details)." }, "name": "name", "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true }, { "docs": { "stability": "stable", "summary": "Removes a fact from the database." }, "locationInModule": { "filename": "lib/fact.ts", "line": 102 }, "name": "unregister", "parameters": [ { "docs": { "summary": "the region for which the fact is to be removed." }, "name": "region", "type": { "primitive": "string" } }, { "docs": { "summary": "the name of the fact to remove." }, "name": "name", "type": { "primitive": "string" } }, { "docs": { "summary": "the value that should be removed (removal will fail if the value is specified, but does not match the current stored value)." }, "name": "value", "optional": true, "type": { "primitive": "string" } } ], "static": true } ], "name": "Fact", "properties": [ { "docs": { "remarks": "All facts will be present in at least one region.", "stability": "stable", "summary": "Returns the list of names of registered facts." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 35 }, "name": "names", "static": true, "type": { "collection": { "elementtype": { "primitive": "string" }, "kind": "array" } } }, { "docs": { "returns": "the list of names of AWS Regions for which there is at least one registered fact. This\nincludes Regions defined in AWS_REGIONS plus custom defined regions.", "stability": "stable" }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 25 }, "name": "regions", "static": true, "type": { "collection": { "elementtype": { "primitive": "string" }, "kind": "array" } } } ], "symbolId": "lib/fact:Fact" }, "@aws-cdk/region-info.FactName": { "assembly": "@aws-cdk/region-info", "docs": { "stability": "stable", "summary": "All standardized fact names.", "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as region_info from '@aws-cdk/region-info';\nconst factName = new region_info.FactName();", "custom": { "exampleMetadata": "fixture=_generated" } }, "fqn": "@aws-cdk/region-info.FactName", "initializer": { "docs": { "stability": "stable" } }, "kind": "class", "locationInModule": { "filename": "lib/fact.ts", "line": 142 }, "methods": [ { "docs": { "stability": "stable", "summary": "The ARN of Amazon Distro for OpenTelemetry (ADOT) Lambda layer for a given lambda type, version and architecture." }, "locationInModule": { "filename": "lib/fact.ts", "line": 259 }, "name": "adotLambdaLayer", "parameters": [ { "docs": { "summary": "the type of the ADOT lambda layer." }, "name": "type", "type": { "primitive": "string" } }, { "docs": { "summary": "the layer version." }, "name": "version", "type": { "primitive": "string" } }, { "docs": { "summary": "the Lambda Function architecture (e.g. 'x86_64' or 'arm64')." }, "name": "architecture", "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true }, { "docs": { "stability": "stable", "summary": "The ARN of AppConfig Lambda Layer for a given version (e.g. 2.0.181)." }, "locationInModule": { "filename": "lib/fact.ts", "line": 234 }, "name": "appConfigLambdaLayerVersion", "parameters": [ { "docs": { "summary": "The layer version." }, "name": "version", "type": { "primitive": "string" } }, { "docs": { "summary": "The architecture (optional), defaults to x86_64." }, "name": "arch", "optional": true, "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true }, { "docs": { "stability": "stable", "summary": "The ARN of CloudWatch Lambda Insights for a version (e.g. 1.0.98.0)." }, "locationInModule": { "filename": "lib/fact.ts", "line": 222 }, "name": "cloudwatchLambdaInsightsVersion", "parameters": [ { "name": "version", "type": { "primitive": "string" } }, { "name": "arch", "optional": true, "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true }, { "docs": { "stability": "stable", "summary": "The ARN of Parameters and Secrets Lambda layer for a given lambda architecture." }, "locationInModule": { "filename": "lib/fact.ts", "line": 270 }, "name": "paramsAndSecretsLambdaLayer", "parameters": [ { "docs": { "summary": "the layer version." }, "name": "version", "type": { "primitive": "string" } }, { "docs": { "summary": "the Lambda Function architecture (e.g. 'x86_64' or 'arm64')." }, "name": "architecture", "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true }, { "docs": { "deprecated": "- Use `iam.ServicePrincipal.servicePrincipalName()` instead.", "stability": "deprecated", "summary": "The name of the regional service principal for a given service." }, "locationInModule": { "filename": "lib/fact.ts", "line": 248 }, "name": "servicePrincipal", "parameters": [ { "docs": { "summary": "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." }, "name": "service", "type": { "primitive": "string" } } ], "returns": { "type": { "primitive": "string" } }, "static": true } ], "name": "FactName", "properties": [ { "const": true, "docs": { "stability": "stable", "summary": "The ID of the AWS account that owns the public ECR repository that contains the AWS App Mesh Envoy Proxy images in a given region." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 202 }, "name": "APPMESH_ECR_ACCOUNT", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "remarks": "The value is a boolean\nmodelled as `YES` or `NO`.", "stability": "stable", "summary": "Whether the AWS::CDK::Metadata CloudFormation Resource is available in-region or not." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 157 }, "name": "CDK_METADATA_RESOURCE_AVAILABLE", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The ID of the AWS account that owns the public ECR repository that contains the AWS Deep Learning Containers images in a given region." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 196 }, "name": "DLC_REPOSITORY_ACCOUNT", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The domain suffix for a region (e.g: 'amazonaws.com`)." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 151 }, "name": "DOMAIN_SUFFIX", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The hosted zone ID used by Route 53 to alias a EBS environment endpoint in this region (e.g: Z2O1EMRO9K5GLX)." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 178 }, "name": "EBS_ENV_ENDPOINT_HOSTED_ZONE_ID", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The account for ELBv2 in this region." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 190 }, "name": "ELBV2_ACCOUNT", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The CIDR block used by Amazon Data Firehose servers." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 207 }, "name": "FIREHOSE_CIDR_BLOCK", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "remarks": "The value is a boolean\nmodelled as `YES` or `NO`.", "stability": "stable", "summary": "Whether the given region is an opt-in region or not." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 163 }, "name": "IS_OPT_IN_REGION", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The latest Lambda NodeJS runtime available in a given region." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 217 }, "name": "LATEST_NODE_RUNTIME", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The name of the partition for a region (e.g: 'aws', 'aws-cn', ...)." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 146 }, "name": "PARTITION", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The endpoint used for hosting S3 static websites." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 168 }, "name": "S3_STATIC_WEBSITE_ENDPOINT", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The endpoint used for aliasing S3 static websites in Route 53." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 173 }, "name": "S3_STATIC_WEBSITE_ZONE_53_HOSTED_ZONE_ID", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The SAML Sign On URL for partition used by IAM SAML Principal." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 212 }, "name": "SAML_SIGN_ON_URL", "static": true, "type": { "primitive": "string" } }, { "const": true, "docs": { "stability": "stable", "summary": "The prefix for VPC Endpoint Service names, cn.com.amazonaws.vpce for China regions, com.amazonaws.vpce otherwise." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 185 }, "name": "VPC_ENDPOINT_SERVICE_NAME_PREFIX", "static": true, "type": { "primitive": "string" } } ], "symbolId": "lib/fact:FactName" }, "@aws-cdk/region-info.IFact": { "assembly": "@aws-cdk/region-info", "docs": { "stability": "stable", "summary": "A fact that can be registered about a particular region." }, "fqn": "@aws-cdk/region-info.IFact", "kind": "interface", "locationInModule": { "filename": "lib/fact.ts", "line": 122 }, "name": "IFact", "properties": [ { "abstract": true, "docs": { "remarks": "Standardized values are provided by the `Facts` class.", "stability": "stable", "summary": "The name of this fact." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 131 }, "name": "name", "type": { "primitive": "string" } }, { "abstract": true, "docs": { "stability": "stable", "summary": "The region for which this fact applies." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 126 }, "name": "region", "type": { "primitive": "string" } }, { "abstract": true, "docs": { "stability": "stable", "summary": "The value of this fact." }, "immutable": true, "locationInModule": { "filename": "lib/fact.ts", "line": 136 }, "name": "value", "optional": true, "type": { "primitive": "string" } } ], "symbolId": "lib/fact:IFact" }, "@aws-cdk/region-info.RegionInfo": { "assembly": "@aws-cdk/region-info", "docs": { "stability": "stable", "summary": "Information pertaining to an AWS region.", "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as region_info from '@aws-cdk/region-info';\nconst regionInfo = region_info.RegionInfo.get('name');", "custom": { "exampleMetadata": "fixture=_generated" } }, "fqn": "@aws-cdk/region-info.RegionInfo", "kind": "class", "locationInModule": { "filename": "lib/region-info.ts", "line": 7 }, "methods": [ { "docs": { "stability": "stable", "summary": "Obtain region info for a given region name." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 60 }, "name": "get", "parameters": [ { "docs": { "summary": "the name of the region (e.g: us-east-1)." }, "name": "name", "type": { "primitive": "string" } } ], "returns": { "type": { "fqn": "@aws-cdk/region-info.RegionInfo" } }, "static": true }, { "docs": { "returns": "a mapping with AWS region codes as the keys,\nand the fact in the given region as the value for that key", "stability": "stable", "summary": "Retrieves a collection of all fact values for all regions, limited to some partitions." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 45 }, "name": "limitedRegionMap", "parameters": [ { "docs": { "remarks": "For a list of common fact names, see the FactName class", "summary": "the name of the fact to retrieve values for." }, "name": "factName", "type": { "primitive": "string" } }, { "docs": { "remarks": "Defaults\nto `['aws', 'aws-cn']`.", "summary": "list of partitions to retrieve facts for." }, "name": "partitions", "type": { "collection": { "elementtype": { "primitive": "string" }, "kind": "array" } } } ], "returns": { "type": { "collection": { "elementtype": { "primitive": "string" }, "kind": "map" } } }, "static": true }, { "docs": { "returns": "a mapping with AWS region codes as the keys,\nand the fact in the given region as the value for that key", "stability": "stable", "summary": "Retrieves a collection of all fact values for all regions that fact is defined in." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 24 }, "name": "regionMap", "parameters": [ { "docs": { "remarks": "For a list of common fact names, see the FactName class", "summary": "the name of the fact to retrieve values for." }, "name": "factName", "type": { "primitive": "string" } } ], "returns": { "type": { "collection": { "elementtype": { "primitive": "string" }, "kind": "map" } } }, "static": true }, { "docs": { "stability": "stable", "summary": "The ARN of the ADOT Lambda layer, for the given layer type, version and architecture." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 189 }, "name": "adotLambdaLayerArn", "parameters": [ { "docs": { "summary": "the type of the ADOT lambda layer." }, "name": "type", "type": { "primitive": "string" } }, { "docs": { "summary": "the layer version." }, "name": "version", "type": { "primitive": "string" } }, { "docs": { "summary": "the Lambda Function architecture (e.g. 'x86_64' or 'arm64')." }, "name": "architecture", "type": { "primitive": "string" } } ], "returns": { "optional": true, "type": { "primitive": "string" } } }, { "docs": { "stability": "stable", "summary": "The ARN of the AppConfig Lambda Layer, for the given version." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 163 }, "name": "appConfigLambdaArn", "parameters": [ { "docs": { "summary": "The layer version (e.g. 2.0.181)." }, "name": "layerVersion", "type": { "primitive": "string" } }, { "docs": { "summary": "The Lambda Function architecture (e.g. 'x86_64' or 'arm64'), defaults to x86_64." }, "name": "architecture", "optional": true, "type": { "primitive": "string" } } ], "returns": { "optional": true, "type": { "primitive": "string" } } }, { "docs": { "stability": "stable", "summary": "The ARN of the CloudWatch Lambda Insights extension, for the given version." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 154 }, "name": "cloudwatchLambdaInsightsArn", "parameters": [ { "docs": { "summary": "the version (e.g. 1.0.98.0)." }, "name": "insightsVersion", "type": { "primitive": "string" } }, { "docs": { "summary": "the Lambda Function architecture (e.g. 'x86_64' or 'arm64')." }, "name": "architecture", "optional": true, "type": { "primitive": "string" } } ], "returns": { "optional": true, "type": { "primitive": "string" } } }, { "docs": { "stability": "stable", "summary": "The ARN of the Parameters and Secrets Lambda layer for the given lambda architecture." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 199 }, "name": "paramsAndSecretsLambdaLayerArn", "parameters": [ { "docs": { "summary": "the layer version." }, "name": "version", "type": { "primitive": "string" } }, { "docs": { "summary": "the Lambda Function architecture (e.g. 'x86_64' or 'arm64')." }, "name": "architecture", "type": { "primitive": "string" } } ], "returns": { "optional": true, "type": { "primitive": "string" } } }, { "docs": { "deprecated": "- Use `iam.ServicePrincipal.servicePrincipalName()` instead.", "stability": "deprecated", "summary": "The name of the service principal for a given service in this region." }, "locationInModule": { "filename": "lib/region-info.ts", "line": 130 }, "name": "servicePrincipal", "parameters": [ { "docs": { "summary": "the service name (e.g: s3.amazonaws.com)." }, "name": "service", "type": { "primitive": "string" } } ], "returns": { "optional": true, "type": { "primitive": "string" } } } ], "name": "RegionInfo", "properties": [ { "docs": { "returns": "the list of names of AWS regions for which there is at least one registered fact. This\nmay not be an exaustive list of all available AWS regions.", "stability": "stable" }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 12 }, "name": "regions", "static": true, "type": { "collection": { "elementtype": { "fqn": "@aws-cdk/region-info.RegionInfo" }, "kind": "array" } } }, { "docs": { "stability": "stable", "summary": "Whether the `AWS::CDK::Metadata` CloudFormation Resource is available in this region or not." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 69 }, "name": "cdkMetadataResourceAvailable", "type": { "primitive": "boolean" } }, { "docs": { "stability": "stable", "summary": "Whether the given region is an opt-in region." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 76 }, "name": "isOptInRegion", "type": { "primitive": "boolean" } }, { "docs": { "stability": "stable" }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 64 }, "name": "name", "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The ID of the AWS account that owns the public ECR repository that contains the AWS App Mesh Envoy Proxy images in a given region." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 171 }, "name": "appMeshRepositoryAccount", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The ID of the AWS account that owns the public ECR repository containing the AWS Deep Learning Containers images in this region." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 145 }, "name": "dlcRepositoryAccount", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The domain name suffix (e.g: amazonaws.com) for this region." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 83 }, "name": "domainSuffix", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The hosted zone ID used by Route 53 to alias a EBS environment endpoint in this region (e.g: Z2O1EMRO9K5GLX)." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 111 }, "name": "ebsEnvEndpointHostedZoneId", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The account ID for ELBv2 in this region." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 137 }, "name": "elbv2Account", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The CIDR block used by Amazon Data Firehose servers." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 178 }, "name": "firehoseCidrBlock", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The name of the ARN partition for this region (e.g: aws)." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 90 }, "name": "partition", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The endpoint used by S3 static website hosting in this region (e.g: s3-static-website-us-east-1.amazonaws.com)." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 97 }, "name": "s3StaticWebsiteEndpoint", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The hosted zone ID used by Route 53 to alias a S3 static website in this region (e.g: Z2O1EMRO9K5GLX)." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 104 }, "name": "s3StaticWebsiteHostedZoneId", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "SAML Sign On URL used by IAM SAML Principals." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 206 }, "name": "samlSignOnUrl", "optional": true, "type": { "primitive": "string" } }, { "docs": { "stability": "stable", "summary": "The prefix for VPC Endpoint Service names, cn.com.amazonaws.vpce for China regions, com.amazonaws.vpce otherwise." }, "immutable": true, "locationInModule": { "filename": "lib/region-info.ts", "line": 120 }, "name": "vpcEndpointServiceNamePrefix", "optional": true, "type": { "primitive": "string" } } ], "symbolId": "lib/region-info:RegionInfo" } }, "version": "2.274.0", "fingerprint": "**********" }