/bunnycdn-cdn | Type: Application | PCID required: Yes
Tools
bunnycdn_cdn_countries_public_get_country_list
Get Country Listbunnycdn_cdn_pull_zone_public_add
Add Pull Zone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
AccessControlOriginHeaderExtensions | string[] | No | — | Sets the list of extensions that will return the CORS headers |
AddCanonicalHeader | boolean | No | — | Determines if the canonical header should be added by this zone |
AddHostHeader | boolean | No | — | Determines if the zone should forward the requested host header to the origin |
AllowedReferrers | string[] | No | — | Sets the list of referrer hostnames that are allowed to access the pull zone. Requests containing the header Referer: hostname that is not on the list will be rejected. If empty, all the referrers are allowed |
AWSSigningEnabled | boolean | No | — | Determines if the AWS signing should be enabled or not |
AWSSigningKey | string | No | — | Sets the AWS signing key |
AWSSigningRegionName | string | No | — | Sets the AWS signing region name |
AWSSigningSecret | string | No | — | Sets the AWS signing secret key |
BlockedCountries | string[] | No | — | Sets the list of two letter Alpha2 country codes that will be blocked from accessing the zone |
BlockedIps | string[] | No | — | Sets the list of IPs that are blocked from accessing the pull zone. Requests coming from the following IPs will be rejected. If empty, all the IPs will be allowed |
BlockedReferrers | string[] | No | — | Sets the list of referrer hostnames that are blocked from accessing the pull zone. |
BlockNoneReferrer | boolean | No | — | Block None Referrer |
BlockPostRequests | boolean | No | — | Determines if the POST requests to this zone should be rejected. |
BlockRootPathAccess | boolean | No | — | Determines if the zone should block requests to the root of the zone. |
BudgetRedirectedCountries | string[] | No | — | Sets the list of two letter Alpha2 country codes that will be redirected to the cheapest possible region |
BunnyAiImageBlueprints | object[] | No | — | Bunny Ai Image Blueprints |
BurstSize | integer | No | — | Determines the maximum burst requests before an IP is blocked |
CacheControlBrowserMaxAgeOverride | integer | No | — | (Deprecated) Sets the browser cache control override setting for this zone |
CacheControlMaxAgeOverride | integer | No | — | Sets the cache control override setting for this zone |
CacheControlPublicMaxAgeOverride | integer | No | — | Sets the browser cache control override setting for this zone |
CacheErrorResponses | boolean | No | — | Determines if the cache error responses should be enabled on the zone |
ConnectionLimitPerIPCount | integer | No | — | Determines the maximum number of connections per IP that will be allowed to connect to this Pull Zone |
CookieVaryParameters | string[] | No | — | Contains the list of vary parameters that will be used for vary cache by cookie string.Only alphanumeric characters, dashes and underscores are allowed (values that contain other characters are ignorred). If empty, cookie vary will not be used. |
DisableCookies | boolean | No | — | Determines if the Pull Zone should automatically remove cookies from the responses |
DisableLetsEncrypt | boolean | No | — | If set to true, the built-in let’s encrypt will be disabled and requests are passed to the origin. |
DnsOriginPort | integer | No | — | Determines the origin port of the pull zone. |
DnsOriginScheme | string | No | — | Determines the origin scheme of the pull zone. |
EdgeScriptExecutionPhase | integer | No | — | The execution phase of the edge script |
EdgeScriptId | integer | No | — | The ID of the edge script that will be used as the origin |
EnableAccessControlOriginHeader | boolean | No | — | Determines if CORS headers should be enabled |
EnableAutoSSL | boolean | No | — | If set to true, any hostnames added to this Pull Zone will automatically enable SSL. |
EnableAvifVary | boolean | No | — | Determines if the AVIF Vary feature should be enabled. |
EnableBunnyImageAi | boolean | No | — | Enable Bunny Image Ai |
EnableCacheSlice | boolean | No | — | Determines if cache slicing (Optimize for video) should be enabled for this zone |
EnableCookieVary | boolean | No | — | Determines if the Cookie Vary feature is enabled. |
EnableCountryCodeVary | boolean | No | — | Determines if the Country Code Vary feature should be enabled. |
EnableCountryStateCodeVary | boolean | No | — | Determines if the Country State Code Vary feature should be enabled. |
EnableGeoZoneAF | boolean | No | — | Determines if the delivery from the Africa region should be enabled for this pull zone |
EnableGeoZoneASIA | boolean | No | — | Determines if the delivery from the Asia / Oceania regions should be enabled for this pull zone |
EnableGeoZoneEU | boolean | No | — | Determines if the delivery from the Europe region should be enabled for this pull zone |
EnableGeoZoneSA | boolean | No | — | Determines if the delivery from the South America region should be enabled for this pull zone |
EnableGeoZoneUS | boolean | No | — | Determines if the delivery from the North America region should be enabled for this pull zone |
EnableHostnameVary | boolean | No | — | Determines if the Hostname Vary feature should be enabled. |
EnableLogging | boolean | No | — | Determines if the logging should be enabled for this zone |
EnableMobileVary | boolean | No | — | Determines if the Mobile Vary feature is enabled. |
EnableOriginShield | boolean | No | — | Determines if the origin shield should be enabled |
EnableQueryStringOrdering | boolean | No | — | Determines if the query string ordering should be enabled. |
EnableRequestCoalescing | boolean | No | — | Determines if request coalescing is currently enabled. |
EnableSafeHop | boolean | No | — | Enable Safe Hop |
EnableSmartCache | boolean | No | — | Enable Smart Cache |
EnableTLS1 | boolean | No | — | Determines if the TLS 1 should be enabled on this zone |
EnableTLS1_1 | boolean | No | — | Determines if the TLS 1.1 should be enabled on this zone |
EnableWebpVary | boolean | No | — | Determines if the WebP Vary feature should be enabled. |
EnableWebSockets | boolean | No | — | Determines if WebSocket connections are allowed for this Pull Zone. |
ErrorPageCustomCode | string | No | — | Contains the custom error page code that will be returned |
ErrorPageEnableCustomCode | boolean | No | — | Determines if custom error page code should be enabled. |
ErrorPageEnableStatuspageWidget | boolean | No | — | Determines if the statuspage widget should be displayed on the error pages |
ErrorPageStatuspageCode | string | No | — | The statuspage code that will be used to build the status widget |
ErrorPageWhitelabel | boolean | No | — | Determines if the error pages should be whitelabel or not |
FollowRedirects | boolean | No | — | Determines if the zone should follow redirects return by the oprigin and cache the response |
IgnoreQueryStrings | boolean | No | — | Determines if the Pull Zone should ignore query strings when serving cached objects (Vary by Query String) |
LimitRateAfter | number | No | — | Determines the amount of traffic transferred before the client is limited |
LimitRatePerSecond | integer | No | — | Determines the maximum number of requests per second coming from a single IP before it is blocked. |
LogAnonymizationType | integer | No | — | Sets the log anonymization type for this pull zone |
LogFormat | integer | No | — | 0 = Plain 1 = JSON |
LogForwardingEnabled | boolean | No | — | Sets the log forwarding token for the zone |
LogForwardingFormat | integer | No | — | 0 = Plain 1 = JSON |
LogForwardingHostname | string | No | — | Sets the log forwarding destination hostname for the zone |
LogForwardingPort | integer | No | — | Sets the log forwarding port for the zone |
LogForwardingProtocol | integer | No | — | Sets the log forwarding protocol type |
LogForwardingToken | string | No | — | Sets the log forwarding token for the zone |
LoggingIPAnonymizationEnabled | boolean | No | — | Determines if the log anonoymization should be enabled |
LoggingSaveToStorage | boolean | No | — | Determines if the logging permanent storage should be enabled |
LoggingStorageZoneId | integer | No | — | Sets the Storage Zone id that should contain the logs from this Pull Zone |
MagicContainersAppId | string | No | — | Magic Containers App Id |
MagicContainersEndpointId | string | No | — | Magic Containers Endpoint Id |
MaxWebSocketConnections | integer | No | — | The maximum global simultaneous WebSocket connections allowed for this Pull Zone. Allowed tiers: 500, 1,000, 2,500, 5,000, 10,000, 25,000. If you send a non-tier value, the value is rounded up to the next tier. Values over 25,000 are rejected, please contact sales if required. |
MiddlewareScriptId | integer | No | — | The ID of the middleware script |
MonthlyBandwidthLimit | integer | No | — | Sets the monthly limit of bandwidth in bytes that the pullzone is allowed to use |
Name | string | Yes | — | The name of the pull zone. |
OptimizerAutomaticOptimizationEnabled | boolean | No | — | Determines if the automatic image optimization should be enabled |
OptimizerClasses | object[] | No | — | Determines the list of optimizer classes |
OptimizerDesktopMaxWidth | integer | No | — | Determines the maximum automatic image size for desktop clients |
OptimizerEnabled | boolean | No | — | Determines if the optimizer should be enabled for this zone |
OptimizerEnableManipulationEngine | boolean | No | — | Determines the image manipulation should be enabled |
OptimizerEnableUpscaling | boolean | No | — | Determines if Optimizer should automatically upscale images |
OptimizerEnableWebP | boolean | No | — | Determines if the WebP optimization should be enabled |
OptimizerForceClasses | boolean | No | — | Determines if the optimizer classes should be forced |
OptimizerImageQuality | integer | No | — | Determines the image quality for desktop clients |
OptimizerMinifyCSS | boolean | No | — | Determines if the CSS minifcation should be enabled |
OptimizerMinifyJavaScript | boolean | No | — | Determines if the JavaScript minifcation should be enabled |
OptimizerMobileImageQuality | integer | No | — | Determines the image quality for mobile clients |
OptimizerMobileMaxWidth | integer | No | — | Determines the maximum automatic image size for mobile clients |
OptimizerPrerenderHtml | boolean | No | — | Determines if the SEO HTML prerender should be enabled |
OptimizerStaticHtmlEnabled | boolean | No | — | Determines whether optimizer static html feature enabled |
OptimizerStaticHtmlWordPressBypassCookie | string | No | — | Wordpress cookie which should be bypassed by permacache in edge rule |
OptimizerStaticHtmlWordPressPath | string | No | — | Wordpress html path which should be bypassed by permacache in edge rule |
OptimizerTunnelEnabled | boolean | No | — | Determines if the optimizer origin tunnel system should be enabled for this zone |
OptimizerWatermarkEnabled | boolean | No | — | Determines if image watermarking should be enabled |
OptimizerWatermarkMinImageSize | integer | No | — | Sets the minimum image size to which the watermark will be added |
OptimizerWatermarkOffset | number | No | — | Sets the offset of the watermark image |
OptimizerWatermarkPosition | integer | No | — | Sets the position of the watermark image |
OptimizerWatermarkUrl | string | No | — | Sets the URL of the watermark image |
OriginConnectTimeout | integer | No | — | The amount of seconds to wait when connecting to the origin. Otherwise the request will fail or retry. |
OriginHostHeader | string | No | — | Sets the host header that will be sent to the origin |
OriginResponseTimeout | integer | No | — | The amount of seconds to wait when waiting for the origin reply. Otherwise the request will fail or retry. |
OriginRetries | integer | No | — | The number of retries to the origin server |
OriginRetry5XXResponses | boolean | No | — | Determines if we should retry the request in case of a 5XX response. |
OriginRetryConnectionTimeout | boolean | No | — | Determines if we should retry the request in case of a connection timeout. |
OriginRetryDelay | integer | No | — | Determines the amount of time that the CDN should wait before retrying an origin request. |
OriginRetryResponseTimeout | boolean | No | — | Determines if we should retry the request in case of a response timeout. |
OriginShieldEnableConcurrencyLimit | boolean | No | — | Determines if the origin shield concurrency limit is enabled. |
OriginShieldMaxConcurrentRequests | integer | No | — | Determines the number of maximum concurrent requests allowed to the origin. |
OriginShieldMaxQueuedRequests | integer | No | — | Determines the max number of origin requests that will remain in the queue |
OriginShieldQueueMaxWaitTime | integer | No | — | Determines the max queue wait time |
OriginShieldZoneCode | string | No | — | Determines the zone code where the origin shield should be set up |
OriginType | integer | No | — | Determine the type of the origin for this Pull Zone |
OriginUrl | string | No | — | Sets the origin URL of the Pull Zone |
PermaCacheStorageZoneId | integer | No | — | The ID of the storage zone that should be used as the Perma-Cache |
PermaCacheType | integer | No | — | Determines Perma-Cache behavior |
PreloadingScreenCode | string | No | — | The custom preloading screen coed |
PreloadingScreenCodeEnabled | boolean | No | — | Determines if the custom preloader screen should be enabled |
PreloadingScreenDelay | integer | No | — | The delay in miliseconds after which the preloading screen will be displayed (0 - 10000ms) |
PreloadingScreenEnabled | boolean | No | — | Determines if the preloading screen is currently enabled |
PreloadingScreenLogoUrl | string | No | — | The preloading screen logo URL |
PreloadingScreenShowOnFirstVisit | boolean | No | — | Determines if the preloading screen is shown on the first load from a user. |
PreloadingScreenTheme | integer | No | — | The currently configured preloading screem theme. (0 - Light, 1 - Dark) |
QueryStringVaryParameters | string[] | No | — | Contains the list of vary parameters that will be used for vary cache by query string. Only alphanumeric characters, dashes and underscores are allowed (values that contain other characters are ignorred). If empty, all parameters will be used to construct the key. |
RequestCoalescingTimeout | integer | No | — | Determines the lock time for coalesced requests. |
RequestLimit | integer | No | — | Determines the maximum number of requests per second that will be allowed to connect to this Pull Zone |
RoutingFilters | string[] | No | — | The list of routing filters enabled for this zone |
ShieldDDosProtectionEnabled | boolean | No | — | Shield D Dos Protection Enabled |
ShieldDDosProtectionType | integer | No | — | 0 = DetectOnly 1 = ActiveStandard 2 = ActiveAggressive |
StickySessionClientHeaders | string | No | — | A set of comma-separated header names used to identify clients |
StickySessionCookieName | string | No | — | Sticky Session Cookie Name |
StickySessionType | integer | No | — | Whether to use a Sticky Session mechanism for this pull zone |
StorageZoneId | integer | No | — | The ID of the storage zone that will be used as the origin |
Type | integer | No | — | The type of the pull zone. Premium = 0, Volume = 1 |
UseBackgroundUpdate | boolean | No | — | Determines if cache update is performed in the background. |
UseStaleWhileOffline | boolean | No | — | Determines if we should use stale cache while the origin is offline |
UseStaleWhileUpdating | boolean | No | — | Determines if we should use stale cache while cache is updating |
VerifyOriginSSL | boolean | No | — | Determines if the SSL certificate should be verified when connecting to the origin |
ZoneSecurityEnabled | boolean | No | — | Determines if the zone token authentication security should be enabled |
ZoneSecurityIncludeHashRemoteIP | boolean | No | — | Determines if the token authentication IP validation should be enabled |
bunnycdn_cdn_pull_zone_public_add_allowed_referrer
Add Allowed Referer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname that will be added as an allowed referer |
bunnycdn_cdn_pull_zone_public_add_blocked_ip
Add Blocked IP Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
BlockedIp | string | Yes | — | The IP that will be blocked from accessing the pull zone |
bunnycdn_cdn_pull_zone_public_add_blocked_referrer
Add Blocked Referer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname that will be added as a blocked referer |
bunnycdn_cdn_pull_zone_public_add_certificate
Add Custom Certificate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Certificate | string | Yes | — | The Base64 encoded binary data of the certificate file |
CertificateKey | string | Yes | — | The Base64 encoded binary data of the certificate key file |
Hostname | string | Yes | — | The hostname to which the hostname will be added |
bunnycdn_cdn_pull_zone_public_add_edge_rule
Add/Update Edge Rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pullZoneId | integer | Yes | — | The ID of the Pull Zone where the Edge Rule will be created |
ActionParameter1 | string | No | — | The Action parameter 1. The value depends on other parameters of the edge rule. |
ActionParameter2 | string | No | — | The Action parameter 2. The value depends on other parameters of the edge rule. |
ActionParameter3 | string | No | — | The Action parameter 3. The value depends on other parameters of the edge rule. |
ActionType | integer | No | — | The action type of the edge rule. ForceSSL = 0, Redirect = 1, OriginUrl = 2, OverrideCacheTime = 3, BlockRequest = 4, SetResponseHeader = 5, SetRequestHeader = 6, ForceDownload = 7, DisableTokenAuthentication = 8, EnableTokenAuthentication = 9, OverrideCacheTimePublic = 10, IgnoreQueryString = 11, DisableOptimizer = 12, ForceCompression = 13, SetStatusCode = 14, BypassPermaCache = 15, OverrideBrowserCacheTime = 16 |
Description | string | No | — | The description of the edge rule |
Enabled | boolean | No | — | Determines if the edge rule is currently enabled or not |
ExtraActions | object[] | No | — | Extra Actions |
Guid | string | No | — | The unique GUID of the edge rule |
OrderIndex | integer | No | — | The index of the edge rule in the list of execution priority |
ReadOnly | boolean | No | — | Determines if the edge rule is read-only and cannot be modified or deleted |
TriggerMatchingType | integer | No | — | The trigger matching type. MatchAny = 0, MatchAll = 1, MatchNone = 2 |
Triggers | object[] | No | — | The triggers value |
bunnycdn_cdn_pull_zone_public_add_hostname
Add Custom Hostname Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname that will be added |
bunnycdn_cdn_pull_zone_public_check_availability
Check the pull zone availability Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Name | string | No | — | Determines the name of the zone that we are checking |
bunnycdn_cdn_pull_zone_public_complete_external_dns_certificate
Complete External DNS Certificate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
body | string | Yes | — | The hostname that the certificate will be loaded for |
bunnycdn_cdn_pull_zone_public_delete
Delete Pull Zone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the Pull Zone that should be deleted |
bunnycdn_cdn_pull_zone_public_delete_edge_rule
Delete Edge Rule Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pullZoneId | integer | Yes | — | The ID of the Pull Zone that contains the Edge Rule |
edgeRuleId | string | Yes | — | The ID of the Edge Rule that should be deleted |
bunnycdn_cdn_pull_zone_public_index
Get Pull Zone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the Pull Zone that should be returned |
includeCertificate | boolean | No | — | Determines if the result hostnames should contain the SSL certificate |
bunnycdn_cdn_pull_zone_public_index_all
List Pull Zones Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | The page number to return. When set to 0 (default), all items are returned as a plain array. When set to a value greater than 0, items are returned in a paginated response object. |
perPage | integer | No | — | Number of results per page |
search | string | No | — | The search term that will be used to filter the results |
includeCertificate | boolean | No | — | Determines if the result hostnames should contain the SSL certificate |
bunnycdn_cdn_pull_zone_public_load_free_certificate
Load Free Certificate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hostname | string | Yes | — | The hostname that the certificate will be loaded for |
useOnlyHttp01 | boolean | No | — | If false and a Bunny DNS Zone exists for the domain, DNS01 validation we be attempted. This has no effect on wildcard domains, as this can only use DNS01 |
bunnycdn_cdn_pull_zone_public_optimizer_statistics
Get Optimizer Statistics Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pullZoneId | integer | Yes | — | (Optional) If set, the statistics will be only returned for the given Pull Zone |
dateFrom | string | No | — | (Optional) The start date of the statistics. If no value is passed, the last 30 days will be returned. |
dateTo | string | No | — | (Optional) The end date of the statistics. If no value is passed, the last 30 days will be returned. |
hourly | boolean | No | — | (Optional) If true, the statistics data will be returned in hourly groupping. |
bunnycdn_cdn_pull_zone_public_origin_shield_concurrency_statistics
Get Origin Shield Queue Statistics Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pullZoneId | integer | Yes | — | (Optional) If set, the statistics will be only returned for the given Pull Zone |
dateFrom | string | No | — | (Optional) The start date of the statistics. If no value is passed, the last 30 days will be returned. |
dateTo | string | No | — | (Optional) The end date of the statistics. If no value is passed, the last 30 days will be returned. |
hourly | boolean | No | — | (Optional) If true, the statistics data will be returned in hourly groupping. |
bunnycdn_cdn_pull_zone_public_purge_cache_post_by_tag
Purge Cache Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the Pull Zone that should be cleared |
CacheTag | string | No | — | Cache Tag |
bunnycdn_cdn_pull_zone_public_remove_allowed_referrer
Remove Allowed Referer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname that will be removed as an allowed referer |
bunnycdn_cdn_pull_zone_public_remove_blocked_ip
Remove Blocked IP Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
BlockedIp | string | Yes | — | The IP that will be removed fromt he block list |
bunnycdn_cdn_pull_zone_public_remove_blocked_referrer
Remove Blocked Referer Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname that will be removed as an allowed referer |
bunnycdn_cdn_pull_zone_public_remove_certificate
Remove Certificate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname from which the certificate will be removed |
bunnycdn_cdn_pull_zone_public_remove_hostname
Remove Custom Hostname Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
Hostname | string | Yes | — | The hostname that will be removed |
bunnycdn_cdn_pull_zone_public_request_external_dns_certificate
Request External DNS Certificate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
body | string | Yes | — | The hostname that the certificate will be requested for |
bunnycdn_cdn_pull_zone_public_safe_hop_statistics
Get SafeHop Statistics Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pullZoneId | integer | Yes | — | (Optional) If set, the statistics will be only returned for the given Pull Zone |
dateFrom | string | No | — | (Optional) The start date of the statistics. If no value is passed, the last 30 days will be returned. |
dateTo | string | No | — | (Optional) The end date of the statistics. If no value is passed, the last 30 days will be returned. |
hourly | boolean | No | — | (Optional) If true, the statistics data will be returned in hourly groupping. |
bunnycdn_cdn_pull_zone_public_set_edge_rule_enabled
Set Edge Rule Enabled Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pullZoneId | integer | Yes | — | The ID of the Pull Zone that contains the Edge Rule |
edgeRuleId | string | Yes | — | The ID of the Edge Rule that should be updated |
Id | integer | No | — | The id value |
Value | boolean | No | — | The value value |
bunnycdn_cdn_pull_zone_public_set_force_ssl
Set Force SSL Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
ForceSSL | boolean | Yes | — | Set to true to force SSL on the given pull zone hostname |
Hostname | string | Yes | — | The hostname that will be updated |
bunnycdn_cdn_pull_zone_public_update_private_key_type
Change hostname private key type Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The hostname that the private key type will be updated on |
Hostname | string | Yes | — | The hostname value |
KeyType | integer | Yes | — | 0 = Ecdsa 1 = Rsa |
bunnycdn_cdn_pull_zone_public_update_pull_zone
Update Pull Zone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the Pull Zone that should be updated |
AccessControlOriginHeaderExtensions | string[] | No | — | Sets the list of extensions that will return the CORS headers |
AddCanonicalHeader | boolean | No | — | Determines if the canonical header should be added by this zone |
AddHostHeader | boolean | No | — | Determines if the zone should forward the requested host header to the origin |
AllowedReferrers | string[] | No | — | Sets the list of referrer hostnames that are allowed to access the pull zone. Requests containing the header Referer: hostname that is not on the list will be rejected. If empty, all the referrers are allowed |
AWSSigningEnabled | boolean | No | — | Determines if the AWS signing should be enabled or not |
AWSSigningKey | string | No | — | Sets the AWS signing key |
AWSSigningRegionName | string | No | — | Sets the AWS signing region name |
AWSSigningSecret | string | No | — | Sets the AWS signing secret key |
BlockedCountries | string[] | No | — | Sets the list of two letter Alpha2 country codes that will be blocked from accessing the zone |
BlockedIps | string[] | No | — | Sets the list of IPs that are blocked from accessing the pull zone. Requests coming from the following IPs will be rejected. If empty, all the IPs will be allowed |
BlockedReferrers | string[] | No | — | Sets the list of referrer hostnames that are blocked from accessing the pull zone. |
BlockNoneReferrer | boolean | No | — | Block None Referrer |
BlockPostRequests | boolean | No | — | Determines if the POST requests to this zone should be rejected. |
BlockRootPathAccess | boolean | No | — | Determines if the zone should block requests to the root of the zone. |
BudgetRedirectedCountries | string[] | No | — | Sets the list of two letter Alpha2 country codes that will be redirected to the cheapest possible region |
BunnyAiImageBlueprints | object[] | No | — | Bunny Ai Image Blueprints |
BurstSize | integer | No | — | Determines the maximum burst requests before an IP is blocked |
CacheControlBrowserMaxAgeOverride | integer | No | — | (Deprecated) Sets the browser cache control override setting for this zone |
CacheControlMaxAgeOverride | integer | No | — | Sets the cache control override setting for this zone |
CacheControlPublicMaxAgeOverride | integer | No | — | Sets the browser cache control override setting for this zone |
CacheErrorResponses | boolean | No | — | Determines if the cache error responses should be enabled on the zone |
ConnectionLimitPerIPCount | integer | No | — | Determines the maximum number of connections per IP that will be allowed to connect to this Pull Zone |
CookieVaryParameters | string[] | No | — | Contains the list of vary parameters that will be used for vary cache by cookie string.Only alphanumeric characters, dashes and underscores are allowed (values that contain other characters are ignorred). If empty, cookie vary will not be used. |
DisableCookies | boolean | No | — | Determines if the Pull Zone should automatically remove cookies from the responses |
DisableLetsEncrypt | boolean | No | — | If set to true, the built-in let’s encrypt will be disabled and requests are passed to the origin. |
DnsOriginPort | integer | No | — | Determines the origin port of the pull zone. |
DnsOriginScheme | string | No | — | Determines the origin scheme of the pull zone. |
EdgeScriptExecutionPhase | integer | No | — | The execution phase of the edge script |
EdgeScriptId | integer | No | — | The ID of the edge script that will be used as the origin |
EnableAccessControlOriginHeader | boolean | No | — | Determines if CORS headers should be enabled |
EnableAutoSSL | boolean | No | — | If set to true, any hostnames added to this Pull Zone will automatically enable SSL. |
EnableAvifVary | boolean | No | — | Determines if the AVIF Vary feature should be enabled. |
EnableBunnyImageAi | boolean | No | — | Enable Bunny Image Ai |
EnableCacheSlice | boolean | No | — | Determines if cache slicing (Optimize for video) should be enabled for this zone |
EnableCookieVary | boolean | No | — | Determines if the Cookie Vary feature is enabled. |
EnableCountryCodeVary | boolean | No | — | Determines if the Country Code Vary feature should be enabled. |
EnableCountryStateCodeVary | boolean | No | — | Determines if the Country State Code Vary feature should be enabled. |
EnableGeoZoneAF | boolean | No | — | Determines if the delivery from the Africa region should be enabled for this pull zone |
EnableGeoZoneASIA | boolean | No | — | Determines if the delivery from the Asia / Oceania regions should be enabled for this pull zone |
EnableGeoZoneEU | boolean | No | — | Determines if the delivery from the Europe region should be enabled for this pull zone |
EnableGeoZoneSA | boolean | No | — | Determines if the delivery from the South America region should be enabled for this pull zone |
EnableGeoZoneUS | boolean | No | — | Determines if the delivery from the North America region should be enabled for this pull zone |
EnableHostnameVary | boolean | No | — | Determines if the Hostname Vary feature should be enabled. |
EnableLogging | boolean | No | — | Determines if the logging should be enabled for this zone |
EnableMobileVary | boolean | No | — | Determines if the Mobile Vary feature is enabled. |
EnableOriginShield | boolean | No | — | Determines if the origin shield should be enabled |
EnableQueryStringOrdering | boolean | No | — | Determines if the query string ordering should be enabled. |
EnableRequestCoalescing | boolean | No | — | Determines if request coalescing is currently enabled. |
EnableSafeHop | boolean | No | — | Enable Safe Hop |
EnableSmartCache | boolean | No | — | Enable Smart Cache |
EnableTLS1 | boolean | No | — | Determines if the TLS 1 should be enabled on this zone |
EnableTLS1_1 | boolean | No | — | Determines if the TLS 1.1 should be enabled on this zone |
EnableWebpVary | boolean | No | — | Determines if the WebP Vary feature should be enabled. |
EnableWebSockets | boolean | No | — | Determines if WebSocket connections are allowed for this Pull Zone. |
ErrorPageCustomCode | string | No | — | Contains the custom error page code that will be returned |
ErrorPageEnableCustomCode | boolean | No | — | Determines if custom error page code should be enabled. |
ErrorPageEnableStatuspageWidget | boolean | No | — | Determines if the statuspage widget should be displayed on the error pages |
ErrorPageStatuspageCode | string | No | — | The statuspage code that will be used to build the status widget |
ErrorPageWhitelabel | boolean | No | — | Determines if the error pages should be whitelabel or not |
FollowRedirects | boolean | No | — | Determines if the zone should follow redirects return by the oprigin and cache the response |
IgnoreQueryStrings | boolean | No | — | Determines if the Pull Zone should ignore query strings when serving cached objects (Vary by Query String) |
LimitRateAfter | number | No | — | Determines the amount of traffic transferred before the client is limited |
LimitRatePerSecond | integer | No | — | Determines the maximum number of requests per second coming from a single IP before it is blocked. |
LogAnonymizationType | integer | No | — | Sets the log anonymization type for this pull zone |
LogFormat | integer | No | — | 0 = Plain 1 = JSON |
LogForwardingEnabled | boolean | No | — | Sets the log forwarding token for the zone |
LogForwardingFormat | integer | No | — | 0 = Plain 1 = JSON |
LogForwardingHostname | string | No | — | Sets the log forwarding destination hostname for the zone |
LogForwardingPort | integer | No | — | Sets the log forwarding port for the zone |
LogForwardingProtocol | integer | No | — | Sets the log forwarding protocol type |
LogForwardingToken | string | No | — | Sets the log forwarding token for the zone |
LoggingIPAnonymizationEnabled | boolean | No | — | Determines if the log anonoymization should be enabled |
LoggingSaveToStorage | boolean | No | — | Determines if the logging permanent storage should be enabled |
LoggingStorageZoneId | integer | No | — | Sets the Storage Zone id that should contain the logs from this Pull Zone |
MagicContainersAppId | string | No | — | Magic Containers App Id |
MagicContainersEndpointId | string | No | — | Magic Containers Endpoint Id |
MaxWebSocketConnections | integer | No | — | The maximum global simultaneous WebSocket connections allowed for this Pull Zone. Allowed tiers: 500, 1,000, 2,500, 5,000, 10,000, 25,000. If you send a non-tier value, the value is rounded up to the next tier. Values over 25,000 are rejected, please contact sales if required. |
MiddlewareScriptId | integer | No | — | The ID of the middleware script |
MonthlyBandwidthLimit | integer | No | — | Sets the monthly limit of bandwidth in bytes that the pullzone is allowed to use |
OptimizerAutomaticOptimizationEnabled | boolean | No | — | Determines if the automatic image optimization should be enabled |
OptimizerClasses | object[] | No | — | Determines the list of optimizer classes |
OptimizerDesktopMaxWidth | integer | No | — | Determines the maximum automatic image size for desktop clients |
OptimizerEnabled | boolean | No | — | Determines if the optimizer should be enabled for this zone |
OptimizerEnableManipulationEngine | boolean | No | — | Determines the image manipulation should be enabled |
OptimizerEnableUpscaling | boolean | No | — | Determines if Optimizer should automatically upscale images |
OptimizerEnableWebP | boolean | No | — | Determines if the WebP optimization should be enabled |
OptimizerForceClasses | boolean | No | — | Determines if the optimizer classes should be forced |
OptimizerImageQuality | integer | No | — | Determines the image quality for desktop clients |
OptimizerMinifyCSS | boolean | No | — | Determines if the CSS minifcation should be enabled |
OptimizerMinifyJavaScript | boolean | No | — | Determines if the JavaScript minifcation should be enabled |
OptimizerMobileImageQuality | integer | No | — | Determines the image quality for mobile clients |
OptimizerMobileMaxWidth | integer | No | — | Determines the maximum automatic image size for mobile clients |
OptimizerPrerenderHtml | boolean | No | — | Determines if the SEO HTML prerender should be enabled |
OptimizerStaticHtmlEnabled | boolean | No | — | Determines whether optimizer static html feature enabled |
OptimizerStaticHtmlWordPressBypassCookie | string | No | — | Wordpress cookie which should be bypassed by permacache in edge rule |
OptimizerStaticHtmlWordPressPath | string | No | — | Wordpress html path which should be bypassed by permacache in edge rule |
OptimizerTunnelEnabled | boolean | No | — | Determines if the optimizer origin tunnel system should be enabled for this zone |
OptimizerWatermarkEnabled | boolean | No | — | Determines if image watermarking should be enabled |
OptimizerWatermarkMinImageSize | integer | No | — | Sets the minimum image size to which the watermark will be added |
OptimizerWatermarkOffset | number | No | — | Sets the offset of the watermark image |
OptimizerWatermarkPosition | integer | No | — | Sets the position of the watermark image |
OptimizerWatermarkUrl | string | No | — | Sets the URL of the watermark image |
OriginConnectTimeout | integer | No | — | The amount of seconds to wait when connecting to the origin. Otherwise the request will fail or retry. |
OriginHostHeader | string | No | — | Sets the host header that will be sent to the origin |
OriginResponseTimeout | integer | No | — | The amount of seconds to wait when waiting for the origin reply. Otherwise the request will fail or retry. |
OriginRetries | integer | No | — | The number of retries to the origin server |
OriginRetry5XXResponses | boolean | No | — | Determines if we should retry the request in case of a 5XX response. |
OriginRetryConnectionTimeout | boolean | No | — | Determines if we should retry the request in case of a connection timeout. |
OriginRetryDelay | integer | No | — | Determines the amount of time that the CDN should wait before retrying an origin request. |
OriginRetryResponseTimeout | boolean | No | — | Determines if we should retry the request in case of a response timeout. |
OriginShieldEnableConcurrencyLimit | boolean | No | — | Determines if the origin shield concurrency limit is enabled. |
OriginShieldMaxConcurrentRequests | integer | No | — | Determines the number of maximum concurrent requests allowed to the origin. |
OriginShieldMaxQueuedRequests | integer | No | — | Determines the max number of origin requests that will remain in the queue |
OriginShieldQueueMaxWaitTime | integer | No | — | Determines the max queue wait time |
OriginShieldZoneCode | string | No | — | Determines the zone code where the origin shield should be set up |
OriginType | integer | No | — | Determine the type of the origin for this Pull Zone |
OriginUrl | string | No | — | Sets the origin URL of the Pull Zone |
PermaCacheStorageZoneId | integer | No | — | The ID of the storage zone that should be used as the Perma-Cache |
PermaCacheType | integer | No | — | Determines Perma-Cache behavior |
PreloadingScreenCode | string | No | — | The custom preloading screen coed |
PreloadingScreenCodeEnabled | boolean | No | — | Determines if the custom preloader screen should be enabled |
PreloadingScreenDelay | integer | No | — | The delay in miliseconds after which the preloading screen will be displayed (0 - 10000ms) |
PreloadingScreenEnabled | boolean | No | — | Determines if the preloading screen is currently enabled |
PreloadingScreenLogoUrl | string | No | — | The preloading screen logo URL |
PreloadingScreenShowOnFirstVisit | boolean | No | — | Determines if the preloading screen is shown on the first load from a user. |
PreloadingScreenTheme | integer | No | — | The currently configured preloading screem theme. (0 - Light, 1 - Dark) |
QueryStringVaryParameters | string[] | No | — | Contains the list of vary parameters that will be used for vary cache by query string. Only alphanumeric characters, dashes and underscores are allowed (values that contain other characters are ignorred). If empty, all parameters will be used to construct the key. |
RequestCoalescingTimeout | integer | No | — | Determines the lock time for coalesced requests. |
RequestLimit | integer | No | — | Determines the maximum number of requests per second that will be allowed to connect to this Pull Zone |
RoutingFilters | string[] | No | — | The list of routing filters enabled for this zone |
ShieldDDosProtectionEnabled | boolean | No | — | Shield D Dos Protection Enabled |
ShieldDDosProtectionType | integer | No | — | 0 = DetectOnly 1 = ActiveStandard 2 = ActiveAggressive |
StickySessionClientHeaders | string | No | — | A set of comma-separated header names used to identify clients |
StickySessionCookieName | string | No | — | Sticky Session Cookie Name |
StickySessionType | integer | No | — | Whether to use a Sticky Session mechanism for this pull zone |
StorageZoneId | integer | No | — | The ID of the storage zone that will be used as the origin |
Type | integer | No | — | The type of the pull zone. Premium = 0, Volume = 1 |
UseBackgroundUpdate | boolean | No | — | Determines if cache update is performed in the background. |
UseStaleWhileOffline | boolean | No | — | Determines if we should use stale cache while the origin is offline |
UseStaleWhileUpdating | boolean | No | — | Determines if we should use stale cache while cache is updating |
VerifyOriginSSL | boolean | No | — | Determines if the SSL certificate should be verified when connecting to the origin |
ZoneSecurityEnabled | boolean | No | — | Determines if the zone token authentication security should be enabled |
ZoneSecurityIncludeHashRemoteIP | boolean | No | — | Determines if the token authentication IP validation should be enabled |
bunnycdn_cdn_purge_public_index_post
Purge URL Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | Yes | — | The URL that will be purged from cache. |
async | boolean | No | — | (Optional) Determines if the call should wait for the purge logic to complete |
exactPath | boolean | No | — | (Optional) When true and the URL ends with ’/’, purges only the exact path without adding a wildcard suffix. Only applies when the pull zone has IgnoreQueryStrings disabled. |
bunnycdn_cdn_region_public_index
Region listbunnycdn_cdn_reset_security_key_endpoint_reset_security_key
Reset Token Key Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | The ID of the requested Pull Zone |
SecurityKey | string | No | — | Security Key |

