5.13.6 DeleteMonitoredItems

5.13.6.1 Description

This Service is used to remove one or more MonitoredItems of a Subscription. When a MonitoredItem is deleted, its triggered item links are also deleted.

Successful removal of a MonitoredItem, however, might not remove Notifications for the MonitoredItem that are in the process of being sent by the Subscription. Therefore, Clients may receive Notifications for the MonitoredItem after they have received a positive response that the MonitoredItem has been deleted.

5.13.6.2 Parameters

Table 75 defines the parameters for the Service.

Table 75 – DeleteMonitoredItems Service Parameters
NameTypeDescription
Request

requestHeader

RequestHeaderCommon request parameters (see 7.32 for RequestHeader definition).

subscriptionId

IntegerIdThe Server-assigned identifier for the Subscription that contains the MonitoredItems to be deleted (see 7.19 for IntegerId definition).

monitoredItemIds []

IntegerIdList of Server-assigned ids for the MonitoredItems to be deleted.
Response

responseHeader

Response HeaderCommon response parameters (see 7.33 for ResponseHeader definition).

results []

StatusCodeList of StatusCodes for the MonitoredItems to delete (see 7.38 for StatusCode definition). The size and order of the list matches the size and order of the monitoredItemIds request parameter.

diagnosticInfos []

DiagnosticInfoList of diagnostic information for the MonitoredItems to delete (see 7.12 for DiagnosticInfo definition). The size and order of the list matches the size and order of the monitoredItemIds request parameter. This list is empty if diagnostics information was not requested in the request header or if no diagnostic information was encountered in processing of the request.
5.13.6.3 Service results

Table 76 defines the Service results specific to this Service. Common StatusCodes are defined in Table 178.

Table 76 – DeleteMonitoredItems Service Result Codes
Symbolic IdDescription
Bad_NothingToDoSee Table 178 for the description of this result code.
Bad_TooManyOperationsSee Table 178 for the description of this result code.
Bad_SubscriptionIdInvalidSee Table 178 for the description of this result code.
5.13.6.4 StatusCodes

Table 77 defines values for the results parameter that are specific to this Service. Common StatusCodes are defined in Table 179.

Table 77 – DeleteMonitoredItems Operation Level Result Codes
Symbolic IdDescription
Bad_MonitoredItemIdInvalidSee Table 179 for the description of this result code.