Getting started with Infrastructure Management
Infrastructure Management provide operations for a web service client to exchange events and data with Infrastructure Management. Features of Infrastructure Management include:
- Retrieving data from Infrastructure Management
- Managing CIs
- Generating events for Infrastructure Management and its integrations
- Managing SLO information
- Managing Central Monitoring Administration on a BMC TrueSight Infrastructure Management Server
- Retrieving details about Integration Services
Accessing Infrastructure Management
You can access each Infrastructure Management web service 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>
Entry | Description |
|---|---|
http|https | Type of protocol to send the request. Infrastructure Management support both HTTP and HTTPS protocols. |
serverHost | Host name of the BMC TrueSight Infrastructure Management Server |
port | Port number through which communication is established. The default port number is 80 if you use the HTTP protocol and 443 if you use the HTTPS protocol. |
resourceType | Type of resource that you want the web service to interact with. Infrastructure Management support the following resource types:
|
resourceID | Identifier of a specific resource that you want the web service to interact with. Infrastructure Management support the following resource identifiers:
Each web service supports specific resource identifiers, and the supported identifiers vary for each web service. |
action | Type of action that you want to perform using the web services |
queryParam1, queryParam2, queryParamn | Additional parameters that you want to provide in the request |
HTTP header error codes
HTTP error codes are displayed in the HTTP header. These error codes represent a broader category of the actual issue. For more granular details about the error, you must look at the JSON response error codes that are covered in each topic.
HTTP error codes for web services
Error code | Message | Description |
|---|---|---|
200 | Success | Your request was successful. |
203 | Non-Authoritative Information | Your request has generated a partial response. Contact your administrator for more information. |
400 | Bad Request | Your request has incorrect parameters or formatting errors. |
401 | Authentication failed. Invalid Username/Password OR Invalid/Expired Token. | The authentication credentials or the authentication token is incorrect, invalid, or not provided. |
403 | Access denied. You are not authorized to perform this operation. | Your authentication credentials are valid, but your user role is not authorized to access the resource. |
404 | Not Found | The resource is not found or does not exist. |
408 | Request Timeout | The server timed out waiting for the client's request. |
500 | Internal Server Error | There is some internal issue in BMC TrueSight Infrastructure Management Server. |
501 | Not Implemented | Either the server does not recognize your request method or it does not have the ability to implement your request. |
503 | Service Unavailable | The server is temporarily unable to process your request. It might be mostly due to server overload or unavailability. |