getSubservicesForSubscription()

getSubservicesForSubscription(string usn)

This method returns a list of subservices for a specified subscription.

Parameters

usn: Format: string; Purpose: Specifies the USN of the subscription to retrieve subservices for.

Results

This method returns a SubserviceList containing zero or more Subservice objects corresponding to subservices for the given subscription.

There are no messages defined by this method.

Example: A returned SubserviceList XML document

This example shows a SubserviceList XML document for subscription 9796932323.

<SubserviceList xmlns="http://xml.inomial.com/smile/2.xsd">
  <Subservice>
    <SSID>2323</SSID>
    <SubscriptionUSN>9796932323</SubscriptionUSN>
    <Active>true</Active>
    <SubserviceUsername>joe@example.com</SubserviceUsername>
    <Object>
      <String name="type">emailAlias</String>
      <String name="forwardTo">admin@example.com</String>
    </Object>
  </Subservice>
  <Subservice>
    <SSID>2324</SSID>
    <SubscriptionUSN>9796932323</SubscriptionUSN>
    <Active>true</Active>
    <SubserviceUsername>mary@example.com</SubserviceUsername>
    <Object>
      <String name="type">emailAlias</String>
      <String name="forwardTo">admin@example.com</String>
    </Object>
  </Subservice>
  <Subservice>
    <SSID>2326</SSID>
    <SubscriptionUSN>9796932323</SubscriptionUSN>
    <Active>true</Active>
    <SubserviceUsername>alice@example.com</SubserviceUsername>
    <Object>
      <String name="type">webHostAlias</String>
      <String name="redirectFrom">alice@example.com</String>
      <String name="redirectTo">admin@example.com</String>
    </Object>
  </Subservice>
</SubserviceList>

Faults

NoSuchItemException

This fault is returned when the USN provided does not correspond to an existing subscription in the database.

Java client syntax

java -cp build/smilewsv2-client.jar [options]
 com.inomial.smile.client.v2.examples.GetSubservicesForSubscription usn

usn: Purpose: Specifies the USN of the subscription.

Note: For more information about the Java client and the options it accepts, see Java client syntax.