[openstack-dev] [nova][glance] Consistency around proposed server instance tagging API

Jay Pipes jaypipes at gmail.com
Wed Jun 4 18:44:13 UTC 2014

Hi Stackers,

I'm looking to get consensus on a proposed API for server instance 
tagging in Nova:


In the proposal, the REST API for the proposed server instance tagging 
looks like so:

Get list of tags for server:

GET /v2/{project_id}/servers/{server_id}/tags

Replace the set of tags for a server:

POST /v2/{project_id}/servers/{server_id}/tags

Add a single tag to a server:

PUT /v2/{project_id}/servers/{server_id}/tags/{tag}

Remove all tags on a server

DELETE /v2/{project_id}/servers/{server_id}/tags

Remove a tag on a server:

DELETE /v2/{project_id}/servers/{server_id}/tags/{tag}

It is this last API call that has drawn the attention of John Garbutt 
(cc'd). In Glance v2 API, if you attempt to delete a tag that does not 
exist, then a 404 Not Found is returned. In my proposal, if you attempt 
to delete a tag that does not exist for the server, a 204 No Content is 

John would like to gain some consensus on what approach is best going 
forward for simple string tagging APIs.

Please let us know your thoughts.


More information about the OpenStack-dev mailing list