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		String
metadata			0-* Elements
name		String
value		String
namespace		String

Response Body

Response indicating Success or Failure of the operation

XML Example

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