Set allocator metadata item

Adds or updates a single item to a given allocators metadata.

Request

PUT /api/v1/platform/infrastructure/allocators/{allocator_id}/metadata/{key}

Path parameters

allocator_id (required)
(string) The identifier for the allocator
key (required)
(string) The key of the metadata item to add or update

Query parameters

version
(integer) If specified, checks for conflicts against the version of the metadata (returned in 'x-cloud-resource-version' of the GET request)

Request body

(MetadataItemValue) (required) The value of the metadata item to add or update

Responses

200
(array[MetadataItem]) The allocator metadata was successfully changed (the updated JSON is returned)
400
(BasicFailedReply) The value specified for the metadata tag is empty (code: 'allocators.invalid_empty_metadata_item')
404
(BasicFailedReply) The allocator specified by {allocator_id} cannot be found (code: 'allocators.allocator_not_found') or the metadata item specified by {key} cannot be found (code: 'allocators.metadata_item_not_found')
449
(BasicFailedReply) elevated permissions are required. (code: '"root.needs_elevated_permissions"')