Set allocator metadata

PUT /platform/infrastructure/allocators/{allocator_id}/metadata

Auth

Sets the allocator metadata.

Path parameters

allocator_id string required: The allocator identifier.

Query parameters

version string: Checks for conflicts against the metadata version, then returns the value in the x-cloud-resource-version header.

Request body

The metadata to update the allocator with

items object[] required: A collection of arbitrary metadata items associated with a resource.

Responses

The allocator metadata was successfully changed (the updated JSON is returned)

application/json

<array> object[]

The value specified is empty for at least one of the metadata tags. (code: allocators.invalid_empty_metadata_items)

application/json

The allocator specified by {allocator_id} cannot be found. (code: allocators.allocator_not_found)

application/json

View as Markdown

Examples

Request curl 1 / 1 language

curl Shell

curl -X PUT "${API_URL}/platform/infrastructure/allocators/${ALLOCATOR_ID}/metadata" \
  -u "${USERNAME}:${PASSWORD}" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  }'

Generated from the API spec

Response

[
  {
    "key": "string",
    "value": "string"
  }
]

Generated from the API spec

{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}

Generated from the API spec

{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}

Generated from the API spec