| Verb | URI | Description | |||
| PUT | /servers/id/metadata |
Set metadata | |||
| PUT | /images/id/metadata |
Set metadata | |||
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)
Sets metadata for the resource. Existing metadata items are replaced with the ones provided in the request. An overLimit (413) fault may be thrown if the maximum number of metadata items is 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.51. Metadata Reset 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 1</meta>
<meta key="Image Version">2.1</meta>
</metadata>
Example 4.52. Metadata Reset Request: JSON
{
"metadata" : {
"Server Label" : "Web Head 1",
"Image Version" : "2.1"
}
}
Example 4.53. Metadata Reset 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 1</meta>
<meta key="Image Version">2.1</meta>
</metadata>
Example 4.54. Metadata Reset Response: JSON
{
"metadata" : {
"Server Label" : "Web Head 1",
"Image Version" : "2.1"
}
}
