Activate module


Activates the specified module on the grid.

This topic includes the following sections:

For a video demonstration of how to use this call, see Module-management-API.

Request

HTTP method: POST

Request URL: https://<hostname>:<port>/baocdp/rest/module/activate

Header: See HTTP-request-and-response-headers for header information, such as required authentication token.

Request body properties

Property

Type

Required

Description

Values

Default value

name

String

String

Module name

You can provide multiple names (shown in the example).

You can retrieve a list of modeule names using Get-all-modules.

User-provided value

NA

version

String

String

Module version

User-provided value

NA

revision

String

String

Module revision

User-provided value

NA

 

Example request JSON

{
 "modules":[{
   "name":"AutoPilot-OA-Common_Utilities",
   "version":"20.16.02.00",
   "revision":"1"
},
{    
   "name":"AutoPilot-AD-Utilities",     
   "version":"20.16.02.00",
   "revision":"1"
}]
}

Response

If successful, this method activates the specified module on the grid.

Response body properties

Property

Description

status

Status of the request

message

Message associated with the request status

Example response JSON

{
 "status":"Success",
 "message":"Requested module/s successfully activated."
}

Status codes and messages

For more details about HTTP response codes, see HTTP response codes.

HTTP code

Message

Description

200

OK

Request succeeded

400

 

Bad request

An error occurred while activating the module.

401

 

Unauthorized

405

 

Method not allowed

Related topics

HTTP-request-and-response-headers

Format-of-API-examples

Deactivate-module

 

 

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

BMC Atrium Orchestrator Platform 8.0