Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




Add Bucket Tags

POST /object/bucket/{bucketName}/tags

Adds the tags provided tags for the specified bucket. This will return with an ERROR when the total number of existing tags and the tags specified exceeds 10

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
add_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
> POST /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: 174
> Expect: 100-continue
>
< HTTP/1.1 100 Continue
* We are completely uploaded and fine
Response
< HTTP/1.1 200 OK