8.3.4. Updating a Resource

Some resource properties are modified with a PUT request containing an updated description for the resource URI. Details on modifiable properties are found in the individual resource type documentation.

PUT /rhevm-api/{collection}/{resource_id} HTTP/1.1
Accept: application/xml
Content-Type: application/xml

<{resource}>
    <name>New-Resource-Name</name>
</{resource}>

HTTP/1.1 200 OK
Content-Type: application/xml

<{resource} id="{resource_id}" href="/rhevm-api/{collection}/{resource_id}">
    <name>New-Resource-Name</name>
    ...
</{resource}>

If an attempt is made to modify a strictly immutable resource property, this is reported as 409 Conflict error with a fault representation in the response body. Other non-modifiable properties specified in the request entity-body are to be ignored.