large_file_optimization
- Property Manager name: Large File Optimization
- Behavior version: The
v2024-05-31
rule format supports thelarge_file_optimization
behavior v1.2. - Rule format status: GA, stable
- Access: Read/Write
- Allowed in includes: Yes
The Large File Optimization (LFO) feature improves performance and reliability when delivering large files. You need this behavior for objects larger than 1.8GB, and you should apply it to anything over 100MB. You should apply it only to the specific content to be optimized, such as a download directory's .gz
files, and enable the use_versioning
option while enforcing your own filename versioning policy. Make sure you meet all the requirements and best practices for the LFO delivery.
Note that it is best to use NetStorage for objects larger than 1.8GB.
See also the large_file_optimization_advanced
behavior, which provides additional options for to configure partial object caching and HTTP/2 prefetching.
Option | Type | Description | Requires | |
---|---|---|---|---|
enabled | boolean | Enables the file optimization behavior. | {"displayType":"boolean","tag":"input","type":"checkbox"} | |
enable_partial_object_caching | enum | Specifies whether to cache partial objects. | {"displayType":"enum","options":["PARTIAL_OBJECT_CACHING","NON_PARTIAL_OBJECT_CACHING"],"tag":"select"} {"if":{"attribute":"enabled","op":"eq","value":true}} | |
PARTIAL_OBJECT_CACHING | Allows partial-object caching, which always applies to large objects served from NetStorage. The size of the object to be cached can't be greater than 323 GB. To enable this, the origin needs to support byte range requests. | |||
NON_PARTIAL_OBJECT_CACHING | Caches entire objects. The size of the object to be cached can't be greater than 1800 MB. | |||
minimum_size | string | Optimization only applies to files larger than this, expressed as a number suffixed with a unit string such as | enable_partial_object_caching is PARTIAL_OBJECT_CACHING | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"enablePartialObjectCaching","op":"eq","value":"PARTIAL_OBJECT_CACHING"}} |
maximum_size | string | Optimization does not apply to files larger than this, expressed as a number suffixed with a unit string such as | enable_partial_object_caching is PARTIAL_OBJECT_CACHING | {"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"enablePartialObjectCaching","op":"eq","value":"PARTIAL_OBJECT_CACHING"}} |
use_versioning | boolean | When | enable_partial_object_caching is PARTIAL_OBJECT_CACHING | {"displayType":"boolean","tag":"input","type":"checkbox"} {"if":{"attribute":"enablePartialObjectCaching","op":"eq","value":"PARTIAL_OBJECT_CACHING"}} |
Updated 5 days ago