GuideReference
TrainingSupportCommunity

large_​file_​optimization


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, and enable the use_​versioning option while enforcing your own filename versioning policy. Note that it is best to use Net​Storage 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.

OptionTypeDescriptionRequires
enabledboolean

Enables the file optimization behavior.

{"displayType":"boolean","tag":"input","type":"checkbox"}
enable_​partial_​object_​cachingenum

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 Net​Storage. 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_​sizestring

Optimization only applies to files larger than this, expressed as a number suffixed with a unit string such as MB or GB.

enable_​partial_​object_​caching is PARTIAL_​OBJECT_​CACHING
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"enablePartialObjectCaching","op":"eq","value":"PARTIAL_OBJECT_CACHING"}}
maximum_​sizestring

Optimization does not apply to files larger than this, expressed as a number suffixed with a unit string such as MB or GB. The size of a file can't be greater than 323 GB. If you need to optimize a larger file, contact Akamai Professional Services for help.

enable_​partial_​object_​caching is PARTIAL_​OBJECT_​CACHING
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"enablePartialObjectCaching","op":"eq","value":"PARTIAL_OBJECT_CACHING"}}
use_​versioningboolean

When enable_​partial_​object_​caching is set to PARTIAL_​OBJECT_​CACHING, enabling this option signals your intention to vary filenames by version, strongly recommended to avoid serving corrupt content when chunks come from different versions of the same file.

enable_​partial_​object_​caching is PARTIAL_​OBJECT_​CACHING
{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enablePartialObjectCaching","op":"eq","value":"PARTIAL_OBJECT_CACHING"}}