PATCH Method

RESTCONF uses the HTTP PATCH method defined to provide an extensible framework for resource-patching mechanisms. Each patch mechanism requires a unique media type.

For a leaf-list case, the PATCH method must not be used to change the key values of the leaf-list instance.

  • If the target resource instance does not exist, the server must not create it.
  • If the PATCH request succeeds, a "200 OK" message is returned if there is a message-body. The "204 No Content" message is returned if no response message-body is sent.
  • If the user authentication fails, the "401 Unauthorized" message is returned.
  • If the user is not authorized to alter the target resource, an error response containing a "403 Forbidden" status-line will be returned. A server may return a "404 Not Found" status-line. The error-tag value "invalid-value" is used in this case.
Parent topic: CRUD Operations