ECS 3.6.2 Data Access Guide

PDF

Manage Object Tagging

This section describes all the supported APIs that are required to manage Object Tagging.

PUT object tagging

updateObjectTags.
Returns with ObjectWriteResponse.
Replaces the existing tag set on an object with objectInfo to new objectTags. This API does not merge existing tags with new tags,objectTags passed to this API replaces the existing objectTags (if any) for the object with objectInfo.

NOTE:

If you send this request with an empty tag set, it deletes the existing tags for an object with objectInfo.
Use the DELETE Object Tagging request to delete all the tags for an object.

GET Object Tagging

getObjectTags.
Returns with set of tags associated with object.
Retrieves the set of tags that are associated with requested object with objectInfo and versionId.

DELETE Object Tagging

deleteObjectTags
Returns true if deletion of object tag is successful for object.
Deletes all tags that are associated with an object that is identified by objectInfo for current/versionId of an object.

Table 1. Object Tagging parameters
Parameter	Description
objectInfo	Unique ID associated with the object to which, the objectTags must be updated.
keypoolData	Information regarding keypool.
versionId	Version of the object on which, the tags must be updated. Value NULL retrieves tags for current version of the object
credential	Permission to update tags for an object
objectTags	Set of tags that must be associated with an object.