largeFileOptimization


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"}}