GeoRestriction
A complex type that controls the countries in which your content is distributed. CloudFront
determines the location of your users using MaxMind
GeoIP databases.
Contents
- Quantity
-
When geo restriction is
enabled
, this is the number of countries in yourwhitelist
orblacklist
. Otherwise, when it is not enabled,Quantity
is0
, and you can omitItems
.Type: Integer
Required: Yes
- RestrictionType
-
The method that you want to use to restrict distribution of your content by country:
-
none
: No geo restriction is enabled, meaning access to content is not restricted by client geo location. -
blacklist
: TheLocation
elements specify the countries in which you don't want CloudFront to distribute your content. -
whitelist
: TheLocation
elements specify the countries in which you want CloudFront to distribute your content.
Type: String
Valid Values:
blacklist | whitelist | none
Required: Yes
-
- Items
-
A complex type that contains a
Location
element for each country in which you want CloudFront either to distribute your content (whitelist
) or not distribute your content (blacklist
).The
Location
element is a two-letter, uppercase country code for a country that you want to include in yourblacklist
orwhitelist
. Include oneLocation
element for each country.CloudFront and
MaxMind
both useISO 3166
country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2
code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.Type: Array of strings
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: