The content can be returned directly to the node that sent the request or redirected to another node in the cluster.

See SCSP Headers for a list of response headers.

The storage cluster can return the following responses for the requested content:

READ Response for Domain

Example response to a READ or INFO request for an object in a domain.

The initial HTTP 401 Unauthorized response is a normal part of HTTP authentication for a domain. Because access to a domain requires domain manager credentials, you always see an initial HTTP 401 Unauthorized response for an INFO request in a domain.

HTTP/1.1 401 Unauthorized  
  WWW-Authenticate: Digest  
  realm="cluster.example.com/_administrators", 
  nonce="05d0a60ee1f44361f449496505e05116", 
  opaque="784d8bc3fe3a48a5105b4f8ddd8ae0e7",  
  stale=false, qop="auth", algorithm=MD5  
  WWW-Authenticate: Basic  
  realm="cluster.example.com/_administrators" 
  Content-Length: 51 
  Content-Type: text/html 
  Date: Sat, 16 Oct 2012 00:41:23 GMT 
  Server: CAStor Cluster 5.0.0  
  Allow: HEAD, GET, PUT, POST, COPY, APPEND, DELETE
HTTP/1.1 200 OK  
  Castor-Authorization: cluster.example.com/_administrators, POST= 
  Castor-System-Alias: ec87e3c7c410cc04fc4c838061898d9c 
  Castor-System-CID: ffffffffffffffffffffffffffffffff 
  Castor-System-Cluster: cluster.example.com  
  Castor-System-Created: Fri, 15 Oct 2012 23:59:40 GMT 
  Castor-System-Name: cluster.example.com 
  Castor-System-Owner: admin@CAStor administrator  
  Castor-System-Version: 1287187180.959 
  Content-Length: 0  
  Last-Modified: Fri, 15 Oct 2012 18:35:56  
  GMT lifepoint: [] reps=16  
  Etag: "da8bfbb04d089b9c22ae77747f327233" 
  Date: Sat, 16 Oct 2012 00:41:23 GMT 
  Server: CAStor Cluster/5.0.0

READ Response for Bucket

Example response to a READ request for a bucket:

HTTP/1.1 200 OK 
  Castor-System-Alias: d36dfca69ba7752f4708b1fa9bf9918b 
  Castor-System-CID: ec87e3c7c410cc04fc4c838061898d9c 
  Castor-System-Cluster: cluster.example.com  
  Castor-System-Created: Fri, 15 Oct 2012 18:36:05 GMT  
  Castor-System-Name: bucket 
  Age: 62 
  Castor-System-Version: 1287167765.255 
  Content-Length: 0 
  Content-Type: application/x-www-form-urlencoded 
  Last-Modified: Fri, 15 Oct 2012 18:36:05 GMT 
  Etag: "21641b39f4fdc1e86dc67e798a320980" 
  Date: Fri, 15 Oct 2012 19:00:46 GMT 
  Server: CAStor Cluster 5.0.0

READ Response for Named Object

Example response to a READ request for a named object:

HTTP/1.1 200 OK 
  Castor-System-CID: d36dfca69ba7752f4708b1fa9bf9918b 
  Castor-System-Cluster: cluster.example.com  
  Castor-System-Created: Fri, 15 Oct 2012 18:37:08 GMT 
  Castor-System-Name: file.txt  
  Castor-System-Version: 1287167828.514 
  Content-Length: 11 
  Content-Type: application/x-www-form-urlencoded 
  Last-Modified: Fri, 15 Oct 2012 18:37:08 GMT 
  Etag: "a896b8e88fe7fc15c9b8f9b2d19e311d" 
  Date: Fri, 15 Oct 2012 18:45:12 GMT 
  Server: CAStor Cluster/5.0.0

READ Response for Unnamed Objects

Example response to a READ request for an unnamed object.

This response means the node receiving the request is returning the requested content in the message body of the response.

READ Response for Range Headers

When a READ request includes one or more range headers, a successful Swarm response includes only the requested bytes range(s). In this case, instead of returning an HTTP 200 OK response, Swarm returns an HTTP 206 Partial Content response, indicating that only part of the content is being returned. The application-meta-information and content-stream are the same.

READ Response for Moved Permanently

The following response shows that the requested object was located, but another node in the cluster supplies the content. Additionally, all future requests of this storage cluster should be made through the new access node until another HTTP 301 response is received.

There is no message-body, so the content length is always 0. The value of the Location header indicates which node in the cluster receives the redirect.

The client is expected to send another READ request using the exact URI in the Location header.

READ Response for Moved Temporarily

The following response is similar to the HTTP 301 response, except the client should continue to use the current node (the one generating this response) for future requests until further notice.

Swarm Documentation

Normal Responses to READ