DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT - 

4.6.3. Update Metadata

Verb URI Description
POST /servers/id/metadata Update metadata items
POST /images/id/metadata Update metadata items

Normal Response Code(s): 200

Error Response Code(s): computeFault (400, 500, …), serviceUnavailable (503), unauthorized (401), forbidden (403), badRequest (400), badMethod (405), overLimit (413), itemNotFound (404), badMediaType (415), buildInProgress (409)

Updates resource metadata. Updates will replace existing metadata items with the same key. Items not explicitly mentioned in the request will not be modified. An overLimit (413) fault may be thrown if the operation causes the maximum number of metadata items to be exceeded. The maximum number of key-value pairs that can be supplied per server is determined by the compute provider and may be queried via the maxServerMeta absolute limit. The maximum number of key-value pairs for an image may be queried via the maxImageMeta absolute limit.

Example 4.55. Metadata Update Request: XML 

<?xml version="1.0" encoding="UTF-8"?>

<metadata xmlns="http://docs.openstack.org/compute/api/v1.1">
    <meta key="Server Label">Web Head 2</meta>
</metadata>

Example 4.56. Metadata Update Request: JSON 

{
    "metadata" : {
            "Server Label" : "Web Head 2"
        }
}

Example 4.57. Metadata Update Response: XML 

<?xml version="1.0" encoding="UTF-8"?>

<metadata xmlns="http://docs.openstack.org/compute/api/v1.1">
    <meta key="Server Label">Web Head 2</meta>
    <meta key="Image Version">2.1</meta>
</metadata>

Example 4.58. Metadata Update Response: JSON 

{
    "metadata" : {
            "Server Label" : "Web Head 2",
            "Image Version" : "2.1"
        }
}

Legal notices