OSID - osid.provisioning.ProvisioningManager Service Interface Definition

Interface	osid.provisioning.ProvisioningManager
Implements	`osid.OsidManager`
Implements	`osid.provisioning.ProvisioningProfile`
Description	The provisioning manager provides access to provisioning sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `MyProvisionSession:` a session for looking up queue information for authenticated agent `MySupplierSession:` a session for looking up pool information for authenticated agent `MyProvisionNotificationSession:` a session for subscribing to provision changes for authenticated agent `ProvisionLookupSession:` a session to retrieve provisions `ProvisionQuerySession:` a session to query for provisionss `ProvisionSearchSession:` a session to search for provisions `ProvisionAdminSession:` a session to create and delete provisions `ProvisionNotificationSession:` a session to receive notifications pertaining to provision changes `ProvisionDistributorSession:` a session to look up provision distributor mappings `ProvisionDistributorAssignmentSession:` a session to manage provision to distributor mappings `ProvisionSmartDistributorSession:` a session to manage dynamic distributors of provisions `ProvisionReturnSession:` a session to return provisions `QueueLookupSession:` a session to retrieve queues `QueueQuerySession:` a session to query for queues `QueueSearchSession:` a session to search for queues `QueueAdminSession:` a session to create and delete queues `QueueNotificationSession:` a session to receive notifications pertaining to queue changes `QueueDistributorSession:` a session to look up queue distributor mappings `QueueDistributorAssignmentSession:` a session to manage queue to distributor mappings `QueueSmartDistributorSession:` a session to manage dynamic distributors of queues `RequestLookupSession:` a session to retrieve requests `RequestQuerySession:` a session to query for requests `RequestSearchSession:` a session to search for requests `RequestAdminSession:` a session to create and delete requests `RequestNotificationSession:` a session to receive notifications pertaining to request changes `RequestDistributorSession:` a session to look up request distributor mappings `RequestDistributorAssignmentSession:` a session to manage request to distributor mappings `RequestSmartDistributorSession:` a session to manage dynamic distributors of requests `RequestTransactionLookupSession:` a session to retrieve request transactions `RequestTransactionAdminSession:` a session to create and delete request transactions `ExchangeSession:` a session to exchange provisions `PoolLookupSession:` a session to retrieve pools `PoolQuerySession:` a session to query for pools `PoolSearchSession:` a session to search for pools `PoolAdminSession:` a session to create and delete pools `PoolNotificationSession:` a session to receive notifications pertaining to pool changes `PoolDistributorSession:` a session to look up pool distributor mappings `PoolDistributorAssignmentSession:` a session to manage pools to distributor mappings `PoolSmartDistributorSession:` a session to manage dynamic distributors of pools `ProvisionableLookupSession:` a session to retrieve provisionables `ProvisionableQuerySession:` a session to query for provisionables `ProvisionableSearchSession:` a session to search for provisionables `ProvisionableAdminSession:` a session to create and delete provisionables `ProvisionableNotificationSession:` a session to receive notifications pertaining to provisionable changes `ProvisionableDistributorsSession:` a session to look up provisionable distributors mappings `ProvisionableDistributorAssignmentSession:` a session to manage provisionable to distributor mappings `ProvisionableSmartDistributorSession:` a session to manage dynamic distributors of provisionables `BrokerLookupSession:` a session to retrieve brokers `BrokerQuerySession:` a session to query for brokers `BrokerSearchSession:` a session to search for brokers `BrokerAdminSession:` a session to create and delete brokers `BrokerNotificationSession:` a session to receive notifications pertaining to broker changes `BrokerDistributorSession:` a session to look up mappings of brokers to distributors `BrokerDistributorAssignmentSession:` a session to manage broker to distributor mappings `BrokerSmartDistributorSession:` a session to manage dynamic distributors of brokers `DistributorLookupSession:` a session to retrieve distributors `DistributorQuerySession:` a session to search for distributors `DistributorSearchSession:` a session to search for distributors `DistributorAdminSession:` a session to create and delete distributors `DistributorNotificationSession:` a session to receive notifications pertaining to distributor changes `DistributorHierarchySession:` a session to traverse a hierarchy of distributor `DistributorHierarchyDesignSession:` a session to manage a distributor hierarchy
Method	getMyProvisionSession
Description	Gets the `OsidSession` associated with the my provision service.
Return	`osid.provisioning.MyProvisionSession`		a `MyProvisionSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsMyProvision()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMyProvision()` is `true.`
Method	getMyProvisionSessionForDistributor
Description	Gets the `OsidSession` associated with the my provision service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the distrivutor
Return	`osid.provisioning.MyProvisionSession`		a `MyProvisionSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distriobutor` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsMyProvision()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMyProvision()` and `supportsVisibleFederation()` are `true`
Method	getMySupplierSession
Description	Gets the `OsidSession` associated with the my supplier service.
Return	`osid.provisioning.MySupplierSession`		a `MySupplierSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsMySupplier()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMySupplier()` is `true.`
Method	getMySupplierSessionForDistributor
Description	Gets the `OsidSession` associated with the my Supplier service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the distrivutor
Return	`osid.provisioning.MySupplierSession`		a `MySupplierSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distriobutor` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsMySupplier()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMySupplier()` and `supportsVisibleFederation()` are `true`
Method	getMyProvisionNotificationSession
Description	Gets the `OsidSession` associated with the provision notification service for resources related to the authentciated agent.
Parameters	`osid.provisioning.ProvisionReceiver`	`provisionReceiver`	the notification callback
Return	`osid.provisioning.MyProvisionNotificationSession`		a `MyProvisionNotificationSession`
Errors	NULL_ARGUMENT		`provisionReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsMyProvisionNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMyProvisionNotification()` is `true.`
Method	getMyProvisionNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the provision notification service for the given distributor for resources related to the authentciated agent.
Parameters	`osid.provisioning.ProvisionReceiver`	`provisionReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.MyProvisionNotificationSession`		a `MyProvisionNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`provisionReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsMyProvisionNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsMyProvisionNotification()` and `supportsVisibleFederation()` are `true`
Method	getProvisionLookupSession
Description	Gets the `OsidSession` associated with the provision lookup service.
Return	`osid.provisioning.ProvisionLookupSession`		a `ProvisionLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionLookup()` is `true.`
Method	getProvisionLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the provision lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionLookupSession`		a `ProvisionLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionLookup()` and `supportsVisibleFederation()` are `true`
Method	getProvisionQuerySession
Description	Gets the `OsidSession` associated with the provision query service.
Return	`osid.provisioning.ProvisionQuerySession`		a `ProvisionQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionQuery()` is `true.`
Method	getProvisionQuerySessionForDistributor
Description	Gets the `OsidSession` associated with the provision query service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionQuerySession`		a `ProvisionQuerySession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionQuery()` and `supportsVisibleFederation()` are `true`
Method	getProvisionSearchSession
Description	Gets the `OsidSession` associated with the provision search service.
Return	`osid.provisioning.ProvisionSearchSession`		a `ProvisionSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionSearch()` is `true.`
Method	getProvisionSearchSessionForDistributor
Description	Gets the `OsidSession` associated with the provision search service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionSearchSession`		a `ProvisionSearchSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionSearch()` and `supportsVisibleFederation()` are `true`
Method	getProvisionAdminSession
Description	Gets the `OsidSession` associated with the provision administration service.
Return	`osid.provisioning.ProvisionAdminSession`		a `ProvisionAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionAdmin()` is `true.`
Method	getProvisionAdminSessionForDistributor
Description	Gets the `OsidSession` associated with the provision administration service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionAdminSession`		a `ProvisionAdminSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionAdmin()` and `supportsVisibleFederation()` are `true`
Method	getProvisionNotificationSession
Description	Gets the `OsidSession` associated with the provision notification service.
Parameters	`osid.provisioning.ProvisionReceiver`	`provisionReceiver`	the notification callback
Return	`osid.provisioning.ProvisionNotificationSession`		a `ProvisionNotificationSession`
Errors	NULL_ARGUMENT		`provisionReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionNotification()` is `true.`
Method	getProvisionNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the provision notification service for the given distributor.
Parameters	`osid.provisioning.ProvisionReceiver`	`provisionReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionNotificationSession`		a `ProvisionNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`provisionReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionNotification()` and `supportsVisibleFederation()` are `true`
Method	getProvisionDistributorSession
Description	Gets the `OsidSession` to lookup provision/distributor mappings.
Return	`osid.provisioning.ProvisionDistributorSession`		a `ProvisionDistributorSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionDistributor()` is `true.`
Method	getProvisionDistributorAssignmentSession
Description	Gets the `OsidSession` associated with assigning provisions to distributors.
Return	`osid.provisioning.ProvisionDistributorAssignmentSession`		a `ProvisionDistributorAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionDistributorAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionDistributorAssignment()` is `true.`
Method	getProvisionSmartDistributorSession
Description	Gets the `OsidSession` to manage provision smart distributors.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionDistributorSession`		a `ProvisionSmartDistributorSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionSmartDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionSmartDistributor()` is `true.`
Method	getProvisionReturnSession
Description	Gets the `OsidSession` associated with the provision return service.
Return	`osid.provisioning.ProvisionReturnSession`		a `ProvisionReturnSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionReturn()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionReturn()` is `true.`
Method	getProvisionReturnSessionForDistributor
Description	Gets the `OsidSession` associated with the provision return service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.ProvisionReturnSession`		a `ProvisionReturnSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionReturn()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionReturn()` and `supportsVisibleFederation()` are `true`
Method	getQueueLookupSession
Description	Gets the `OsidSession` associated with the queue lookup service.
Return	`osid.provisioning.QueueLookupSession`		a `QueueLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsQueueLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueLookup()` is `true.`
Method	getQueueLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the queue lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.QueueLookupSession`		a `QueueLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueLookup()` and `supportsVisibleFederation()` are `true`
Method	getQueueQuerySession
Description	Gets the `OsidSession` associated with the queue query service.
Return	`osid.provisioning.QueueQuerySession`		a `QueueQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsQueueQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueQuery()` is `true.`
Method	getQueueQuerySessionForDistributor
Description	Gets the `OsidSession` associated with the queue query service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.QueueQuerySession`		a `QueueQuerySession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueQuery()` and `supportsVisibleFederation()` are `true`
Method	getQueueSearchSession
Description	Gets the `OsidSession` associated with the queue search service.
Return	`osid.provisioning.QueueSearchSession`		a `QueueSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsQueueSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueSearch()` is `true.`
Method	getQueueSearchSessionForDistributor
Description	Gets the `OsidSession` associated with the queue search service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.QueueSearchSession`		a `QueueSearchSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueSearch()` and `supportsVisibleFederation()` are `true`
Method	getQueueAdminSession
Description	Gets the `OsidSession` associated with the queue administration service.
Return	`osid.provisioning.QueueAdminSession`		a `QueueAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsQueueAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueAdmin()` is `true.`
Method	getQueueAdminSessionForDistributor
Description	Gets the `OsidSession` associated with the queue administration service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.QueueAdminSession`		a `QueueAdminSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueAdmin()` and `supportsVisibleFederation()` are `true`
Method	getQueueNotificationSession
Description	Gets the `OsidSession` associated with the queue notification service.
Parameters	`osid.provisioning.QueueReceiver`	`queueReceiver`	the notification callback
Return	`osid.provisioning.QueueNotificationSession`		a `QueueNotificationSession`
Errors	NULL_ARGUMENT		`queueReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueNotification()` is `true.`
Method	getQueueNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the queue notification service for the given distributor.
Parameters	`osid.provisioning.QueueReceiver`	`queueReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.QueueNotificationSession`		a `QueueNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`queueReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueNotification()` and `supportsVisibleFederation()` are `true`
Method	getQueueDistributorSession
Description	Gets the `OsidSession` to lookup queue/distributor mappings.
Return	`osid.provisioning.QueueDistributorSession`		a `QueueDistributorSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsQueueDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueDistributor()` is `true.`
Method	getQueueDistributorAssignmentSession
Description	Gets the `OsidSession` associated with assigning queues to distributors.
Return	`osid.provisioning.QueueDistributorAssignmentSession`		a `QueueDistributorAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsQueueDistributorAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueDistributorAssignment()` is `true.`
Method	getQueueSmartDistributorSession
Description	Gets the `OsidSession` to manage queue smart distributors.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the distributor
Return	`osid.provisioning.QueueSmartDistributorSession`		a `QueueSmartDistributorSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsQueueSmartDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsQueueSmartDistributor()` is `true.`
Method	getRequestLookupSession
Description	Gets the `OsidSession` associated with the request lookup service.
Return	`osid.provisioning.RequestLookupSession`		a `RequestLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestLookup()` is `true.`
Method	getRequestLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the request lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestLookupSession`		a `RequestLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestLookup()` and `supportsVisibleFederation()` are `true`
Method	getRequestQuerySession
Description	Gets the `OsidSession` associated with the request query service.
Return	`osid.provisioning.RequestQuerySession`		a `RequestQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestQuery()` is `true.`
Method	getRequestQuerySessionForDistributor
Description	Gets the `OsidSession` associated with the request query service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestQuerySession`		a `CRequestQuerySession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestQuery()` and `supportsVisibleFederation()` are `true`
Method	getRequestSearchSession
Description	Gets the `OsidSession` associated with the request search service.
Return	`osid.provisioning.RequestSearchSession`		a `RequestSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestSearch()` is `true.`
Method	getRequestSearchSessionForDistributor
Description	Gets the `OsidSession` associated with the request search service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestSearchSession`		a `RequestSearchSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestSearch()` and `supportsVisibleFederation()` are `true`
Method	getRequestAdminSession
Description	Gets the `OsidSession` associated with the request administrative service.
Return	`osid.provisioning.RequestAdminSession`		a `RequestAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestAdmin()` is `true.`
Method	getRequestAdminSessionForQueue
Description	Gets the `OsidSession` associated with the request administrative service for the given queue.
Parameters	`osid.id.Id`	`queueId`	the `Id` of the `Queue`
Return	`osid.provisioning.RequestAdminSession`		a `RequestAdminSession`
Errors	NOT_FOUND		no `Queue` found by the given `Id`
	NULL_ARGUMENT		`queueId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestAdmin()` and `supportsVisibleFederation()` are `true`
