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

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

Responses

202
(array[AllocatorMetadataItem]) The allocator metadata was successfully changed (the updated JSON is returned)
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) When running as an administrator (other than root), sudo is required (code: 'root.needs_sudo')