Link Search Menu Expand Document Documentation Menu

You're viewing version 2.13 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Supported units

Introduced 1.0

OpenSearch supports the following units for all REST operations:

Unit Description Example
Times The supported units for time are d for days, h for hours, m for minutes, s for seconds, ms for milliseconds, micros for microseconds, and nanos for nanoseconds. 5d or 7h
Bytes The supported units for byte size are b for bytes, kb for kibibytes, mb for mebibytes, gb for gibibytes, tb for tebibytes, and pb for pebibytes. Despite the base-10 abbreviations, these units are base-2; 1kb is 1,024 bytes, 1mb is 1,048,576 bytes, etc. 7kb or 6gb
Distances The supported units for distance are mi for miles, yd for yards, ft for feet, in for inches, km for kilometers, m for meters, cm for centimeters, mm for millimeters, and nmi or NM for nautical miles. 5mi or 4ft
Quantities without units For large values that don’t have a unit, use k for kilo, m for mega, g for giga, t for tera, and p for peta. 5k for 5,000

To convert output units to human-readable values, see Common REST parameters.

350 characters left

Have a question? .

Want to contribute? or .