service.create

Description

object service.create(object/array services)

This method allows to create new services.

This method is available to users of any type. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object/array) services to create.

Additionally to the standard service properties, the method accepts the following parameters.

ParameterTypeDescription
childrenarrayChild services to be linked to the service.

The children must have the serviceid property defined.
parentsarrayParent services to be linked to the service.

The parents must have the serviceid property defined.
tagsarrayService tags to be created for the service.
problem_tagsarrayProblem tags to be created for the service.
status_rulesarrayStatus rules to be created for the service.

Return values

(object) Returns an object containing the IDs of the created services under the serviceids property. The order of the returned IDs matches the order of the passed services.

Examples

Creating a service

Create a service that will be switched to problem state, if at least one child has a problem.

Request:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "service.create",
  4. "params": {
  5. "name": "Server 1",
  6. "algorithm": 1,
  7. "sortorder": 1
  8. },
  9. "id": 1
  10. }

Response:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "serviceids": [
  5. "5"
  6. ]
  7. },
  8. "id": 1
  9. }

Source

CService::create() in ui/include/classes/api/services/CService.php.