findMpnSubscription method

Future<MpnSubscription?> findMpnSubscription(String subscriptionId)

Inquiry method that returns the MpnSubscription with the specified subscription ID, or null if not found.

The object returned by this method can be an object created by the user, via MpnSubscription constructors, or an object created by the client, to represent pre-existing MPN subscriptions.
Note that objects returned by this method may be substitutued at any time with equivalent ones: do not rely on pointer matching, instead rely on the MpnSubscription.getSubscriptionId value to verify the equivalence of two MpnSubscription objects. Substitutions may happen when an MPN subscription is modified, or when it is coalesced with a pre-existing subscription.

General Edition Note MPN is an optional feature, available depending on Edition and License Type. To know what features are enabled by your license, please see the License tab of the Monitoring Dashboard (by default, available at /dashboard).

• subscriptionId The subscription ID to search for.

Returns the MpnSubscription with the specified ID, or null if not found.

Throws IllegalArgumentException if the given subscription ID is null.

Throws IllegalStateException if there is no MPN device registered.

• See getMpnSubscriptions

Implementation

Future<MpnSubscription?> findMpnSubscription(String subscriptionId) async {
  var arguments = <String, dynamic>{
    'subscriptionId': subscriptionId
  };
  return await NativeBridge.instance.client_findMpnSubscription(_id, arguments);
}