Device Group Service Operations

The Device Group Service operations enable you to manage device groups in your TIBCO LogLogic® appliance.

Overview

Using Device Group Service operations you can create, read, update, and delete device groups as well as view all device groups in the TIBCO LogLogic® appliance.

Device groups are groups configured on the TIBCO LogLogic® appliance of any source of log data that you want captured by the appliance. In the TIBCO LogLogic® appliance, to view the user interface implementation navigate to Management > Devices > Device Groups.

Implementation Guidelines

These are some general implementation guidelines for Device Group Service operations:

  • A set of Common Request Parameters are required for each operation. You must specify a value for all Required parameters.
  • You must specify the value of the Common Request Parameters only.
  • All parameters must be implemented in the order in which they appear in the Request Parameters section for each of the operations.
  • All values for Common Request Parameters must be enclosed by double quotation marks (“value”). If the name of a device or a parameter value includes a forward slash (/), such as HP/UX, or IBM i5/OS, you must replace the forward slash with %2F. (The F is case-sensitive.)

Examples: HP%2FUX or IBM i5%2FOS

Status Codes

2000 Server success
4000 Unauthorized request
5000 Invalid parameter, getStatusMessage() contains detail information about the error

Device Group Service Operation Descriptions

There are two kinds of operations:

  • local - operation is performed on the local Appliance itself
  • remote - operations (names ending with Remote) performed on a specified remote Appliance

There are two kinds of device groups:

  • local - a group of log sources on the local Appliance (that is, the Appliance you are logged into)
  • global - a group of log sources on multiple Appliances. Global groups are created and managed only from Management Station Appliances.

The Device Group Service operations are as follows: