4.2.13. Update Object Metadata

You may set your own custom object metadata by using a POST request to the object name. The form of the request is X-Object-Meta-XXXX: Foo where XXXX is the custom field and Foo is the value. You may also set values for X-Delete-At and X-Delete-After for expiring objects.

To remove previously-set object metadata, do a POST request to the object name with X-Remove-Object-Meta-XXXX: foo where XXXX is the name of your custom header. Foo is any term, and it will not be used; you must, however, send some value with the request, otherwise it will be ignored.

	Note Deleting Object Metadata
	All the object metadata is set at the same time. If you want to edit or remove one header, simply post the other headers without it. This means, though, that if you delete one entry without posting the others, the others will be deleted at that time.

  POST /<api version>/<account>/<container>/<object> HTTP/1.1
  Host: storage.clouddrive.com
  X-Auth-Token: eaaafd18-0fed-4b3a-81b4-663c99ec1cbb
  X-Object-Meta-Fruit: Apple
  X-Object-Meta-Veggie: Carrot
                      

No response body is returned. A status code of 202 (Accepted) indicates success; status 404 (Not Found) is returned if the requested object does not exist.

  HTTP/1.1 202 Accepted
  Date: Thu, 07 Jun 2007 20:59:39 GMT
  Content-Length: 0
  Content-Type: text/plain; charset=UTF-8