Foreign Sources

RESTful service to the Horizon Provisioning Foreign Source definitions. Foreign source definitions are used to control the scanning (service detection) of services for SLA monitoring as well as the data collection settings for physical interfaces (resources).

This API supports CRUD operations for managing the provisioner’s foreign source definitions. Foreign source definitions are POSTed and will be deployed when the corresponding requisition gets imported/synchronized by Provisiond.

If a request says that it gets the "active" foreign source, that means it returns the pending foreign source (being edited for deployment) if there is one, otherwise it returns the deployed foreign source.

GETs (reading data)

Foreign Sources API GET functions
Resource	Description
/foreignSources	Get all active foreign sources.
/foreignSources/default	Get the active default foreign source.
/foreignSources/deployed	Get the list of all deployed (active) foreign sources.
/foreignSources/deployed/count	Get the number of deployed foreign sources (returns plaintext, rather than XML or JSON).
/foreignSources/{name}	Get the active foreign source named `{name}`.
/foreignSources/{name}/detectors	Get the configured detectors for the foreign source named `{name}`.
/foreignSources/{name}/detectors/{detector}	Get the specified detector for the foreign source named `{name}`.
/foreignSources/{name}/policies	Get the configured policies for the foreign source named `{name}`.
/foreignSources/{name}/policies/{policy}	Get the specified policy for the foreign source named `{name}`.

POSTs (adding data)

POST requires XML using application/xml as its Content-Type.

Foreign Sources API POST functions
Resource	Description
/foreignSources	Add a foreign source.
/foreignSources/{name}/detectors	Add a detector to the named foreign source.
/foreignSources/{name}/policies	Add a policy to the named foreign source.

PUT (modifying data)

PUT requires form data using application/x-www-form-urlencoded as a Content-Type.

Foreign Sources API PUT function
Resource	Description
/foreignSources/{name}	Modify a foreign source with the given name.

DELETEs (removing data)

Foreign Sources API DELETE functions
Resource	Description
/foreignSources/{name}	Delete the named foreign source.
/foreignSources/{name}/detectors/{detector}	Delete the specified detector from the named foreign source.
/foreignSources/{name}/policies/{policy}	Delete the specified policy from the named foreign source.