libcdmi-python¶

A python library (libcdmi-python) was written to simplify interactions with Stoxy. Examples of usage can be directly taken from unit tests.

cURL¶

You can use curl for constructing a valid CDMI request. For example, to create a new container, run the following command (replace port 8080 for the one where your Stoxy instance is listening):

Creating/updating a container with CDMI content-type¶

$ curl -v -u username:pass \
     -H 'x-cdmi-specification-version: 1.0.2' \
     -H 'content-type: application/cdmi-container' \
     -H 'accept:application/cdmi-container' \
     -X PUT http://cdmiserver:8080/newcontainer

Refer to CDMI reference for more precise header/body specification.

Creating/updating an object with CDMI content-type¶

$ curl -v -u username:pass \
      -H 'x-cdmi-specification-version: 1.0.2' \
      -H 'content-type: application/cdmi-object' \
      -H 'accept: application/cdmi-object' \
      -X PUT http://cdmiserver:8080/containername/objectname

Request body is expected to be a JSON-encoded data structure, with ‘’value’’ attribute set to the object (file) contents, encoded as either a UTF-8 string with Unicode escape sequences or base64. ‘’valuetransferencoding’’ field must then describe the encoding as either ‘utf-8’ or ‘base64’ respectively.

Note, that creating and updating objects is performed using virtually the same request structure. If the object being sent with the request already exists, it will be updated by Stoxy.

Creating/updating an object with non-CDMI content-type¶

$ curl -v -u username:pass \
      -H 'x-cdmi-specification-version: 1.0.2' \
      -H 'content-type: application/octet-stream' \
      -X PUT http://cdmiserver:8080/containername/objectname

Request body is expected to be the object (file) contents.

Deleting an object¶

$ curl -v -u username:pass \
      -H 'x-cdmi-specification-version: 1.0.2' \
      -X DELETE http://cdmiserver:8080/containername/objectname