Data-Object Operations

On This Page

To work with data, of any format, as a simple data object, first retrieve the container objects using the GET Container operation, and then use the following S3-like RESTful API object operations:

  • GET Object — retrieves an object from a container.

  • DELETE Object — deletes an object from a container.

  • PUT Object — adds a new object to a container, or appends data to an existing object. The option to append data is extension to the S3 PUT Object capabilities — see Appending Data.

  • POST Object — an alias of the PUT Object operation.

    Unlike S3, POST Object acts in the same way as PUT Object.

  • HEAD Object — retrieves the metadata of a data object.

You can find examples of Simple Object Web-API data-object operation requests in the Ingesting and Consuming Files tutorial.

Appending Data

To append data to an existing container object, use a PUT Object operation (see PUT Object), and include the following header in the request:

Range: -1


The following example adds the string "The End" at the end of a "MyObject" object:

    PUT /mycontainer/MyObject HTTP/1.1
    Content-Type: application/octet-stream
    X-v3io-session-key: e8bd4ca2-537b-4175-bf01-8c74963e90bf
    Range: -1
    "The End"
    import requests
    url = ""
    headers = {
                "Content-Type": "application-octet-stream",
                "X-v3io-session-key": "e8bd4ca2-537b-4175-bf01-8c74963e90bf",
                "Range": "-1"
    payload = "The End"
    response = requests.put(url, data=payload, headers=headers)