KEkeboola
Metadata

Create or update bucket metadata

Sets multiple metadata with one call. If the given key and provider combination already exist for the bucket, the data will be updated with the new value and timestamp. All metadata associated with the bucket are returned in the response.

Metadata are timestamped key-value pairs separated by the provider, where the provider is the originating component.

post/v2/storage/branch/{branchId}/buckets/{bucketId}/metadata

Request

Path parameters

bucketIdstring required

Id of the bucket.

branchIdstring required

Request body

providerstring required

Id of the creating component

Example request

{
  "provider": "test-component",
  "metadata": [
    {
      "key": "some-key",
      "value": "Some value"
    }
  ]
}

Response

All metadata associated with the bucket.

idstring required

Metadata record identifier

keystring required

Metadata key

valuestring nullable required

Metadata value

providerstring required

Id of the component that created the metadata

timestampstring required

When the metadata was created or last updated, ISO 8601 with a +hhmm offset

Example response

[
  {
    "id": "19509",
    "key": "some-key",
    "value": "Some value",
    "provider": "test-component",
    "timestamp": "2017-02-13T23:36:10+0100"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.