Show Table of Contents
3.3. Using PUT to Modify Resources
This section describes how to use
PUT requests to modify Satellite resources. Special permissions might be required for some PUT requests; see Appendix A, API Permissions Matrix for information about API permissions.
3.3.1. Updating a Resource
Modify resource properties with a PUT request containing an updated description from a previous
GET request for the resource URI. Details on modifiable properties are found in the individual resource type documentation.
A
PUT request requires a Content-Type header. This informs the API of the representation MIME type in the body content as part of the request.
Include an Accept HTTP header to define the MIME type for the response format.
PUT /api/collection/resource_id HTTP/1.1 Accept: MIME type Content-Type: MIME type body
This does not include immutable resource properties that an API user has attempted to modify. If you attempt to modify a strictly immutable resource property, the API reports a conflict with an error message representation in the response body.
Properties omitted from the representation are ignored and not changed.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.