Method	getRequestNotificationSession
Description	Gets the `OsidSession` associated with the request notification service.
Parameters	`osid.provisioning.RequestReceiver`	`requestReceiver`	the notification callback
Return	`osid.provisioning.RequestNotificationSession`		a `RequestNotificationSession`
Errors	NULL_ARGUMENT		`requestReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestNotification()` is `true.`
Method	getRequestNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the request notification service for the given distributor.
Parameters	`osid.provisioning.RequestReceiver`	`requestReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestNotificationSession`		a `RequestNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`requestReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestNotification()` and `supportsVisibleFederation()` are `true`
Method	getRequestDistributorSession
Description	Gets the `OsidSession` to lookup request/distributor mappings.
Return	`osid.provisioning.RequestDistributorSession`		a `RequestDistributorSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestyDistributor()` is `true.`
Method	getRequestDistributorAssignmentSession
Description	Gets the `OsidSession` associated with assigning queues to distributors.
Return	`osid.provisioning.RequestDistributorAssignmentSession`		a `RequestyDistributorAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestDistributorAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestDistributorAssignment()` is `true.`
Method	getRequestSmartDistributorSession
Description	Gets the `OsidSession` to manage request smart distributors.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestSmartDistributorSession`		a `RequestSmartDistributorSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestSmartDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestSmartDistributor()` is `true.`
Method	getRequestTransactionLookupSession
Description	Gets the `OsidSession` associated with the request transaction lookup service.
Return	`osid.provisioning.RequestTransactionLookupSession`		a `RequestTransactionLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestTransactionLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestTransactionLookup()` is `true.`
Method	getRequestTransactionLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the request transaction lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestTransactionLookupSession`		a `RequestTransactionLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestTransactionLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestTransactionLookup()` and `supportsVisibleFederation()` are `true`
Method	getRequestTransactionAdminSession
Description	Gets the `OsidSession` associated with the request transaction administrative service.
Return	`osid.provisioning.RequestTransactionAdminSession`		a `RequestTransactionAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRequestTransactionAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestTransactionAdmin()` is `true.`
Method	getRequestTransactionAdminSessionForDistributor
Description	Gets the `OsidSession` associated with the request transaction administrative service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestTransactionAdminSession`		a `RequestTransactionAdminSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRequestTransactionAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRequestTransactionAdmin()` and `supportsVisibleFederation()` are `true`
Method	getExchangeSession
Description	Gets the `OsidSession` associated with the exchange service.
Return	`osid.provisioning.ExchangeSession`		an `ExchangeSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsExchange()` is `false`
Compliance	`optional`		This method must be implemented if `supportsExchange()` is `true.`
Method	getExchangeSessionForQueue
Description	Gets the `OsidSession` associated with the exchange service for the given queue.
Parameters	`osid.id.Id`	`queueId`	the `Id` of the `Queue`
Return	`osid.provisioning.ExchangeSession`		an `ExchangeSession`
Errors	NOT_FOUND		no `Queue` found by the given `Id`
	NULL_ARGUMENT		`queueId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsExchange()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsExchange()` and `supportsVisibleFederation()` are `true`
