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.