Cost

Defines a set of meter cost information that specifies the metered state of a subscriber's connection to a Mobile Network Operator (MNO). Cost is the unique root element for DUSM cost information.

Element hierarchy

<Cost>

Syntax

<Cost OverDataLimit? = boolean
      Congested?     = boolean
      PlanType       = "Unrestricted" | "Fixed" | "Variable" >

  <!-- Child elements -->
  UsageInMegabytes?,
  DataLimitInMegabytes?,
  BillingCycle?,
  BandwidthInKbps?,
  MaxDownloadFileSizeInMegabytes?,
  CarrierPolicy?

</Cost>

Key

?   optional (zero or one)

Attributes and Elements

Attributes

Attribute Description Data type Required Default value
Congested

If true, the subscriber's connection is in a state of congestion. Otherwise, it is either not supported by the MNO or false.

boolean No
OverDataLimit

If true, the subscriber's connection is in an Over The Data Limit state. Otherwise, it is either not supported by the MNO or false.

boolean No
PlanType

Defines the data usage of the subscriber's connection:

Unrestricted - the connection is unlimited and is considered to be unrestricted of usage charges and capacity constraints. Fixed - the use of this connection is unrestricted up to a certain cap. Variable - this connection is costed on a per byte basis.

This attribute can have one of the following values:

  • Unrestricted
  • Fixed
  • Variable
Yes

 

Child Elements

Child Element Description
BandwidthInKbps

Defines a value representing the effective link speed of the subscriber’s connection specified in Kbps. Must be a value from 0 to 232nd.

BillingCycle

Defines the plan's starting date and time, its duration, and what happens at the end of the billing cycle.

CarrierPolicy

Defines optional setting for Windows on this connection.

DataLimitInMegabytes

Defines a value representing the data limit in MB for a capped plan. Must be a value from 0 to 232nd.

MaxDownloadFileSizeInMegabytes

Defines a value representing the maximum suggested download size in MB of the subscriber's connection. Must be a value from 0 to 232nd.

UsageInMegabytes

Defines a value representing the data used to-date within the current billing cycle in MB. Must be a value from 0 to 232nd.

 

Parent Elements

This outermost (document) element may not be contained by any other elements.

Requirements

Value
Namespace http://www.microsoft.com/networking/CarrierControl/DUSM/v1