Bucket:Set Bucket Head Metadata

Search (SHIFT+S)

Set Bucket Head Metadata

PUT /object/bucket/{bucketName}/metadata

Persist additional head metadata for the bucket

bucketName	name of the bucket for which the metadata is to be added

Query Parameters

namespace	namespace of the bucket

Required Roles

This call has no restrictions.

Prerequisites

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

bucket must exist

Request Payload

<bucket_head_metadata>
   <head_type></head_type>
   <metadata>
      <name></name>
      <value></value>
   </metadata>
   <namespace></namespace>
</bucket_head_metadata>

{
  "head_type": "",
  "metadata": [
    {
      "name": "",
      "value": ""
    }
  ],
  "namespace": ""
}

All parameters are required unless otherwise stated.

Field	Description	Type	Notes
bucket_head_metadata
head_type	The head-type of the bucket metadata (S3, SWIFT, ATMOS, HDFS, CAS, NFS, INTERNAL, DT_QUERY)	String
metadata			0-* Elements
name	Name of the metadata entry	String
value	Value of the metadata entry	String
namespace	Namespace of the bucket	String

Response Body

Response indicating Success or Failure of the operation

Examples

Request

> PUT /object/bucket/mybucket/metadata?namespace=dare 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: 183
> Expect: 100-continue
>
< HTTP/1.1 100 Continue
* We are completely uploaded and fine

Response

< HTTP/1.1 200 OK

Request

curl -H $token -H "Content-Type: application/xml" -X PUT https://$nodeIp:4443/object/bucket/mybucket/metadata?namespace=dare

Response

HTTP/1.1 200 OK
Content-Type: application/xml