{"type":"doc","content":[{"type":"paragraph","content":[{"text":"These examples show how to use cURL commands for working with versioning.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"2550d3e4-60b7-44a7-8d02-c58d1112273a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"cc53e0d7-9728-45c4-b2ac-0e18f3b3a91b"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enable Versioning on a Cluster","type":"text"}]},{"type":"paragraph","content":[{"text":"There are three ways to enable versioning at the cluster level:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to Storage UI > Settings > Cluster > policy versioning. Select the checkbox to allow versioning, which is by default disallowed in the cluster.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the below command where replace ‘password’ with the cluster's admin password.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"swarmctl -C policy.versioning -V allowed -d [node ip] -p \"admin:password\"","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use an SNMP set command, adjusted for the environment. Here, use a different password than the cluster’s admin password.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"snmpset -m +CARINGO-CASTOR-MIB -v2c -M +/usr/share/snmp/mib2c-data -c -OQs {cluster} clusterConfig.policyVersioning s \"allowed\"","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enable Versioning on a Domain","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Policy-Versioning","type":"text","marks":[{"type":"code"}]},{"text":" header to enable versioning for an existing domain:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Enable versioning on an existing domain via Swarm","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i --location-trusted -X PUT --data-binary '' -H \"Policy-Versioning: enabled\" \"$NODEIP?domain=sample&preserve\"\n\nHTTP/1.1 201 Created\nCastor-System-Cluster: [cluster]\nLocation: http://192.168.203.190:80/?domain=sample\nVolume: 89d81040b7874fcfa139de754241bf8a\nCastor-System-Cluster: [cluster]\nLocation: http://192.168.203.174:80/?domain=sample\nVolume: c561ae012e1ae663986bb0c6b5baa0de\nStored-Digest: aaae8a6e741ae71ea7506b0ce42d37ad\nLast-Modified: Wed, 21 Dec 2022 15:46:18 GMT\nContent-UUID: 0cfe794730795e60f185ce3d0e81aa1d\nEntity-MD5: qq6KbnQa5x6nUGsM5C03rQ==\nCastor-System-Version: 1671637578.023\nEtag: \"af39faa06369ac30870c3e2b66a3b000\"\nCastor-System-Alias: 0cfe794730795e60f185ce3d0e81aa1d\nReplica-Count: 2\nDate: Wed, 21 Dec 2022 15:46:18 GMT\nServer: CAStor Cluster/15.0.0\nContent-Length: 54\nContent-Type: text/html\nKeep-Alive: timeout=14400\n\nNew stream version created","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Enable versioning on an existing domain via Gateway","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The rest of the examples will also be via Gateway as a best practice.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i -u admin:password -H 'Content-Type: application/castorcontext' -X PUT --data-binary '' -H \"Policy-Versioning: enabled\" \"$GATEWAYIP?domain=sample2&preserve\"\n\nHTTP/1.1 201 Created\nDate: Wed, 21 Dec 2022 16:10:11 GMT\nGateway-Request-Id: DFBB0F9EB128E296\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-Cluster: [cluster]\nLocation: http://10.1.1.194:80/?domain=sample2\nVolume: c561ae012e1ae663986bb0c6b5baa0de\nCastor-System-Cluster: [cluster]\nVolume: 66be989fe273740f6bc97f9be4ea9c94\nEntity-MD5: 66+MUvedXG6wbxmTw7Dd3g==\nContent-UUID: eebe5c4bdeb252c86828d94da0de0d16\nLast-Modified: Wed, 21 Dec 2022 16:10:11 GMT\nStored-Digest: ebaf8c52f79d5c6eb06f1993c3b0ddde\nContent-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==\nCastor-System-Version: 1671639011.138\nETag: \"49b2e909daa86020c58eab806ddd1ad1\"\nCastor-System-Alias: eebe5c4bdeb252c86828d94da0de0d16\nReplica-Count: 2\nContent-Type: text/html\nContent-Length: 54\n\nNew stream version created","type":"text"}]},{"type":"paragraph","content":[{"text":"Review the headers returned to verify the versioning state for a domain:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -si -u admin:password -I \"$GATEWAYIP?domain=sample2\" | grep Versioning\n\nPolicy-Versioning: enabled\nPolicy-Versioning-Evaluated: enabled\nPolicy-Versioning-Evaluated-Constrained: no\nPolicy-Versioning-Unnamed-Evaluated: disabled\nPolicy-Versioning-Unnamed-Evaluated-Constrained: no","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice ","type":"text"},{"text":"Policy-Version-Evaluated","type":"text","marks":[{"type":"code"}]},{"text":" is ","type":"text"},{"text":"enabled","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"},{"text":"All tenanted alias objects","type":"text","marks":[{"type":"em"}]},{"text":" in the domain are versioned.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Enable Versioning on a Bucket","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i -u admin:password -X PUT --data-binary '' -H 'Content-Type: application/castorcontext' -H \"Policy-Versioning: enabled\" \"$GATEWAYIP/mybucket?domain=sample2&preserve\"\n\nHTTP/1.1 201 Created\nDate: Wed, 21 Dec 2022 20:49:34 GMT\nGateway-Request-Id: 5D330C6C47BC1FAE\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-Cluster: [cluster]\nLocation: http://10.1.1.194:80/mybucket?domain=sample2\nVolume: e9b1c7c95951dda0457da891311b295e\nCastor-System-Cluster: [cluster]\nVolume: 66be989fe273740f6bc97f9be4ea9c94\nStored-Digest: a9006f97c09bc19f8e7d87a6f95ac7b5\nEntity-MD5: qQBvl8CbwZ+OfYem+VrHtQ==\nLast-Modified: Wed, 21 Dec 2022 20:49:34 GMT\nContent-UUID: b443e93b52178fb23388ec45c2ac2def\nContent-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==\nCastor-System-Version: 1671655774.096\nETag: \"7a5d13e0f28914bf5ca9aab7f1a3722b\"\nCastor-System-Alias: b443e93b52178fb23388ec45c2ac2def\nReplica-Count: 2\nContent-Type: text/html\nContent-Length: 54\n\nNew stream version created","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the versioning state of the bucket:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -si -uadmin:password -I \"$GATEWAYIP/mybucket?domain=sample2\" | grep -i Policy-Versioning\n\nPolicy-Versioning: enabled\nPolicy-Versioning-Evaluated: enabled\nPolicy-Versioning-Evaluated-Constrained: no","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice ","type":"text"},{"text":"Policy-Version-Evaluated","type":"text","marks":[{"type":"code"}]},{"text":" is also ","type":"text"},{"text":"enabled","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"},{"text":"All named objects in the bucket","type":"text","marks":[{"type":"em"}]},{"text":" are versioned.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a Named Object in the Bucket","type":"text"}]},{"type":"paragraph","content":[{"text":"This request has typical headers.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -si -uadmin:password -X POST --post301 --data-binary \"First version's content.\" -H 'Content-type: text/html' \"$GATEWAYIP/mybucket/hello%20world.html?domain=sample2\"\n\nHTTP/1.1 201 Created\nDate: Wed, 21 Dec 2022 22:40:10 GMT\nGateway-Request-Id: DB5421FA96C99A98\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-Cluster: [cluster]\nLocation: http://10.1.1.194:80/mybucket/hello%20world.html?domain=sample2\nVolume: c561ae012e1ae663986bb0c6b5baa0de\nCastor-System-Cluster: [cluster]\nVolume: 66be989fe273740f6bc97f9be4ea9c94\nStored-Digest: e4b22c28f2f6cc0eaff4946ac5ded872\nEntity-MD5: 5LIsKPL2zA6v9JRqxd7Ycg==\nLast-Modified: Wed, 21 Dec 2022 22:40:10 GMT\nContent-MD5: b6t5pSGMP6IKdfDUN5fSKA==\nCastor-System-Version: 1671662410.687\nETag: \"e98dabd2f4c7a6c3cdd84ae139112fe2\"\nReplica-Count: 2\nContent-Type: text/html\nContent-Length: 46\n\nNew stream created","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the new object:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i \"http://$GATEWAYIP:80/mybucket/hello%20world.html?domain=sample2\"\n\nHTTP/1.1 200 OK\nDate: Wed, 21 Dec 2022 22:42:13 GMT\nGateway-Request-Id: CDDA321C42C8C9B9\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-CID: b443e93b52178fb23388ec45c2ac2def\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 22:40:10 GMT\nCastor-System-IsVersioned: True\nCastor-System-Name: hello%20world.html\nCastor-System-Version: 1671662410.687\nContent-Type: text/html\nLast-Modified: Wed, 21 Dec 2022 22:40:10 GMT\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nCastor-System-Path: /sample2/mybucket/hello%20world.html\nCastor-System-Domain: sample2\nVolume: 66be989fe273740f6bc97f9be4ea9c94\nVolume-Hint: c561ae012e1ae663986bb0c6b5baa0de\nFeed-0-Status: 0\nFeed-0-StatusTime: Wed, 21 Dec 2022 22:40:11 GMT\nMinReps: 2\nPolicy-Versioning-Evaluated: enabled\nPolicy-Versioning-Evaluated-Constrained: no\nPolicy-ECMinStreamSize-Evaluated: 1000000\nPolicy-ECMinStreamSize-Evaluated-Constrained: yes\nPolicy-ECEncoding-Evaluated: 2:1\nPolicy-ECEncoding-Evaluated-Constrained: disabled,k:p (k+p <= 16, p >= 1)\nPolicy-Replicas-Evaluated: min:2 max:16 default:2\nPolicy-Replicas-Evaluated-Constrained: yes\nPolicy-Lifecycle-Evaluated: disabled\nPolicy-Lifecycle-Evaluated-Constrained: yes\nContent-MD5: b6t5pSGMP6IKdfDUN5fSKA==\nCastor-System-Persisted-Headers: x-last-modified-by-meta, content-md5, x-owner-meta, content-type, content-length\nETag: \"e98dabd2f4c7a6c3cdd84ae139112fe2\"\nContent-Length: 50\n\nFirst version's content.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"List Versions in the Bucket","type":"text"}]},{"type":"paragraph","content":[{"text":"Elasticsearch must be enabled to use listing operations. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Tip","type":"text"}]},{"type":"paragraph","content":[{"text":"Always add ","type":"text"},{"text":"&sort=tmborn:DESC,etag:DESC","type":"text","marks":[{"type":"code"}]},{"text":" to listing operations to retrieve the versions in the precise order Swarm is maintaining, starting with the current version.","type":"text"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i \"http://$GATEWAYIP/mybucket?domain=sample2&format=json&name=hello%20world.html&versions&sort=tmborn:DESC,etag:DESC\"\n\nHTTP/1.1 200 OK\nDate: Wed, 21 Dec 2022 23:06:24 GMT\nGateway-Request-Id: ED556FDB95E491A4\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nAllow-Encoding: *;q=0\nCastor-System-Alias: b443e93b52178fb23388ec45c2ac2def\nCastor-System-CID: eebe5c4bdeb252c86828d94da0de0d16\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 20:49:34 GMT\nCastor-System-Name: mybucket\nCastor-System-Version: 1671655774.096\nPolicy-Versioning: enabled\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nX-Timestamp: Wed, 21 Dec 2022 20:49:34 GMT\nX-timestamp: Wed, 21 Dec 2022 23:06:24 GMT\nContent-Type: application/json;charset=utf-8\nCastor-Object-Count: 1\nCastor-System-Object-Count: 1\nLast-Modified: Wed, 21 Dec 2022 23:06:24 GMT\nTransfer-Encoding: chunked\n\n[\n{\"last_modified\": \"2022-12-21T22:40:10.684000Z\", \"bytes\": 50, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"e98dabd2f4c7a6c3cdd84ae139112fe2\", \"written\": \"2022-12-21T22:40:10.684000Z\", \"accessed\": \"2022-12-21T22:40:10.684000Z\", \"content_type\": \"text/html\"}\n]","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Update the Named Object (Updated Twice, Only Once Shown)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -si -uadmin:password -X PUT --post301 --data-binary \"Second version's content.\" \"$GATEWAYIP/mybucket/hello%20world.html?domain=sample2&preserve\"\n\nHTTP/1.1 201 Created\nDate: Wed, 21 Dec 2022 23:11:35 GMT\nGateway-Request-Id: 9EAD2CBB3F9369D2\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-Cluster: [cluster]\nLocation: http://10.1.1.194:80/mybucket/hello%20world.html?domain=sample2\nVolume: d4504566ed67a87859434ac3c50bfbe0\nCastor-System-Cluster: [cluster]\nVolume: c561ae012e1ae663986bb0c6b5baa0de\nStored-Digest: 4e03ba04fe79174a2917224ba563b76f\nLast-Modified: Wed, 21 Dec 2022 23:11:34 GMT\nEntity-MD5: TgO6BP55F0opFyJLpWO3bw==\nContent-MD5: 1CUcVg3EvQ/iY+jeluDZwA==\nCastor-System-Version: 1671664294.839\nETag: \"46fdddc9896e3f4800587e146f17143b\"\nReplica-Count: 2\nContent-Type: text/html\nContent-Length: 54\n\nNew stream version created","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify the change to the named object:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i \"http://$GATEWAYIP/mybucket/hello%20world.html?domain=sample2\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 03:49:37 GMT\nGateway-Request-Id: 2ACB41593842C0D9\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-CID: b443e93b52178fb23388ec45c2ac2def\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 23:13:12 GMT\nCastor-System-IsVersioned: True\nCastor-System-Name: hello%20world.html\nCastor-System-Version: 1671664392.715\nLast-Modified: Wed, 21 Dec 2022 23:13:12 GMT\nX-Last-Modified-By-Meta: caringoadmin@\nContent-Type: text/html\nx-owner-meta: admin\nETag: \"3e4beb34f333637de16abc33bf01656b\"\nCastor-System-Path: /sample2/mybucket/hello%20world.html\nCastor-System-Domain: sample2\nVolume: 89d81040b7874fcfa139de754241bf8a\nContent-MD5: 1CUcVg3EvQ/iY+jeluDZwA==\nContent-Length: 51\n\nSecond version's content.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"View the New Version in the Listing","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i \"http://$GATEWAYIP/mybucket?domain=sample2&format=json&name=hello%20world.html&versions&sort=tmborn:DESC,etag:DESC\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 03:50:15 GMT\nGateway-Request-Id: 7DA849568377ABF5\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nAllow-Encoding: *;q=0\nCastor-System-Alias: b443e93b52178fb23388ec45c2ac2def\nCastor-System-CID: eebe5c4bdeb252c86828d94da0de0d16\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 20:49:34 GMT\nCastor-System-Name: mybucket\nCastor-System-Version: 1671655774.096\nPolicy-Versioning: enabled\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nX-Timestamp: Wed, 21 Dec 2022 20:49:34 GMT\nX-timestamp: Thu, 22 Dec 2022 03:50:15 GMT\nContent-Type: application/json;charset=utf-8\nCastor-Object-Count: 3\nCastor-System-Object-Count: 3\nLast-Modified: Thu, 22 Dec 2022 03:50:15 GMT\nTransfer-Encoding: chunked\n\n[\n{\"last_modified\": \"2022-12-21T23:13:12.712000Z\", \"bytes\": 51, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"3e4beb34f333637de16abc33bf01656b\", \"written\": \"2022-12-21T23:13:12.712000Z\", \"accessed\": \"2022-12-21T23:13:12.712000Z\", \"content_type\": \"text/html\"},\n{\"last_modified\": \"2022-12-21T23:11:34.836000Z\", \"bytes\": 51, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"46fdddc9896e3f4800587e146f17143b\", \"written\": \"2022-12-21T23:11:34.836000Z\", \"accessed\": \"2022-12-21T23:11:34.836000Z\", \"content_type\": \"application/x-www-form-urlencoded\", \"version\": \"46fdddc9896e3f4800587e146f17143b\"},\n{\"last_modified\": \"2022-12-21T22:40:10.684000Z\", \"bytes\": 50, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"e98dabd2f4c7a6c3cdd84ae139112fe2\", \"written\": \"2022-12-21T22:40:10.684000Z\", \"accessed\": \"2022-12-21T22:40:10.684000Z\", \"content_type\": \"text/html\", \"version\": \"e98dabd2f4c7a6c3cdd84ae139112fe2\"}\n]","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Read the First Version-Notice the Content","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"[root@c-scs2 ~]# curl -i \"http://$GATEWAYIP/mybucket/hello%20world.html?domain=sample2&version=e98dabd2f4c7a6c3cdd84ae139112fe2\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 04:09:30 GMT\nGateway-Request-Id: 170D625BE7343EFC\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-CID: b443e93b52178fb23388ec45c2ac2def\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 22:40:10 GMT\nCastor-System-IsVersioned: True\nCastor-System-Name: hello%20world.html\nCastor-System-Version: 1671662410.687\nContent-Type: text/html\nLast-Modified: Wed, 21 Dec 2022 22:40:10 GMT\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nETag: \"e98dabd2f4c7a6c3cdd84ae139112fe2\"\nCastor-System-Path: /sample2/mybucket/hello%20world.html\nCastor-System-Domain: sample2\nVolume: c561ae012e1ae663986bb0c6b5baa0de\nContent-MD5: b6t5pSGMP6IKdfDUN5fSKA==\nContent-Length: 50\n\nFirst version's content.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Delete the Prior Version","type":"text"}]},{"type":"paragraph","content":[{"text":"Deleting that historical version permanently erases it:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i -X DELETE \"http://$GATEWAYIP/mybucket/hello%20world.html?domain=sample2&version=e98dabd2f4c7a6c3cdd84ae139112fe2\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 04:17:44 GMT\nGateway-Request-Id: BD12E54ED7BE6E5C\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-CID: b443e93b52178fb23388ec45c2ac2def\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 22:40:10 GMT\nCastor-System-IsVersioned: True\nCastor-System-Name: hello%20world.html\nCastor-System-Version: 1671662410.687\nContent-Type: text/html\nLast-Modified: Wed, 21 Dec 2022 22:40:10 GMT\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nETag: \"e98dabd2f4c7a6c3cdd84ae139112fe2\"\nCastor-System-Path: /sample2/mybucket/hello%20world.html\nCastor-System-Domain: sample2\nVolume: c561ae012e1ae663986bb0c6b5baa0de\nContent-Length: 0","type":"text"}]},{"type":"paragraph","content":[{"text":"List the versions again to verify the deletion:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i \"http://$GATEWAYIP/mybucket?domain=sample2&format=json&name=hello%20world.html&versions&sort=tmborn:DESC,etag:DESC\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 04:18:13 GMT\nGateway-Request-Id: BC7BB8A927B13301\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nAllow-Encoding: *;q=0\nCastor-System-Alias: b443e93b52178fb23388ec45c2ac2def\nCastor-System-CID: eebe5c4bdeb252c86828d94da0de0d16\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 20:49:34 GMT\nCastor-System-Name: mybucket\nCastor-System-Version: 1671655774.096\nPolicy-Versioning: enabled\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nX-Timestamp: Wed, 21 Dec 2022 20:49:34 GMT\nX-timestamp: Thu, 22 Dec 2022 04:18:13 GMT\nContent-Type: application/json;charset=utf-8\nCastor-Object-Count: 2\nCastor-System-Object-Count: 2\nLast-Modified: Thu, 22 Dec 2022 04:18:13 GMT\nTransfer-Encoding: chunked\n\n[\n{\"last_modified\": \"2022-12-21T23:13:12.712000Z\", \"bytes\": 51, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"3e4beb34f333637de16abc33bf01656b\", \"written\": \"2022-12-21T23:13:12.712000Z\", \"accessed\": \"2022-12-21T23:13:12.712000Z\", \"content_type\": \"text/html\"},\n{\"last_modified\": \"2022-12-21T23:11:34.836000Z\", \"bytes\": 51, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"46fdddc9896e3f4800587e146f17143b\", \"written\": \"2022-12-21T23:11:34.836000Z\", \"accessed\": \"2022-12-21T23:11:34.836000Z\", \"content_type\": \"application/x-www-form-urlencoded\", \"version\": \"46fdddc9896e3f4800587e146f17143b\"}\n]","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Delete the Current Version","type":"text"}]},{"type":"paragraph","content":[{"text":"Deleting the current version adds a delete marker:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"# curl -i -X DELETE \"http://$GATEWAYIP/mybucket/hello%20world.html?domain=sample2\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 04:23:03 GMT\nGateway-Request-Id: 21713A8E6BA4DB52\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nCastor-System-CID: b443e93b52178fb23388ec45c2ac2def\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 23:13:12 GMT\nCastor-System-IsVersioned: True\nCastor-System-Name: hello%20world.html\nCastor-System-Version: 1671664392.715\nLast-Modified: Wed, 21 Dec 2022 23:13:12 GMT\nX-Last-Modified-By-Meta: caringoadmin@\nContent-Type: text/html\nx-owner-meta: admin\nETag: \"3e4beb34f333637de16abc33bf01656b\"\nCastor-System-Path: /sample2/mybucket/hello%20world.html\nCastor-System-Domain: sample2\nVolume: e9b1c7c95951dda0457da891311b295e\nCastor-System-Delete-Marker-Etag: \"771fc52c3e3b8171ad7e6e064ef31f43\"\nContent-Length: 0","type":"text"}]},{"type":"paragraph","content":[{"text":"Listing the versions shows the addition of a new version, the delete marker:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# curl -i \"http://$GATEWAYIP/mybucket?domain=sample2&format=json&name=hello%20world.html&versions&sort=tmborn:DESC,etag:DESC\"\n\nHTTP/1.1 200 OK\nDate: Thu, 22 Dec 2022 04:23:45 GMT\nGateway-Request-Id: B78CD72BE8C06C20\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nAllow-Encoding: *;q=0\nCastor-System-Alias: b443e93b52178fb23388ec45c2ac2def\nCastor-System-CID: eebe5c4bdeb252c86828d94da0de0d16\nCastor-System-Cluster: [cluster]\nCastor-System-Created: Wed, 21 Dec 2022 20:49:34 GMT\nCastor-System-Name: mybucket\nCastor-System-Version: 1671655774.096\nPolicy-Versioning: enabled\nX-Last-Modified-By-Meta: admin@\nX-Owner-Meta: admin\nX-Timestamp: Wed, 21 Dec 2022 20:49:34 GMT\nX-timestamp: Thu, 22 Dec 2022 04:23:45 GMT\nContent-Type: application/json;charset=utf-8\nCastor-Object-Count: 3\nCastor-System-Object-Count: 3\nLast-Modified: Thu, 22 Dec 2022 04:23:45 GMT\nTransfer-Encoding: chunked\n\n[\n{\"deletemarker\": \"true\", \"last_modified\": \"2022-12-22T04:23:03.768000Z\", \"bytes\": 0, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"771fc52c3e3b8171ad7e6e064ef31f43\", \"written\": \"2022-12-22T04:23:03.768000Z\", \"accessed\": \"2022-12-22T04:23:03.768000Z\"},\n{\"last_modified\": \"2022-12-21T23:13:12.712000Z\", \"bytes\": 51, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"3e4beb34f333637de16abc33bf01656b\", \"written\": \"2022-12-21T23:13:12.712000Z\", \"accessed\": \"2022-12-21T23:13:12.712000Z\", \"version\": \"3e4beb34f333637de16abc33bf01656b\", \"content_type\": \"text/html\"},\n{\"last_modified\": \"2022-12-21T23:11:34.836000Z\", \"bytes\": 51, \"versioned\": \"true\", \"name\": \"hello world.html\", \"hash\": \"46fdddc9896e3f4800587e146f17143b\", \"written\": \"2022-12-21T23:11:34.836000Z\", \"accessed\": \"2022-12-21T23:11:34.836000Z\", \"version\": \"46fdddc9896e3f4800587e146f17143b\", \"content_type\": \"application/x-www-form-urlencoded\"}\n]","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice the delete marker has the same name but is 0 bytes and has ","type":"text"},{"text":"\"deletemarker\":\"true\"","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Check the Delete Marker","type":"text"}]},{"type":"paragraph","content":[{"text":"Getting INFO on the current version (the delete marker) results in a ","type":"text"},{"text":"404 Not Found","type":"text","marks":[{"type":"strong"}]},{"text":" error, but provides information about the delete marker:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"# curl -iI \"http://$GATEWAYIP/mybucket/hello%20world.html?domain=sample2\"\n\nHTTP/1.1 404 Not Found\nDate: Thu, 22 Dec 2022 04:24:51 GMT\nGateway-Request-Id: 7BF3F53FBCB1CC86\nServer: CAStor Cluster/15.0.0\nVia: 1.1 10.1.1.194 (Cloud Gateway SCSP/7.10.1)\nGateway-Protocol: scsp\nLast-Modified: Thu, 22 Dec 2022 04:23:03 GMT\nETag: \"771fc52c3e3b8171ad7e6e064ef31f43\"\nCastor-System-Error-Token: NotFoundMarker\nCastor-System-Error-Text: Versioned object has a delete marker.\nCastor-System-Error-Code: 404\nCastor-System-Cluster: [cluster]\nAllow: POST, GET, HEAD, PUT, DELETE, COPY, APPEND, PATCH, GEN, SEND\nContent-Length: 0","type":"text"}]},{"type":"paragraph","content":[{"text":"Note the ETag (version ID) of the delete marker is returned.","type":"text"}]}],"version":1}

Browser not supported