large_​file_​optimization_​advanced

Version: v2025-01-13Includes use: Yes

Behavior name: Large File Optimization (Advanced)

The Large File Optimization feature improves performance and reliability when delivering large files. You need this behavior for objects larger than 1.8GB, and it's recommended for anything over 100MB. You should apply it only to the specific content to be optimized, such as a download directory's .gz files. Note that it is best to use NetStorage for objects larger than 1.8GB.

This advanced behavior provides additional HTTP/2 options not present in the large_file_optimization behavior.

Default behavior

These samples reflect the behavior's default settings. You can use these as is in your configurations or make adjustments based on the behavior's available options.

data "akamai_property_rules_builder" "large_file_optimization_advanced" {
  rules_v2025_02_18 {
    name     = "Large File Optimization (Advanced)"
    comments = "Improves performance and reliability when delivering large files."
    behavior {
      large_file_optimization_advanced {
        enabled = true
        fragment_size = "TWO_MB"
        prefetch_after_request = 2
        object_size = "100MB"
        prefetch_during_request = 0
      }
    }
  }
}
"behaviors": [
  {
  "name": "largeFileOptimizationAdvanced",
  "options": {
    "enabled": true,
    "objectSize": "100MB",
    "fragmentSize": "TWO_MB",
    "prefetchDuringRequest": 0,
    "prefetchAfterRequest": 2
    }
  }
]

Options

Option Description
enabled
Enables the file optimization behavior.
object_size
Specifies the size of the file at which point to apply partial object (POC) caching. Append a numeric value with a MB or GB suffix.
fragment_size
Specifies the size of each fragment used for partial object caching. Value is one of:
  • FOUR_MB
  • HALF_MB
  • ONE_MB
  • TWO_MB
prefetch_during_request
The number of POC fragments to prefetch during the request.
prefetch_after_request
The number of POC fragments to prefetch after the request.