Method	getPoolLookupSession
Description	Gets the `OsidSession` associated with the pool lookup service.
Return	`osid.provisioning.PoolLookupSession`		a `PoolLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPoolLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolLookup()` is `true.`
Method	getPoolLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the pool lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.PoolLookupSession`		a `PoolLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolLookup()` and `supportsVisibleFederation()` are `true`
Method	getPoolQuerySession
Description	Gets the `OsidSession` associated with the pool query service.
Return	`osid.provisioning.PoolQuerySession`		a `PoolQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPoolQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolQuery()` is `true.`
Method	getPoolQuerySessionForDistributor
Description	Gets the `OsidSession` associated with the pool query service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.PoolQuerySession`		a `PoolQuerySession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolQuery()` and `supportsVisibleFederation()` are `true`
Method	getPoolSearchSession
Description	Gets the `OsidSession` associated with the pool search service.
Return	`osid.provisioning.PoolSearchSession`		a `PoolSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPoolSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolSearch()` is `true.`
Method	getPoolSearchSessionForDistributor
Description	Gets the `OsidSession` associated with the pool search service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.PoolSearchSession`		a `PoolSearchSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolSearch()` and `supportsVisibleFederation()` are `true`
Method	getPoolAdminSession
Description	Gets the `OsidSession` associated with the pool administration service.
Return	`osid.provisioning.PoolAdminSession`		a `PoolAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPoolAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolAdmin()` is `true.`
Method	getPoolAdminSessionForDistributor
Description	Gets the `OsidSession` associated with the pool administration service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.PoolAdminSession`		a `PoolAdminSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolAdmin()` and `supportsVisibleFederation()` are `true`
Method	getPoolNotificationSession
Description	Gets the `OsidSession` associated with the pool notification service.
Parameters	`osid.provisioning.PoolReceiver`	`poolReceiver`	the notification callback
Return	`osid.provisioning.PoolNotificationSession`		a `PoolNotificationSession`
Errors	NULL_ARGUMENT		`poolReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolNotification()` is `true.`
Method	getPoolNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the pool notification service for the given distributor.
Parameters	`osid.provisioning.PoolReceiver`	`poolReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.PoolNotificationSession`		a `PoolNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`poolReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolNotification()` and `supportsVisibleFederation()` are `true`
Method	getPoolDistributorSession
Description	Gets the `OsidSession` to lookup pool/distributor mappings.
Return	`osid.provisioning.PoolDistributorSession`		a `PoolDistributorSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPoolDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolDistributor()` is `true.`
Method	getPoolDistributorAssignmentSession
Description	Gets the `OsidSession` associated with assigning pools to distributors.
Return	`osid.provisioning.PoolDistributorAssignmentSession`		a `PoolDistributorAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsPoolDistributorAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolDistributorAssignment()` is `true.`
Method	getPoolSmartDistributorSession
Description	Gets the `OsidSession` to manage pool smart distributors.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.PoolSmartDistributorSession`		a `PoolSmartDistributorSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsPoolSmartDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsPoolSmartDistributor()` is `true.`
Method	getProvisionableLookupSession
Description	Gets the `OsidSession` associated with the provisionable lookup service.
Return	`osid.provisioning.RequestLookupSession`		a `ProvisionableLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionableLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableLookup()` is `true.`
Method	getProvisionableLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the provisionable lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the distributor
Return	`osid.provisioning.RequestLookupSession`		a `ProvisionableLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableLookup()` and `supportsVisibleFederation()` are `true`
Method	getProvisionableQuerySession
Description	Gets the `OsidSession` associated with the provisionable query service.
Return	`osid.provisioning.RequestQuerySession`		a `ProvisionableQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionableQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableQuery()` is `true.`
Method	getProvisionableQuerySessionForDistributor
Description	Gets the `OsidSession` associated with the provisionable query service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestQuerySession`		a `ProvisionableQuerySession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableQuery()` and `supportsVisibleFederation()` are `true`
Method	getProvisionableSearchSession
Description	Gets the `OsidSession` associated with the provisionable search service.
Return	`osid.provisioning.RequestSearchSession`		a `ProvisionableSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionableSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableSearch()` is `true.`
Method	getProvisionableSearchSessionForDistributor
Description	Gets the `OsidSession` associated with the provisionable search service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestSearchSession`		a `ProvisionableSearchSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableSearch()` and `supportsVisibleFederation()` are `true`
Method	getProvisionableAdminSession
Description	Gets the `OsidSession` associated with the provisionable administration service.
Return	`osid.provisioning.RequestAdminSession`		a `ProvisionableAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionableAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableAdmin()` is `true.`
Method	getProvisionableAdminSessionForPool
Description	Gets the `OsidSession` associated with the provisionable administration service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Dostributor`
Return	`osid.provisioning.RequestAdminSession`		a `ProvisionableAdminSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableAdmin()` and `supportsVisibleFederation()` are `true`
Method	getProvisionableNotificationSession
Description	Gets the `OsidSession` associated with the provisionable notification service.
Parameters	`osid.provisioning.RequestReceiver`	`provisionableReceiver`	the notification callback
Return	`osid.provisioning.RequestNotificationSession`		a `ProvisionableNotificationSession`
Errors	NULL_ARGUMENT		`provisionableReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableNotification()` is `true.`
Method	getProvisionableNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the provisionable notification service for the given distributor.
Parameters	`osid.provisioning.RequestReceiver`	`provisionableReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestNotificationSession`		a `ProvisionableNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`provisionableReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableNotification()` and `supportsVisibleFederation()` are `true`
Method	getProvisionableDistributorSession
Description	Gets the `OsidSession` to lookup provisionable/distributor mappings.
Return	`osid.provisioning.RequestDistributorSession`		a `ProvisionableDistributorSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionableDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableDistributor()` is `true.`
Method	getProvisionableDistributorAssignmentSession
Description	Gets the `OsidSession` associated with assigning provisionables to distributors.
Return	`osid.provisioning.RequestDistributorAssignmentSession`		a `ProvisionableDistributorAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisionableDistributorAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableDistributorAssignment()` is `true.`
Method	getProvisionableSmartDistributorSession
Description	Gets the `OsidSession` to manage locatin smart distributors.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.RequestSmartDistributorSession`		a `ProvisionableSmartDistributorSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsProvisionableSmartDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisionableSmartDistributor()` is `true.`
Method	getBrokerLookupSession
Description	Gets the `OsidSession` associated with the broker lookup service.
Return	`osid.provisioning.BrokerLookupSession`		a `BrokerLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBrokerLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerLookup()` is `true.`
Method	getBrokerLookupSessionForDistributor
Description	Gets the `OsidSession` associated with the broker lookup service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.BrokerLookupSession`		a `BrokerLookupSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerLookup()` and `supportsVisibleFederation()` are `true`
Method	getBrokerQuerySession
Description	Gets the `OsidSession` associated with the broker query service.
Return	`osid.provisioning.BrokerQuerySession`		a `BrokerQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBrokerQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerQuery()` is `true.`
Method	getBrokerQuerySessionForDistributor
Description	Gets the `OsidSession` associated with the broker query service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.BrokerQuerySession`		a `BrokerQuerySession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerQuery()` and `supportsVisibleFederation()` are `true`
Method	getBrokerSearchSession
Description	Gets the `OsidSession` associated with the broker search service.
Return	`osid.provisioning.BrokerSearchSession`		a `BrokerSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBrokerSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerSearch()` is `true.`
Method	getBrokerSearchSessionForDistributor
Description	Gets the `OsidSession` associated with the broker search service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.BrokerSearchSession`		a `BrokerSearchSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerSearch()` and `supportsVisibleFederation()` are `true`
Method	getBrokerAdminSession
Description	Gets the `OsidSession` associated with the broker administration service.
Return	`osid.provisioning.BrokerAdminSession`		a `BrokerAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBrokerAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerAdmin()` is `true.`
Method	getBrokerAdminSessionForDistributor
Description	Gets the `OsidSession` associated with the broker administration service for the given distributor.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.BrokerAdminSession`		a `BrokerAdminSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerAdmin()` and `supportsVisibleFederation()` are `true`
Method	getBrokerNotificationSession
Description	Gets the `OsidSession` associated with the broker notification service.
Parameters	`osid.provisioning.BrokerReceiver`	`brokerReceiver`	the notification callback
Return	`osid.provisioning.BrokerNotificationSession`		a `BrokerNotificationSession`
Errors	NULL_ARGUMENT		`brokerReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerNotification()` is `true.`
Method	getBrokerNotificationSessionForDistributor
Description	Gets the `OsidSession` associated with the broker notification service for the given distributor.
Parameters	`osid.provisioning.BrokerReceiver`	`brokerReceiver`	the notification callback
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.BrokerNotificationSession`		a `BrokerNotificationSession`
Errors	NOT_FOUND		no distributor found by the given `Id`
	NULL_ARGUMENT		`brokerReceiver` or `distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerNotification()` and `supportsVisibleFederation()` are `true`
