large_file_optimization

Property Manager name: Large File Optimization
Behavior version: The v2023-01-05 rule format supports the large_file_optimization behavior v1.2.
Rule format status: GA, stable
Access: Read/Write
Allowed in includes: Yes

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 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. To enable this, the origin needs to support byte range requests.
	`NON_PARTIAL_OBJECT_CACHING`	Caches entire objects.
`minimum_size`	string	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_size`	string	Optimization does not apply 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"}}
`use_versioning`	boolean	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"}}