range Property
The range of bytes to request.
Syntax
def get_range() -> str: ... def set_range(value: str) -> None: ...
range = property(get_range, set_range)
Default Value
""
Remarks
This property specifies the range of bytes to request from the server. If this property is non-empty when a get_object request is being constructed, a header like Range: bytes=Range will be added to the request, with Range substituted with the specified value.
There are two valid formats for this property's value:
- StartByte-
- StartByte-EndByte
Note: If the start_byte property is greater than zero when get_object is called (i.e., when a download is being resumed), and this property is non-empty, the class will automatically advance the StartByte value in the specified range by start_byte bytes when sending the Range header to the server. This ensures that the previously-downloaded data at the start of the specified range is not downloaded again when the download is resumed.