Method	getBrokerDistributorSession
Description	Gets the `OsidSession` to lookup broker/distributor mappings.
Return	`osid.provisioning.BrokerDistributorSession`		a `BrokerDistributorSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBrokerDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerDistributor()` is `true.`
Method	getBrokerDistributorAssignmentSession
Description	Gets the `OsidSession` associated with assigning brokers to distributors.
Return	`osid.provisioning.BrokerDistributorAssignmentSession`		a `BrokerDistributorAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsBrokerDistributorAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerDistributorAssignment()` is `true.`
Method	getBrokerSmartDistributorSession
Description	Gets the `OsidSession` to manage broker smart distributors.
Parameters	`osid.id.Id`	`distributorId`	the `Id` of the `Distributor`
Return	`osid.provisioning.BrokerSmartDistributorSession`		a `BrokerSmartDistributorSession`
Errors	NOT_FOUND		no `Distributor` found by the given `Id`
	NULL_ARGUMENT		`distributorId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsBrokerSmartDistributor()` is `false`
Compliance	`optional`		This method must be implemented if `supportsBrokerSmartDistributor()` is `true.`
Method	getDistributorLookupSession
Description	Gets the `OsidSession` associated with the distributor lookup service.
Return	`osid.provisioning.DistributorLookupSession`		a `DistributorLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsDistributorLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorLookup()` is `true.`
Method	getDistributorQuerySession
Description	Gets the `OsidSession` associated with the distributor query service.
Return	`osid.provisioning.DistributorQuerySession`		a `DistributorQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsDistributorQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorQuery()` is `true.`
Method	getDistributorSearchSession
Description	Gets the `OsidSession` associated with the distributor search service.
Return	`osid.provisioning.DistributorSearchSession`		a `DistributorSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsDistributorSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorSearch()` is `true.`
Method	getDistributorAdminSession
Description	Gets the `OsidSession` associated with the distributor administrative service.
Return	`osid.provisioning.DistributorAdminSession`		a `DistributorAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsDistributorAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorAdmin()` is `true.`
Method	getDistributorNotificationSession
Description	Gets the `OsidSession` associated with the distributor notification service.
Parameters	`osid.provisioning.DistributorReceiver`	`distributorReceiver`	the notification callback
Return	`osid.provisioning.DistributorNotificationSession`		a `DistributorNotificationSession`
Errors	NULL_ARGUMENT		`distributorReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsDistributorNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorNotification()` is `true.`
Method	getDistributorHierarchySession
Description	Gets the `OsidSession` associated with the distributor hierarchy service.
Return	`osid.provisioning.DistributorHierarchySession`		a `DistributorHierarchySession` for distributors
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsDistributorHierarchy()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorHierarchy()` is `true.`
Method	getDistributorHierarchyDesignSession
Description	Gets the `OsidSession` associated with the distributor hierarchy design service.
Return	`osid.provisioning.DistributorHierarchyDesignSession`		a `HierarchyDesignSession` for distributors
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsDistributorHierarchyDesign()` is `false`
Compliance	`optional`		This method must be implemented if `supportsDistributorHierarchyDesign()` is `true.`
Method	getProvisioningBatchManager
Description	Gets the `ProvisioningBatchManager.`
Return	`osid.provisioning.batch.ProvisioningBatchManager`		a `ProvisioningBatchManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisioningBatch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisioningBatch()` is `true.`
Method	getProvisioningRulesManager
Description	Gets the `ProvisioningRulesManager.`
Return	`osid.provisioning.rules.ProvisioningRulesManager`		a `ProvisioningRulesManager`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsProvisioningRules()` is `false`
Compliance	`optional`		This method must be implemented if `supportsProvisioningRules()` is `true.`