report. This configuration contains the entire configuration for the resource and not simply a series of changes to the existing values. The method implementation must not change the property values; the Configuration must either be used as-is or a failure must be indicated with error messages attached to the invalid property values indicating why they were invalid. Implementations must set the report's final {@link ConfigurationUpdateReport#setStatus(ConfigurationUpdateStatus) status} (for example,{@link ConfigurationUpdateStatus#SUCCESS} or {@link ConfigurationUpdateStatus#FAILURE}). If the method leaves the status to as null or {@link ConfigurationUpdateStatus#INPROGRESS}, the caller should assume the method somehow aborted the update and will consider it a failure. If an error occurred, the implementation should set the request's {@link ConfigurationUpdateReport#getErrorMessage() error message} to a non-nullvalue that will describe an overall error message and it should set the {@link ConfigurationUpdateReport#setConfiguration(Configuration) configuration} with all the properties in thembut that contain {@link Property#getErrorMessage() property error messages} that indicate which properties failedto get updated and why. This allows you to indicate all the errors that occurred, in case more than one property was invalid or could not be updated.
Note that this method should not throw any exceptions; instead, all error conditions should be indicated in the report.
@param report | |
| |