Ditto Protocol topic structure for Policies
A valid topic consists of five elements, describing the policy affected by this message and the type of the message:
namespace: the namespace of the Policy.
policyName: the name of the Policy.
group: the group for addressing Policies is
criterion: the type of Protocol messages addressing Policies is
commands, for announcements it is
action: the action executed on the Policy via
subject: for announcements the
subjectcontains the announcement name
Note: The topic path of the policies group does not contain a channel unlike the things group.
The representation of a
Policy is specified as follows:
The following Policy commands are available:
Common errors to commands
Each Policy command could also result in an error response.
"topic" of such errors differ from the command
"topic" - correlation is however possible via the
"correlation-id" header which is preserved in the error message.
The following table contains common error codes for Policy commands:
||Bad Format - The request could not be completed due to malformed request syntax.|
||Unauthorized - The request could not be completed due to missing authentication.|
||Forbidden - The Policy could not be modified/deleted/retrieved as the requester had insufficient permissions.|
||Not Found - The request could not be completed. The Policy with the given ID was not found in the context of the authenticated user.|
||Precondition Failed - A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you specified an
||Request Entity Too Large - The created or modified Policy is larger than the configured limit (defaults to 100 kB).|
||Too many modifying requests are already outstanding to a specific Policy.|