| Table of Contents |
|---|
This section provides general information about the SCSP READ method that applies to both named and unnamed objects.
...
Swarm makes no assumptions about User-Agent (except that it is an HTTP/1.1 client). The Host header is mandatory and must conform to the requirements of Section 14.23 in the HTTP/1.1 specification.
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...
Erasure coding objects on disk lets you store allows storing large objects in the cluster with a smaller storage footprint, compared to earlier versions of Swarm.
...
READ is affected by the checkIntegrity=yes query argument that is used to verify that all segments are found before executing the READ.
...
This information is also available on the Node Status page that appears when you navigate navigating to a node's IP address with the designated SCSP port (for example, http://192.168.99.100:80 ).
...
In some cases, an application might be interested in only a byte portion of a larger object stored in Swarm. Rather than read the entire object and filter out the interesting parts, the application can include one or more Range headers with an SCSP READ request. A READ request can include more than one Range header.
...
Below are some examples and their interpretations:
| Range | Returns |
|---|---|
0-499 | First 500 bytes of the object |
500-999 | The second 500 bytes |
-500 | Last 500 bytes |
0-499, 500-999 | First 1000 bytes |
| Info | ||
|---|---|---|
| ||
| Range headers are not compatible with either integrity seals or the ContentMD5 header because both require a hash of the object's entire contents. If the Range The connection is closed as if the integrity seal or the Content-MD5 was invalid if the range is not set to a value greater than or equal to the size of the object, the connection is closed as if the integrity seal or the Content-MD5 was invalid. |
READ requests that include invalid Range headers (for example, ranges that do not exist in the object) cause Swarm to respond with a 416 (Range not satisfiable) error. A successful response to a READ that includes one or more Range headers is 206 (Partial content). Of course, only data Data in the requested ranges are included in the 206 response.
...
| Info | ||
|---|---|---|
| ||
| Entering a range with the range in reverse order (where the end of the range is entered first) will return returns the entire object. For example, Range: 999-500 returns all of the content in the object. The range header is essentially ignored. |
| Child pages (Children Display) |
|---|