request
. This configuration contains the entire configuration for the resource and not simply a series of changes to the existing values. The plugin responsible for managing the given resource must inform that resource that its configuration has changed to the given set of new values. Note that this method should not throw any exceptions; instead, all error conditions should be indicated in the response object when sent back to the caller.
@param request tells you the resource to configure and the full set of configuration values for the resourcereport
. 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-null
value 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
|
|
|
|
|
|