Resource Operation

Introduction

Configuration Vector messages pass between the ManageApp and any other application (including itself) to request that the application update a configuration vector, by performing an insert/update/delete action.

The target application itself chooses which of its configuration vectors are published via the management messages interface, and which of those vector rows may be deleted or updated, and which fields within that row may be updated (or inserted, if row inserts are supported).

The target application is responsible for performing validation checks on the submitted values, and may decline to honor the request. It may decide to apply adjusted values, and (for inserts) may apply defaults to fields which have no requested value. The target application must report back the final row values which were updated or inserted.

The target application is responsible for applying the effects of the change, which may include immediate updates, or delayed updates.

Note that the change affects the running configuration only. The change is ephemeral, and will be lost if the application is restarted.

!MANAGEMENT-RESOURCE-OPERATION-REQUEST

The !MANAGEMENT-RESOURCE-OPERATION-REQUEST message is sent by ManageApp to any application (including itself and the WatchdogApp) in order to request an operation to be performed on a row from the application’s resource vector table.

The request fields are:

Field Type Description
resource_key String [Required] A value which matches the key of a resource vector.
resource_row_key Scalar [Required] The row key on which to perform the action.
operation_key String [Required] The key value of the operation to be updated.
This is the key for the column in the resource drilldown with type = operation.

!MANAGEMENT-RESOURCE-OPERATION-RESPONSE

The !MANAGEMENT-RESOURCE-OPERATION-RESPONSE message is returned to the ManageApp by the application to confirm or decline the requested resource row operation.

The response fields are:

Field Type Description
success 0/1 [Required] Indicates if the resource operation request was successful.
error String When success = 0, describes the reason that the request was not successful, and all subsequent fields are not present.
resource_key String [Required] Confirms the resource vector key which was provided in the request.
resource_row_key Scalar [Required] Confirms the resource row key on which the operation was performed.
operation_key String [Required] Confirms the key value of the operation which was performed.
note String An optional note that should be displayed to the administrator, e.g. describing partial success, or describing other actions which are recommended to be performed.