Hello world

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Named (requires a previously created domain and bucket- see later in the doc for examples):","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary '

Hello world

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SCSP APPEND","type":"text"}]},{"type":"paragraph","content":[{"text":"Unnamed mutable:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X APPEND --data-binary 'text' --location-trusted 'http://node-ip-address/UUID-to-APPEND?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Named:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X APPEND --data-binary 'text' --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SCSP COPY","type":"text"}]},{"type":"paragraph","content":[{"text":"Unnamed mutable:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X COPY -H 'x-custom-meta-data-header:metadata-value' --location-trusted 'http://node-ip-address/UUID-to-COPY?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Named:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X COPY -H 'x-custom-meta-data-header:metadata-value' --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SCSP UPDATE","type":"text"}]},{"type":"paragraph","content":[{"text":"Unnamed mutable:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT --data-binary '

Goodbye

' -H 'Content-type: text/html' -H 'x-custom-meta-data-header:metadata-value' --location-trusted 'http://node-ip-address/UUID-to-UPDATE?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Named:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT --data-binary '

Goodbye

' -H 'Content-type: text/html' -H 'x-custom-meta-data-header:metadata-value' --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name'","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SCSP READ","type":"text"}]},{"type":"paragraph","content":[{"text":"Unnamed mutable:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 --location-trusted 'http://node-ip-address/UUID-to-READ?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Named:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SCSP INFO","type":"text"}]},{"type":"paragraph","content":[{"text":"Unnamed mutable:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v -I --post301 --location-trusted 'http://node-ip-address/UUID-to-INFO?alias'","type":"text"}]},{"type":"paragraph","content":[{"text":"Named:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v -I --post301 --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"SCSP DELETE","type":"text"}]},{"type":"paragraph","content":[{"text":"Unnamed mutable:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X DELETE --location-trusted 'http://node-ip-address/UUID-to-UPDATE?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Named:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X DELETE --location-trusted 'http://node-ip-address/bucket-name/object-name?domain=domain-name'","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Working With Unnamed Objects","type":"text"}]},{"type":"paragraph","content":[{"text":"This section provides examples of using cURL to work with unnamed objects. The term ","type":"text"},{"text":"unnamed object includes both immutable objects and mutable objects (which are also referred to as anchor streams).","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"An immutable object can be created, but can’t be changed. It can be be deleted. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"You can execute all SCSP methods on a mutable object: WRITE, UPDATE, COPY, APPEND, READ, INFO, and DELETE. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Assumption: You use the default port 80 for SCSP. If you use a different port, you must include it in the URL. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Write a New Immutable Object","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a string:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 –X POST --data-binary '

Hello world

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/' ","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary @Hello_World.html -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For the preceding command to work, Hello_World.html must be in a location accessible by cURL and it must have HTML contents, such as ","type":"text"},{"text":"

Hello World

