GeoRestriction

class aws_cdk.aws_cloudfront.GeoRestriction(*args: Any, **kwargs)

Bases: object

Controls the countries in which content is distributed.

ExampleMetadata

infused

Example:

# Adding restrictions to a Cloudfront Web Distribution.
# source_bucket is of type Bucket

cloudfront.CloudFrontWebDistribution(self, "MyDistribution",
    origin_configs=[cloudfront.SourceConfiguration(
        s3_origin_source=cloudfront.S3OriginConfig(
            s3_bucket_source=source_bucket
        ),
        behaviors=[cloudfront.Behavior(is_default_behavior=True)]
    )
    ],
    geo_restriction=cloudfront.GeoRestriction.whitelist("US", "UK")
)

Attributes

locations

Two-letter, uppercase country code for a country that you want to allow/deny.

Include one element for each country. See ISO 3166-1-alpha-2 code on the International Organization for Standardization website

Return type

List[str]

restriction_type

Specifies the restriction type to impose.

Return type

str

Static Methods

classmethod allowlist(*locations)

Allow specific countries which you want CloudFront to distribute your content.

Parameters

locations (str) – Two-letter, uppercase country code for a country that you want to allow. Include one element for each country. See ISO 3166-1-alpha-2 code on the International Organization for Standardization website

Return type

GeoRestriction

classmethod blacklist(*locations)

(deprecated) DEPRECATED.

Parameters

locations (str) –

Deprecated

use denylist

Stability

deprecated

Return type

GeoRestriction

classmethod denylist(*locations)

Deny specific countries which you don’t want CloudFront to distribute your content.

Parameters

locations (str) – Two-letter, uppercase country code for a country that you want to deny. Include one element for each country. See ISO 3166-1-alpha-2 code on the International Organization for Standardization website

Return type

GeoRestriction

classmethod whitelist(*locations)

(deprecated) DEPRECATED.

Parameters

locations (str) –

Deprecated

use allowlist

Stability

deprecated

Return type

GeoRestriction