Endpoint represents the logical manifestation of the terminal of a connection (i.e. a location identified by an address). Endpoint reflects its status as ON_LINE, OFF_LINE, or UNKOWN. In addition Endpoint carries the associated Credentials and network information (e.g. accessNetworkInfo). Endpoints are provisionable and clonable.

An Endpoint may have zero or more StatusSubscriptions. Each subscription may belong to a single Endpoint.
Constraints:
- see StatusSubscription constraints
Default:
- none
Clone:
- yes, deep. The Endpoint references a deep clone of the associated StatusSubscription

An Endpoint may have an AuthenticationContext. An AuthenticationContext defines the authentication parameters for a single Endpoint.
Constraints:
- see AuthenticationContext constraints
Default:
- none
Clone:
- no, the AuthenticationContext must be supplied by the provisioner

An Endpoint is uniquely identified by a exactly one Address. In addition, an Address uniquely identifies at most one Endpoint. In practice the value of the Endpoint is dependent on the Endpoint.type. For CELLULAR, DID_AIN, and PSTN the address is the RoutableNumber associated with the Endpoint. For PBX Endpoints the address is the PBX extension. Finally, the address attribute represents the user part of the URI for DIRECT Endpoints. In practice, the user part of the DIRECT URI is always a RoutableNumber.
Constraints:
- must be unique across all Devices
- must be unique across Endpoint types of multi-mode devices. I.e. A multi-mode device may have multiple Endpoints with the same address only if each Endpoint has a different endpointType.
--> constraint deferred to future release: must be unique across all service invocation numbers (personal and global)
- see RoutableNumber constraints
- see URI user part constraints
Default:
- none
Clone:
- no, this attribute must be unique and must be supplied by the provisioner

Nested Class Summary
public class	Type
public class	Status

Field Summary
private transient String	accessNetworkInfo
private Address	address
private AuthenticationContext	authenticationContext
private transient String	contact
private Type	endpointType
private transient String	miscNetworkInfo
private boolean	ringingEnabled
private transient Status	status
Status	OFF_LINE
Status	ON_LINE
Status	UNKNOWN
private StatusSubscription	statusSubscription
private boolean	statusTrackingEnabled
Type	CELLULAR
Type	DID_AIN
Type	DIRECT
Type	PBX
Type	PSTN
private transient String	visitedNetworkId
private boolean	voiceMailEnabled

accessNetworkInfo relates information regarding the network through which the Endpoint may be accessed. This information is provided at Endpoint status registration time.
Constraints:
- .{1,256}
Default:
- none
Clone:
- no, this is not a provisionable attribute (runtime only)

contact represents the address contents of the Contact header included in the SIP based Endpoint registration used in subsequent communications with the device.
Constraints:
- .{1,256}
Default:
- none
Clone:
- no, this is not a provisionable attribute (runtime only)

Endpoint endpointType describes the endpointType of Endpoint. Type is used to validate that the associated Domain is valid by ensuring that the Domain is of the same endpointType as the Endpoint. The following endpointType values are valid:
- PSTN: indicates that the Endpoint is in a PSTN network (or network with basic functionality)
- CELLULAR: indicates that the Endpoint is in a CELLULAR network
- DIRECT: indicates that the Endpoint is in a WiFi network (with SIP registration)
- DID_AIN: indicates that the Endpoint is behind an AIN PBX reachable with DID
- PBX: indicates that the Endpoint is serviced by an IP PBX
Constraints:
- "PSTN" | "CELLULAR" | "DIRECT" | "DID_AIN" | "PBX" | null
Defaults:
- none
Clone:
- yes, verbatim

miscNetworkInfo represents other miscelaneous network information provided at Endpoint status registration time.
Constraints:
- .{1,256}
Default:
- none
Clone:
- no, this is not a provisionable attribute (runtime only)

ringingEnabled indicates whether (TRUE) the Endpoint should be included in subscriber termination case such as simring and ringing profiles or (FALSE) that the Endpoint should not be alerted in subscriber termination cases.
For Endpoints of Devices whos origin is SUBSCRIBER the ringEnabled=false case indicates that the CSN should handle originations from the Endpoint. As such it is restricted for use with the One Button Transfer feature.
Constraints:
- true | false
Default:
- true
Clone:
- yes, verbatim

status represents the Endpoint's current reachability as ON_LINE (available/reachable), OFF_LINE (unavailable, not reachable) or UNKNOWN.
Constraints:
- "ON_LINE" | "OFF_LINE" | "UNKNOWN"
Default:
- "UNKNOWN"
Clone:
- no, this is not a provisionable attribute (runtime only)

statusTrackingEnabled flag indicates whether (TRUE) the CSN expects
status information for the Endpoint. In release 3.5, status tracking is
provided through SIP registration and SIP subscribe/notify mechanisms.
Constraints:
- must be true or false
- must be true if statusSubscription is not null
Default:
- false
Clone:
- yes, verbatim

visitedNetworkId represents the identity of the visited network in which the Endpoint resides provided at Endpoint status registration time.
Constraints:
- .{1,256}
Default:
- none
Clone:
- no, this is not a provisionable attribute (runtime only)

voiceMailEnabled indicates whether (TRUE) the Endpoint is associated with a voice mail system or (FALSE) the Endpoint is NOT associated with a voice mail system. The implication of voice mail association is that calls directed to the Endpoint my be answered by the voice mail system (e.g. if the Subscriber does not answer or forwarding is enabled).
Constraints:
- true | false
Default:
- false
Clone:
- yes, verbatim