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