This Serviceis used to remove one or more MonitoredItemsof a Subscription. When a MonitoredItemis deleted, its triggered item links are also deleted.
Successful removal of a MonitoredItem, however, might not remove Notificationsfor the MonitoredItemthat are in the process of being sent by the Subscription. Therefore, Clientsmay receive Notificationsfor the MonitoredItemafter they have received a positive response that the MonitoredItemhas been deleted.
Table 81defines the parameters for the Service.
Table 81– DeleteMonitoredItems Service Parameters
|
Name |
Type |
Description |
|
Request |
|
|
|
requestHeader |
RequestHeader |
Common request parameters (see 7.33for RequestHeaderdefinition). |
|
subscriptionId |
IntegerId |
The Server-assigned identifier for the Subscriptionthat contains the MonitoredItemsto be deleted (see 7.19for IntegerIddefinition). |
|
monitoredItemIds [] |
IntegerId |
List of Server-assigned ids for the MonitoredItemsto be deleted. |
|
|
|
|
|
Response |
|
|
|
responseHeader |
Response Header |
Common response parameters (see 7.34for ResponseHeaderdefinition). |
|
results [] |
StatusCode |
List of StatusCodesfor the MonitoredItemsto delete (see 7.39for StatusCodedefinition). The size and order of the list matches the size and order of the monitoredItemIdsrequest parameter. |
|
diagnosticInfos [] |
DiagnosticInfo |
List of diagnostic information for the MonitoredItemsto delete (see 7.12for DiagnosticInfo definition). The size and order of the list matches the size and order of the monitoredItemIdsrequest 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. |
Table 82defines the Serviceresults specific to this Service. Common StatusCodesare defined in Table 182.
Table 82– DeleteMonitoredItems Service Result Codes
|
Symbolic Id |
Description |
|
Bad_NothingToDo |
See Table 182for the description of this result code. |
|
Bad_TooManyOperations |
See Table 182for the description of this result code. |
|
Bad_SubscriptionIdInvalid |
See Table 182for the description of this result code. |
Table 83defines values for the resultsparameter that are specific to this Service. Common StatusCodesare defined in Table 183.
Table 83– DeleteMonitoredItems Operation Level Result Codes
|
Symbolic Id |
Description |
|
Bad_MonitoredItemIdInvalid |
See Table 183for the description of this result code. |