Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Update Bucket Tags

PUT /object/bucket/{bucketName}/tags

Updates the tags provided tags for the specified bucket. Note that the operation will over write the existing tags with the new values All the specified tags must be present in the Bucket. If any one of the tags is missing in the Bucket, this will throw appropriate Error code (TBD)

bucketNameBucket name for which specified tags will be updated.

Required Roles

This call has no restrictions.


Prerequisites

The following conditions must be met in order to call this operation.

  • Bucket name should not be null or empty.

  • Bucket must exist.


Request Payload

All parameters are required unless otherwise stated.

Field Description Type Notes
update_bucket_tags
TagSet Tags - list of tags set for the Bucket
Tag     0-* Elements
Key The key of a tag String
Value The value of a tag String
namespace Namespace associated with the user/tenant that is allowed to access the bucket String

Response Body

Response indicating Success or Failure of the operation


XML Example

Request
> PUT /object/bucket/mybucket/tags HTTP/1.1
> Host: 192.168.0.0:4443
> User-Agent: curl/7.43.0
> Accept: */*
> X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
> Content-Type: application/xml
> Content-Length: 180
> Expect: 100-continue
>
< HTTP/1.1 100 Continue
* We are completely uploaded and fine
Response
< HTTP/1.1 200 OK