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

Description of Device Group Service Operation

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 through the Management Station

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: