Common REST API data endpoints


This section contains information about the CRA data endpoints.

Important

You can submit any CRA data endpoint that uses the HTTP GET method by using a web browser such as Mozilla Firefox or Google Chrome; however, to submit the endpoint that uses the POST or DELETE method, you must use tools such as Swagger UI or Zowe. For more information, see Using-Swagger-to-access-the-BMC-Common-REST-API and Using-Zowe-to-access-the-BMC-Common-REST-API.

The base URL for this version of the Common REST API is:

https://<hostName>:<portNumber>/cra/

Important

Running CRA with HTTP poses a security vulnerability. We recommend running the component with HTTPS only.

Get service

Obtains a list of services that are registered to work with the API

{{status colour="Blue" title="GET"/}}

 /(% style="color: rgb(23,43,77);" %)serviceGateway/services

For more details, see Logging-in-to-a-service-using-the-Common-REST-API.


Update or add service

Updates or adds services to the configurations.json file

{{status subtle="false" colour="Green" title="POST"/}}

 /serviceGateway/services///<serviceName>///update
 

For more details, see Registering-services-with-the-Common-REST-API.


Delete service

Deletes a service

{{status colour="Red" title="Delete"/}}

 (% style="color: rgb(59,65,81);" %)/serviceGateway/services///<serviceName>///delete

For more details, see To delete a service.


Login

Logs into a service

Use one of the following URLs:

POST /serviceGateway/services/<serviceName>/login

POST /serviceGateway/services/<serviceName>/logon

For more details, see To log in to a BMC AMI Ops service.


Get view definition

Retrieves the definition for a specific view and returns the details as a JSON

GET

  /serviceGateway/services/products/<productName>/views/<viewName>/definitionFor more details, see Retrieving-a-view-definition-using-the-Common-REST-API.


Retrieve data

Retrieves the data for a specific view and returns the details as a JSON

GET /serviceGateway/services/products/<productName>/views/<viewName>/data

For more details, see Retrieving-view-data-using-the-Common-REST-API.


Get product

Retrieves the view data from the PLEXMGR/PLEX view and extracts the fields from the data to form the JSON returned by a successful request

{{status colour="Blue" title="GET"/}}

 /serviceGateway/services/products

For more details, see Retrieving-a-list-of-installed-products-using-the-Common-REST-API.


Get server details

Retrieves the server details and returns a JSON

{{status colour="Blue" title="GET"/}}  /serviceGateway/services/products/<productName>/servers

For more details, see Retrieving-server-details-using-the-Common-REST-API.


Get system details

Retrieves the system details and returns a JSON

{{status colour="Blue" title="GET"/}}  /serviceGateway/services/products/<productName>/systems

For more details, see Retrieving-system-details-using-the-Common-REST-API.


Get target details

Retrieves the target details and returns a JSON

{{status colour="Blue" title="GET"/}}

 /serviceGateway/services/products///<productName>///targets

For more details, see Retrieving-target-details-using-the-Common-REST-API.


Get view

Retrieves the views for a specific product 

{{status colour="Blue" title="GET"/}}

 /serviceGateway/services/products///<productName>///views

For more details, see Retrieving-a-list-of-product-views-using-the-Common-REST-API.


Get action list

Retrieves the actions available for a specific view and returns the details as a JSON

{{status colour="Blue" title="GET"/}}

 /serviceGateway/services/products///<productName>///views///<viewName>///getActTbl

For more details, see Retrieving-view-actions-using-the-Common-REST-API.


Do action 

Invokes an action for a view

{{status subtle="false" colour="Green" title="POST"/}}

 
/serviceGateway/services/doAction?parms=<parms> 

For more details, see Invoking-actions-using-the-Common-REST-API.


Logout

Logs out of CRA

{{status subtle="false" colour="Green" title="POST"/}}

 (% style="color: rgb(23,43,77);" %)/serviceGateway/services/Logoff

For more details, see Logging-out-of-the-Common-REST-API.


Send BRC event

Sends BRC events that trigger BRC rules in BMC AMI Ops Automation 

{{status subtle="false" colour="Green" title="POST"/}}

 /opsa

For more details, see Triggering-BMC-AMI-Ops-Automation-using-the-Common-REST-API.



Get View definition (deprecated)

Retrieves a MainView view definition

POST /serviceGateway/services/getView?product=<productName>&view=<viewName>

For more details, see Retrieving-MainView-data-using-the-Common-REST-API-deprecated.



Retrieve data (deprecated)

Retrieve data 

{{status subtle="false" colour="Green" title="POST"/}}

 /cra/serviceGateway/services/getData?product=//<productName>//&select=//<select_statement>//

For more details, see Retrieving-MainView-data-using-the-Common-REST-API-deprecated.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*