","type":"text","marks":[{"type":"code"}]},{"text":". (Include the path to the file if necessary as ","type":"text"},{"text":"@path-to-file/Hello_World.html","type":"text","marks":[{"type":"code"}]},{"text":".)","type":"text"}]},{"type":"paragraph","content":[{"text":"To view the object (that is, execute the READ method), paste the URL displayed in the Location response into a web browser’s address or location field.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"INFO an Unnamed Immutable Object","type":"text"}]},{"type":"paragraph","content":[{"text":"An INFO differs from a READ in that only the metadata stored with the object is returned. The object’s contents are not returned if you INFO the object.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --post301 --location-trusted 'http://value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --post301 --location-trusted 'http://172.16.0.32:80/3c0723bd9f555df9645c266227ee5fa2' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample response:","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Sat, 19 Mar 2015 19:18:42 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 33","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-type: text/html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Sat, 19 Mar 2015 19:18:42 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"3c0723bd9f555df9645c266227ee5fa2\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Sat, 19 Mar 2015 19:22:41 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DELETE an Unnamed Immutable Object","type":"text"}]},{"type":"paragraph","content":[{"text":"To delete an unnamed immutable object, you must know the value of the object’s Location header.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v -X DELETE --post301 --location-trusted 'http://value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v -X DELETE --post301 --location-trusted 'http://172.16.0.32:80/3c0723bd9f555df9645c266227ee5fa2'","type":"text"}]},{"type":"paragraph","content":[{"text":"If you now try to READ or INFO the object, Swarm responds with 404 (Not Found) or with a Swarm Error.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Working With An Unnamed Mutable Object","type":"text"}]},{"type":"paragraph","content":[{"text":"An unnamed mutable object is one that can be changed using UPDATE, APPEND, COPY, or DELETE. You can also READ and INFO the object. This example shows how to create a new mutable object, how to modify it using UPDATE, add data to it using APPEND, COPY metadata, then READ and INFO the object before you DELETE it.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"?alias","type":"text","marks":[{"type":"code"}]},{"text":" (optionally ","type":"text"},{"text":"?alias=yes","type":"text","marks":[{"type":"code"}]},{"text":") query argument is only required on POST when creating a mutable unnamed object in Swarm >= 7.x. It will not be shown in subsequent examples where unnecessary as the examples are created in post 7.x Swarm code.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create the object using POST","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a string:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary '

Hello world

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary @Hello_World.html -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For the preceding command to work, Hello_World.html must be in a location accessible by cURL and it must have HTML contents, such as

Hello World

. (Include the path to the file if necessary as @path-to-file/Hello_World.html.)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"READ the Object","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the object was created successfully by pasting the value of the Location header in a browser.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add data to the object using APPEND","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X APPEND --data-binary '
...more data' --location-trusted 'value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X APPEND --data-binary '
...more data' --location-trusted 'http://172.16.0.32:80/10eb3d3fba8ddd6f60dfbf89e4aed3e4' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Refresh your web browser to see how the object changed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: Although this example shows how to append data to an object, APPEND can also be used to append metadata to the object as well. ","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add custom metadata to the object using COPY","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm enables you to add custom metadata in the format ","type":"text"},{"text":"x-*-meta-*","type":"text","marks":[{"type":"code"}]},{"text":". Custom metadata added in this way is case-insensitive (to be consistent with ","type":"text"},{"text":"section 4.2 of RFC 2616","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec4.html#sec4.2"}}]},{"text":") and can contain ASCII characters only. The total length of all persisted metadata, keys and values, is limited to 32KB.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can add metadata headers to an object using the UPDATE method (which replaces the object's data and metadata) or using COPY (which replaces the metadata only).","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X COPY -H 'x-custom-meta-data-header:metadata-value' --location-trusted 'value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X COPY -H 'x-ExampleCorp-meta-color: blue' --location-trusted 'http://172.16.0.32:80/90eee0a3170bf8fca313532e70b37eec' ","type":"text"}]},{"type":"paragraph","content":[{"text":"INFO the object to verify the header:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --location-trusted 'http://172.16.0.32:80/90eee0a3170bf8fca313532e70b37eec' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A sample response follows (the custom metadata header is displayed in italicized type for emphasis):","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Alias: 90eee0a3170bf8fca313532e70b37eec","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Sat, 19 Mar 2015 21:47:05 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Sat, 19 Mar 2015 21:47:05 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"x-ExampleCorp-meta-color: blue","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"b4fb59c0f49e5be9ba09c8996784c73a\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Sat, 19 Mar 2015 21:47:08 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Note: If you send a ","type":"text"},{"text":"Content-Length","type":"text","marks":[{"type":"code"}]},{"text":" header, you must set it to 0 because a COPY has no data.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Replace data and metadata using UPDATE","type":"text"}]},{"type":"paragraph","content":[{"text":"UPDATE is very similar to COPY except that UPDATE also replaces the object's contents as well as its metadata.","type":"text"}]},{"type":"paragraph","content":[{"text":"Try UPDATE on the preceding example as follows:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT --data-binary '

Goodbye

' -H 'Content-type: text/html' -H 'x-ExampleCorp-meta-color: orange' --location-trusted 'http://node-ip-address/value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT --data-binary '

Goodbye

' -H 'Content-type: text/html' -H 'x-ExampleCorp-meta-color: orange' --location-trusted 'http://172.16.0.32:80/90eee0a3170bf8fca313532e70b37eec' ","type":"text"}]},{"type":"paragraph","content":[{"text":"INFO the object to verify the header:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --location-trusted 'http://172.16.0.32:80/90eee0a3170bf8fca313532e70b37eec' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A sample follows:","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Alias: 90eee0a3170bf8fca313532e70b37eec","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Sat, 19 Mar 2015 22:11:33 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Sat, 19 Mar 2015 22:11:33 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"x-ExampleCorp-meta-color: orange","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"a6d10b1786ddfc40e9f06e5e385295a0\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Sat, 19 Mar 2015 22:11:38 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Refresh your browser window to see the change in the object's contents.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"DELETE the mutable object","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X DELETE --location-trusted 'value-of-Location-header?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Paste the value of the Location header in a web browser, or INFO the object, to verify you get a 404 (Not Found) or a Swarm Error.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Beyond the Basics With Unnamed Objects","type":"text"}]},{"type":"paragraph","content":[{"text":"This section discusses more advanced actions, such as using cURL for performance, immediate replication (also referred to as replicate-on-write, lifepoint headers, and range reads).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Performance tip","type":"text"}]},{"type":"paragraph","content":[{"text":"cURL's output to the command prompt can drastically skew or slow response times. If you use cURL for performance reasons, use ","type":"text"},{"text":"-s","type":"text","marks":[{"type":"code"}]},{"text":" (silent) and ","type":"text"},{"text":"-o /dev/null","type":"text","marks":[{"type":"code"}]},{"text":" (output). For example,","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -s --post301 –X POST --data-binary '

Outperform me

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/?alias' –o /dev/null ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Immediate replication (replicate-on-write)","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a mutable unnamed object and replicate it immediately:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 –X POST --data-binary '

Replicate me

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/?alias&replicate=immediate' ","type":"text"}]},{"type":"paragraph","content":[{"text":"INFO the object to get its replica count:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --location-trusted 'value-of-Location-header?countreps=yes' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --location-trusted 'http://172.16.0.32/cd0e8d605372a4d21b660000fc807c1b?countreps=yes' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample response (the ","type":"text"},{"text":"Replica-Count","type":"text","marks":[{"type":"code"}]},{"text":" header is displayed in italicized text for emphasis):","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Alias: cd0e8d605372a4d21b660000fc807c1b","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Thu, 17 Mar 2015 21:45:47 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-type: text/html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Thu, 17 Mar 2015 21:45:47 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"lifepoint: [Fri, 18 March 2015 10:15:00 GMT] reps=2, deletable=True, [] delete","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Replica-Count: 2","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"7a1f8719a80df7065d1b5ce4ef30403b\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Thu, 17 Mar 2015 22:01:20 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Range READ","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --location-trusted 'value-of-Location-header' -r range-in-bytes ","type":"text"}]},{"type":"paragraph","content":[{"text":"For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --location-trusted 'http://172.16.0.32/ad20eb6cbb3e38de3b13613c334012f5?alias' -r 100-500 ","type":"text"}]},{"type":"paragraph","content":[{"text":"The response depends on the type of file you are reading. For example, following is a partial response if you request bytes 399-600 from the Henry Ford biography from Wikipedia (assuming you had previously stored it in your cluster):","type":"text"}]},{"type":"paragraph","content":[{"text":"* About to connect() to 172.16.0.32 port 80 (#0)","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"* Trying 172.16.0.32... connected","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"* Connected to 172.16.0.32 (172.16.0.32) port 80 (#0)","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"> READ /44bc48cd3e040c7fc5d76c606eafff46?alias HTTP/1.1","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"> Range: bytes=399-600","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"..[this portion intentionally omitted]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":">","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< HTTP/1.1 206 Partial Content","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"HTTP/1.1 206 Partial Content","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< Castor-System-Alias: 44bc48cd3e040c7fc5d76c606eafff46","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Alias: 44bc48cd3e040c7fc5d76c606eafff46","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"..[this portion intentionally omitted]","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"< Content-Range: bytes 399-600/219136","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Range: bytes 399-600/219136","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< Content-Length: 202","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 202","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< Etag: \"25d456df70ba3813d5490bceaa71cb79\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"25d456df70ba3813d5490bceaa71cb79\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< Age: 97","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Age: 97","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< Date: Thu, 17 Mar 2015 23:11:09 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Thu, 17 Mar 2015 23:11:09 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"< Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"<","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Henry Ford - Wikipedia, the free encyclopedia","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"* Connection #0 to host 172.16.0.32 left intact","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"* Closing connection #0","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"WRITE a New Mutable Object With a Lifepoint Header","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 –X POST --data-binary '

Lifepoint example

' -H 'Content-type: text/html' -H 'lifepoint: [http-date] reps=2, deletable=True, [] delete' --location-trusted 'http://node-ip-address/?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"http-date","type":"text","marks":[{"type":"code"}]},{"text":" to an","type":"text"},{"text":" HTTP 1.1 specification-formatted ","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.3"}}]},{"text":"date that is at least an hour from now. An example follows:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary '

Hello world

' -H 'Content-type: text/html' -H 'lifepoint: [Friday, 18 March 2015 10:15:00 GMT] reps=2, deletable=True, [] delete' --location-trusted 'http://172.16.0.32/?alias' ","type":"text"}]},{"type":"paragraph","content":[{"text":"The preceding command creates an object that initially has two replicas, both of which are deleted at ","type":"text"},{"text":"http-date","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To verify the lifepoint headers, INFO the object using the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --post301 --location-trusted 'value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A response similar to the following displays to indicate the object was found, and it displays the object’s lifepoint header:","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Thu, 17 Mar 2015 01:18:32 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 33","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-type: text/html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Thu, 17 Mar 2015 01:18:32 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"lifepoint: [Friday, 18 March 2015 10:15:00 GMT] reps=2, deletable=True, [] delete","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"236a921048fa3a4fb31cdda452f2c0a0\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Thu, 17 Mar 2015 01:19:00 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add a lifepoint header to a mutable object using UPDATE","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT -H 'lifepoint: [http-date] reps=2, deletable=True, [] delete' --location-trusted 'value-of-Location-header/' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"http-date","type":"text","marks":[{"type":"code"}]},{"text":" to a ","type":"text"},{"text":"HTTP 1.1 specification-formatted","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.3"}}]},{"text":" date that is at least an hour from now. An example follows:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT -H 'Content-type: text/html' -H 'lifepoint: [Fri, 18 March 2015 10:15:00 GMT] reps=2, deletable=True, [] delete' --location-trusted 'http://172.16.0.32:80/cd0e8d605372a4d21b660000fc807c1b' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the headers on the object using the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -I --post301 --location-trusted 'value-of-Location-header' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A sample follows (the lifepoint header is displayed in italicized type for emphasis):","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Alias: cd0e8d605372a4d21b660000fc807c1b","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Thu, 17 Mar 2015 21:45:47 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-type: text/html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Thu, 17 Mar 2015 21:45:47 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"lifepoint: [Fri, 18 March 2015 10:15:00 GMT] reps=2, deletable=True, [] delete","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"7a1f8719a80df7065d1b5ce4ef30403b\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Thu, 17 Mar 2015 21:47:21 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This response confirms you updated the lifepoint header successfully.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Working With Named Objects","type":"text"}]},{"type":"paragraph","content":[{"text":"This section discusses how to verify you can perform SCSP operations on named objects.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Brief Introduction to Named Objects","type":"text"}]},{"type":"paragraph","content":[{"text":"Before you can create named objects, your cluster administrator must create at least one tenant (that is, domain). DataCore recommends you use the default cluster domain for these examples but that is not required.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default cluster domain is defined as a domain whose name exactly matches the value of the cluster configuration parameter in the node or cluster configuration file. Swarm assumes that the domain is set to the default cluster domain if you omit the ","type":"text"},{"text":"?domain=","type":"text","marks":[{"type":"code"}]},{"text":" query argument from your cURL commands.","type":"text"}]},{"type":"paragraph","content":[{"text":"In other words, if ","type":"text"},{"text":"cluster.example.com","type":"text","marks":[{"type":"code"}]},{"text":" is the default cluster domain, the following cURL commands are equivalent:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --location-trusted 'http://172.16.0.32/mybucket?domain=cluster.example.com' ","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --location-trusted 'http://172.16.0.32/mybucket' ","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information about creating a tenant and a domain, see the Swarm Guide, under Configuration and Administration.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information about named objects, see the Swarm Guide, under Understanding Swarm Objects.","type":"text"}]},{"type":"paragraph","content":[{"text":"Before you continue, you must know all of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The IP address of one node in the cluster.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The name of the domain and whether or not it is the default cluster domain. If the domain is not the default cluster domain, you must add the ?domain=domain-name query argument to every cURL command.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The domain’s protection setting, which defines the users who can WRITE in the domain. This document will not address authentication.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you do not use the default port 80 for SCSP, you must include the port in the URL.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating the Domain","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes how to create the ","type":"text"},{"text":"mycluster.example.com","type":"text","marks":[{"type":"code"}]},{"text":" domain. All tasks discussed in this section require you to authenticate as a user in the Swarm administrators user list. It is preferred to create the domain using the Swarm user interface if possible.","type":"text"}]},{"type":"paragraph","content":[{"text":"To create the domain:","type":"text"}]},{"type":"paragraph","content":[{"text":"1. Create the mycluster.example.com domain:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST -H 'Castor-Stream-Type: admin' -H 'Allow-Encoding: *;q=0' -H 'lifepoint: [] reps=16' --data-binary '' --location-trusted 'http://172.16.0.35?domain=mycluster.example.com&admin&createDomain' --anyauth -u 'admin:ourpwdofchoicehere' [-D log-file-name]","type":"text"}]},{"type":"paragraph","content":[{"text":"Caution — Be sure to enter these headers exactly as shown so that they match the headers used when domains are created by the Console. ","type":"text"},{"text":"lifepoint: [] reps=16","type":"text","marks":[{"type":"code"}]},{"text":" enables the domain to be replicated as many times as possible. Use ","type":"text"},{"text":"Castor-Stream-Type: admin","type":"text","marks":[{"type":"code"}]},{"text":" for all root objects that are accessed frequently and all objects that use a ","type":"text"},{"text":"Castor-Authorization","type":"text","marks":[{"type":"code"}]},{"text":" header.","type":"text"}]},{"type":"paragraph","content":[{"text":"2. Locate the 201 Created response to confirm that the command was successful.","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 401 Unauthorized","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"WWW-Authenticate: Digest realm=\"CAStor administrator\",","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"nonce=\"e9d618c06bbeca15e7568aca2f","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"opaque=\"f9bcffd26d1bede5419a2b30cbcff976\",","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"stale=false, qop=\"auth\", algorithm=MD5","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"WWW-Authenticate: Basic realm=\"CAStor administrator\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 51","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Type: text/html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Fri, 04 Nov 2011 16:22:53 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/6.0.0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Allow: HEAD, GET, PUT, POST, COPY, APPEND, DELETE","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"HTTP/1.1 201 Created","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-UUID: 68aeb6c78e4ca0101f3936c03fa26e72","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Location: http://172.16.0.35:80/?domain=mycluster.example.com","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Volume: 064d2cc2392810dcc2d04f7b1023ecc7","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Last-Modified: Fri, 04 Nov 2011 16:22:53 GMT","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Entity-MD5: ZoxbtOo9PhHyZzAbaqa/Pw==","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Stored-Digest: 668c5bb4ea3d3e11f267301b6aa6bf3f","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Owner: admin@CAStor administrator","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1320","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating the Bucket","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have a domain, you need one or more buckets to write your data streams into. If you do not create a bucket, and you write named streams into your domain, the streams will be assumed to be buckets. For example, if you write a stream called: ","type":"text"},{"text":"http://172.16.0.35/stream1?domain=mycluster.example.com","type":"text","marks":[{"type":"code"}]},{"text":", stream1 will be considered a bucket, not a regular stream. This is not desirable as different replication policies apply to context streams (domains and buckets) than to streams.","type":"text"}]},{"type":"paragraph","content":[{"text":"This section discusses how to WRITE a bucket in a domain that does not require authentication.","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a bucket without authentication","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary '' --location-trusted 'http://node-ip-address/bucket-name[?domain=domain-name]’ ","type":"text"}]},{"type":"paragraph","content":[{"text":"(","type":"text"},{"text":"?domain-name","type":"text","marks":[{"type":"code"}]},{"text":" is not required if you are creating a bucket in the default cluster domain.)","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary '' --location-trusted 'http://172.16.0.35/mybucket?domain=mycluster.example.com'","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Verify the bucket.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --post301 -I --location-trusted 'http://172.16.0.35/mybucket[?domain=mycluster.example.com]' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A sample response follows (the authorization specification is displayed in italicized type for emphasis):","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Alias: 759db90c1b81d695837d54261df90c53","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-CID: 4a89010e358d48c3040778f35282238e","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Cluster: mycluster.example.com","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Mon, 21 Mar 2015 23:29:28 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Name: mybucket","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Type: application/x-www-form-urlencoded","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Mon, 21 Mar 2015 23:29:28 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"f21a6e2e847539049d3f83c508fa0986\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Age: 114","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Mon, 21 Mar 2015 23:32:49 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Named Objects","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"WRITE an object in a bucket","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a string:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary '

Hello world

' -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/bucket-name/technote.html[?domain=domain-name]' ","type":"text"}]},{"type":"paragraph","content":[{"text":"WRITE a file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X POST --data-binary @Hello_world.txt -H 'Content-type: text/html' --location-trusted 'http://node-ip-address/bucket-name/technote.html[?domain=domain-name]' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Verify the object in a web browser","type":"text"}]},{"type":"paragraph","content":[{"text":"Enter the following URL in your web browser’s location or address field:","type":"text"}]},{"type":"paragraph","content":[{"text":"http://node-ip-address/bucket-name/technote.html[?domain=domain-name] ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"For example, if the bucket is named bucket and it is in the default cluster domain, and the node IP address is 172.16.0.32:","type":"text"}]},{"type":"paragraph","content":[{"text":"http://172.16.0.32/bucket/technote.html ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Hello World displays in bold text.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add data to the object using APPEND","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X APPEND --data-binary '
...more data' --location-trusted 'http://node-ip-address/bucket-name/technote.html[?domain=domain-name]' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the append succeeded by refreshing your web browser window.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Add custom metadata using COPY","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -i -v --post301 -X COPY -H 'x-NamedObject-meta-data: NameOne' --location-trusted 'http:// node-ip-address/bucket-name /technote.html[?domain=domain-name]' ","type":"text"}]},{"type":"paragraph","content":[{"text":"INFO the object to verify the metadata.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --post301 -I --location-trusted 'http://172.16.0.32/bucket/technote.html' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A sample response follows:","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-CID: 74888c3f62ebd05e53bf442eb6a7d98c","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Cluster: mycluster.example.com","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Sat, 19 Mar 2015 22:58:48 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Name: technote.html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Sat, 19 Mar 2015 22:58:48 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"x-NamedObject-meta-data: NameOne","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"258de599945736b9bb26247ac8229e5f\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Sat, 19 Mar 2015 22:59:13 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Replace data and metadata using PUT","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X PUT --data-binary '

Goodbye

' -H 'Content-type: text/html' -H 'x-NamedObject-meta-data: NameTwo' --location-trusted 'http://node-ip-address/bucket-name/technote.html[?domain=domain-name]' ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"INFO the object to verify the metadata.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --post301 -I --location-trusted 'http://172.16.0.32/bucket/technote.html' ","type":"text"}]},{"type":"paragraph","content":[{"text":"A sample response follows:","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-CID: 74888c3f62ebd05e53bf442eb6a7d98c","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Cluster: mycluster.example.com","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Created: Sat, 19 Mar 2015 23:14:16 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Name: technote.html","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Castor-System-Version: 1438101372.519","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Content-Length: 0","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Last-Modified: Sat, 19 Mar 2015 23:14:16 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"x-NamedObject-meta-data: NameTwo","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Etag: \"f03a429994243f27013b4f1fceb31fff\"","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Date: Sat, 19 Mar 2015 23:14:34 GMT","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Server: CAStor Cluster/7.5.1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Refresh your browser window to see the object's data.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Delete the named object","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v --post301 -X DELETE --location-trusted 'http://node-ip-address/bucket-name/technote.html' ","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the delete succeeded by refreshing your web browser window or using an INFO. You should get a 404 (Not Found) or a Swarm Error.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"HTTP and SCSP Methods","type":"text"}]},{"type":"paragraph","content":[{"text":"Swarm clients use the Simple Content Storage Protocol (SCSP) to communicate with Swarm. SCSP is a subset of HTTP 1.1 as defined in ","type":"text"},{"text":"RFC 2616","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.ietf.org/rfc/rfc2616.txt"}}]},{"text":". Some SCSP methods have different names than their HTTP counterparts.","type":"text"}]},{"type":"paragraph","content":[{"text":"When you execute methods using cURL, you must use HTTP method names; however, this Tech Note uses SCSP method names except when showing cURL command examples.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following tables map SCSP method names to their HTTP method counterparts. A link is provided in the HTTP method column to the relevant section in RFC 2616. For more information about SCSP methods, see the Swarm Guide.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"a265f531-e0d7-40c9-b298-2f8880f1d835"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"SCSP method","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"HTTP method","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"READ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"GET ","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.rfc-editor.org/rfc/rfc9110.html#name-get"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"INFO","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"HEAD ","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.rfc-editor.org/rfc/rfc9110.html#name-head"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"WRITE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"POST ","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.rfc-editor.org/rfc/rfc9110.html#name-post"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"UPDATE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"PUT ","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.rfc-editor.org/rfc/rfc9110.html#name-put"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.rfc-editor.org/rfc/rfc9110.html#name-delete"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"APPEND","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"n/a","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"COPY","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"n/a","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"n/a","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"TRACE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"n/a","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"CONNECT","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported