Cisco Cisco Meeting Server 2000 开发者指南

下载
页码 147
Cisco Meeting Server Release 2.0 : API Reference Guide
14
2 General Structure of Methods
Note: Although the Cisco Meeting App and other Cisco Meeting Server guides refer to
"spaces" rather than "coSpaces", the API still uses /coSpace objects.
Conceptually, the API methods are designed to work on a hierarchical tree of objects. For
example, each configured coSpace exists as a node in this tree, and all of the users who are
members of that coSpace exist as nodes “beneath” the coSpace object’s node.
In order to work within the environs of the Meeting Server’s high capacity in terms of the
potentially large number of active calls and coSpaces, it is important that the methods
supported do not require the entire collection of active objects of any particular type to be able
to be retrieved in a single response. For this reason, rather than returning such an oversized data
set in a single response, responses typically return the first “N” matching entries and a count of
the total number of objects of that type. In order to find a specific object for further methods
(for example, for the purposes of a deeper dive into an individual object’s active status, or to
modify or delete it) filters can be applied to the initial retrieval in order to identify the object in
question. Refer to
for more information on filters and the GET command.
2.1 Object Hierarchy
The hierarchy of objects addressable via the API is:
/accessQuery
/callBrandingProfiles 
/callBrandingProfiles/<call branding profile id> 
/callBridges 
/callBridges/<call bridge id>
/calls
/calls/<call id>
/calls/<call id>/callLegs
/calls/<call id>/diagnostics
/calls/<call id>/participants
/callProfiles
/callProfiles/<call profile id>
/callLegs
/callLegs/<callLeg id>
/callLegs/<callLeg id>/callLegProfileTrace
/callLegProfiles
/callLegProfiles/<call leg profile id>
/callLegProfiles/<call leg profile id>/usage
2   General Structure of Methods