Understanding how web service calls work with your server architecture
The architecture of Infrastructure Management varies according to your Infrastructure Management setup. This section describes the architecture of Infrastructure Management for the following scenarios:
- Single BMC TrueSight Infrastructure Management Server installation
- Multiple BMC TrueSight Infrastructure Management Server installations
- Single BMC TrueSight Infrastructure Management Server installation with Single Sign-On integration
- Multiple BMC TrueSight Infrastructure Management Server installations with Single Sign-On integration
Single BMC TrueSight Infrastructure Management Server installation
The following figure shows the architecture of a single BMC TrueSight Infrastructure Management Server installation.
Infrastructure Management architecture for a single BMC TrueSight Infrastructure Management Server installation
For information about how the web service requests work, see Single BMC TrueSight Infrastructure Management Server.
Multiple BMC TrueSight Infrastructure Management Server installations
The following figure shows the architecture of multiple BMC TrueSight Infrastructure Management Server installations.
Infrastructure Management architecture for multiple BMC TrueSight Infrastructure Management Servers
For information about how the web service requests work, see Multiple Child Servers with a Central Server Router.
Single BMC TrueSight Infrastructure Management Server installation with Single Sign-On integration
The following figure shows the architecture of a single BMC TrueSight Infrastructure Management Server installation with Single Sign-On integration.
Infrastructure Management architecture for a single BMC TrueSight Infrastructure Management Server installation with Single Sign-On implementation
For information about how the web service requests work, see Single BMC TrueSight Infrastructure Management Server installation with BMC Atrium SSO integration, and for information about BMC Atrium SSO, see the BMC Atrium Single Sign-On Administrator's Guide.
Multiple BMC TrueSight Infrastructure Management Server installations with Single Sign-On integration
The following figure shows the architecture of multiple BMC TrueSight Infrastructure Management Server installations with Single Sign-On implementation.
Infrastructure Management architecture for multiple BMC TrueSight Infrastructure Management Servers with Single Sign-On implementation
For information about how the web service requests work, see Multiple Child Servers and a Central Server Router with BMC Atrium SSO integration, and for information about BMC Atrium SSO, see the BMC Atrium Single Sign-On Administrator's Guide.
REST-style architecture
Infrastructure Management conform to REST (Representational State Transfer) principles. REST architecture uses the HTTP or HTTPS protocol to send requests and JSON standards to receive responses.
A REST-based web service has three defined aspects:
- A base Uniform Resource Locator (URL)
- The Internet media type of the data supported by the web service. For Infrastructure Management, the Internet media type is JSON.
- A set of calls (POST, GET, PUT, and DELETE) supported by a RESTful web service
URL of a web service
A REST-based web service is accessed through a URL. The generic format of a Infrastructure Management web service URL is as follows:
http|https://<serverHost>:<port>/bppmws/api/<resourceType>/<resourceID>/action?<queryParam1>&<queryParam2>&...<queryParamn>
For information about accessing a web service, see Accessing Infrastructure Management.
JSON format
JSON is a text format that is completely language independent but uses conventions that are familiar to a programmer. Infrastructure Management provide responses in the JSON format.
For information about converting the input parameters to the JSON format, see JSON creator.
Set of calls supported by REST-based web services
A REST-based web service supports the following operations: