Page Comparison

Panel

Table of Contents

maxlevel	1

...

	Description
URI	http://host_name/uc/resources/agentcluster
HTTP Method	POST
Description	Creates a new Agent Cluster.
Example URI	http://localhost:8080/uc/resources/agentcluster
Consumes Content-Type	application/xml, application/json
Produces Content-Type	n/a
Example Request	See Read an Agent Cluster: XML and JSON Examples.
Agent Cluster Properties	See Agent Cluster Properties 794499081.
Agent Properties	See Agent Properties 794499081.
Agent Cluster: Email Notification Properties	See Agent Cluster Email Notification Properties 794499081.
Agent Cluster: SNMP Notification Properties	See Agent Cluster SNMP Notification Properties 794499081.
Example Response	Status 200 /OK Successfully created the agent cluster with sysId {sysId}.

...

Property

UI Field Name

Description

Specifications

Required

Anchor

	agentLimitAmount - CAC
	agentLimitAmount - CAC

agentLimitAmount

Agent Limit Amount

If agentLimitType = Limited; Limit of number of agents in this agent cluster.

Default is 10.

N

Anchor

	agentLimitType - CAC
	agentLimitType - CAC

agentLimitType

Agent Limit

Specification for whether the agent cluster has a Limited or Unlimited number of agents.

Valid Values:

As String = Unlimited, As Value = 1
As String = Limited, As Value = 2

Default is Unlimited (1).

N

Anchor

	currentCount - CAC
	currentCount - CAC

currentCount

Current Task Count

If limitType is Limited (2); Current number of tasks currently being run by the Agents in this agent cluster.

Integer; Read only.

N

Anchor

	description - CAC
	description - CAC

description

Description

User-defined; description of this record.

N

Anchor

	distribution - CAC
	distribution - CAC

distribution

Distribution

Method used to select an Agent in the Agent Cluster.

Valid Values:

As String = Any, As Value = 1
As String = Round Robin, As Value = 2
As String = Lowest CPU Utilization, As Value = 3
As String = Network Alias, As Value = 4

Default is Any (1).

N

Anchor

	exportReleaseLevel - CAC
	exportReleaseLevel - CAC

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read only

N

Anchor

	exportTable - CAC
	exportTable - CAC

exportTable

n/a

Record table information.

read only

N

Anchor

	ignoreInactiveAgents - CAC
	ignoreInactiveAgents - CAC

ignoreInactiveAgents

Ignore Inactive Agents

Specification for whether or not inactive (offline) Agents should be ignored when the agent cluster is used for broadcasting.

Optional; Valid values: true/false (default is false).

N

Anchor

	ignoreSuspendedAgents - CAC
	ignoreSuspendedAgents - CAC

ignoreSuspendedAgents

Ignore Suspended Agents

Specification for whether or not suspended Agents should be ignored when the agent cluster is used for broadcasting.

Optional; Valid values: true/false (default is false).

N

Anchor

	lastAgentUsed - CAC
	lastAgentUsed - CAC

lastAgentUsed

Last Agent Used

Agent that was selected the last time a task was sent to this Agent Cluster.

Read only.

N

Anchor

	lastResolution - CAC
	lastResolution - CAC

lastResolution

Last Resolution

If distribution is Network Alias (4); Last attempted time of Network Alias resolution.

Read only.

N

Anchor

	limitAmount - CAC
	limitAmount - CAC

limitAmount

Limit Amount

If limitType is Limited (2); Number of tasks that can be running at the same time by the Agents in this agent cluster.

N

Anchor

	limitType - CAC
	limitType - CAC

limitType

Task Execution Limit

Specification for whether a Limited or Unlimited number of task instances can be run concurrently by the Agents in this Agent Cluster.

Valid Values:

As String = Unlimited, As Value = 1
As String = Limited, As Value = 2

Default is Unlimited (1).

N

Anchor

	name - CAC
	name - CAC

name

Cluster Name

Name of this Agent Cluster.

Y

Anchor

	networkAlias - CAC
	networkAlias - CAC

networkAlias

Network Alias

If distribution is Network Alias (4); Network alias (or VIP).

N

Anchor

	networkAliasPort - CAC
	networkAliasPort - CAC

networkAliasPort

Agent Port

If distribution is Network Alias (4); Network alias (or VIP) port that the Agent's Universal Broker is listening on.

N

Anchor

	opswiseGroups - CAC
	opswiseGroups - CAC

opswiseGroups

Member of Business Services

List of Business Services that this Agent Cluster belongs to.

Format:

XML

Panel
<opswiseGroups> <opswiseGroup>test</opswiseGroup> </opswiseGroups>

JSON

Panel
"opswiseGroups": ["test"]

N

Anchor

	resolutionDescription - CAC
	resolutionDescription - CAC

resolutionDescription

Resolution Description

If distribution is Network Alias (4); Description of the last attempted resolution.

Read only.

N

Anchor

	resolutionStatus - CAC
	resolutionStatus - CAC

resolutionStatus

Resolution Status

If distribution is Network Alias (4); Status of the last resolution of the Network Alias.

Read only.

N

Anchor

	resumedOn - CAC
	resumedOn - CAC

resumedOn

Resumed On

Date and time when a suspended Agent Cluster was resumed.

Read only.

N

Anchor

	retainSysIds - CAC
	retainSysIds - CAC

retainSysIds

n/a

Specification for whether or not the Create an Agent Cluster web service will persist the sysId - CAC 794499081 property.

If retainSysIds="true" and sysId is included in the request, sysId will be persisted to the database.
If retainSysIds="false" and sysId is included in the request, sysId will be ignored; it will be autogenerated by the Controller.

Note

title	Note

In XML web services, retainSysIds is specified as an attribute in the <agentCluster> element.

Optional; Valid values: true/false (default is true).

N

Anchor

	Strict Business Services Membership - CAC
	Strict Business Services Membership - CAC

strictBsrvcMembership

Strict Business Services Membership

Specifies whether to only allow Agent to Cluster Associations where the Business Service matches.If true, only agents with matched Member of Business Services can be added to the cluster.

Boolean; Valid values: true/false. Default is false.

N

Anchor

	suspended - CAC
	suspended - CAC

suspended

Suspended

Indication of whether or not the ability for this cluster of Agents to run tasks has been suspended.

Read only; Boolean; Valid Values: true/false.

N

Anchor

	suspendedOn - CAC
	suspendedOn - CAC

suspendedOn

Suspended On

Date and time when the Agent Cluster was suspended.

Read only.

N

Anchor

	sysId - CAC
	sysId - CAC

sysId

n/a

sys_id used within the Controller to identify this Agent Cluster.

N

Anchor

	type - CAC
	type - CAC

type

n/a

Type of Agent Cluster.

For List Agent Clusters: Read only; Valid values:

Windows
Linux/Unix
IBM i

For Create/Modify/Read Agent Clusters: Applicable to JSON only; Specifies agent cluster type to create/modify.

Valid values:

windowsAgentCluster

and

unixAgentCluster
ibmiAgentCluster

N

Anchor

	Agent Properties
	Agent Properties

...

Property

UI Field Name

Description

Specifications

Required

Anchor

	agentName - CACA
	agentName - CACA

agentName

Agent

Name of an Agent in the Agent Cluster.

Y

Anchor

	membershipDecommissioned - CACA
	membershipDecommissioned - CACA

membershipDecommissioned

Membership Decommissioned

Indication of whether or not the Agent has been temporarily decommissioned from the Agent Cluster; the Agent will not be available as a selection from the Agent Cluster while it is decommissioned.

N

Anchor

	membershipSuspendedOn - CACA
	membershipSuspendedOn - CACA

membershipResumedOn

Membership Resumed On

Date and time that an Agent temporarily suspended from the Agent Cluster has been resumed.

Read only; Boolean; Valid Values: true/false.

N

Anchor

	membershipSuspended - CACA
	membershipSuspended - CACA

membershipSuspended

Membership Suspended

Indication of whether or not the Agent has been temporarily suspended from the Agent Cluster; the Agent will not be available as a selection from the Agent Cluster while it is suspended.

Read only; Boolean; Valid Values: true/false.

N

Anchor

	membershipSuspendedOn - CACA
	membershipSuspendedOn - CACA

membershipSuspendedOn

Membership Suspended On

Date and time that the Agent has been temporarily suspended from the Agent Cluster.

Read only; Boolean; Valid Values: true/false.

N

Anchor

	type - CACA
	type - CACA

type

n/a

Type of Agent

Read only; Valid values:

Windows
Linux/Unix
IBM i

N

Anchor

	sysId - CACA
	sysId - CACA

sysId

n/a

sys_id used within the Controller to identify the Agent Cluster membership of this Agent.

N

...

	Description
URI	http://host_name/uc/resources/agentcluster
HTTP Method	DELETE
Description	Deletes a specific Agent Cluster.
URI Parameters	See Delete an Agent Cluster: URI Parameters.
Example URI	http://localhost:8080/uc/resources/agentcluster?agentclusterid=35dc94a7a8834d28b51e03b5780cd90c
Authentication	HTTP Basic
Example Response	Status 200 /OK Agent cluster deleted successfully. Status 400 /Bad Request Mutual exclusion violation. Cannot specify agentclustername and agentclusterid at the same time. Status 404 /Not Found A custom day with id "f87848b00a0001037f43e7c81c8ec969" does not exist.

...

	Description
URI	http://host_name/uc/resources/agentcluster/list
HTTP Method	GET
Description	Retrieves information on all Agent Clusters.
Example URI	http://localhost:8080/uc/resources/agentcluster/list
Authentication	HTTP Basic
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Response Examples	See List Agent Clusters: XML and JSON Examples.
Agent Cluster Properties	See Agent Cluster Properties 794499081.
Agent Properties	See Agent Properties 794499081.
Agent Cluster: Email Notification Properties	See Agent Cluster Email Notification Properties 794499081.
Agent Cluster: SNMP Notification Properties	See Agent Cluster SNMP Notification Properties 794499081.

Anchor

	List Agent Clusters XML and JSON Examples
	List Agent Clusters XML and JSON Examples

...

XML

JSON

Expand

title	XML

<agentClusters>
      <agentCluster version="1">
            <agents>
                  <agent>
                        <agentName794499081>pc - SS0001</agentName>
                        <membershipDecommissioned>true</membershipDecommissioned>
                        <membershipResumedOn />
                        <membershipSuspended>true</membershipSuspended>
                        <membershipSuspendedOn>2021-06-29 19:18:30 -400</membershipSuspendedOn>
                        <sysId>af1984d3481b4bccb9bea0e4e1d6fbf2</sysId>
                        <type>Linux/Unix</type>
                  </agent>
            </agents>
            <currentCount>0</currentCount>
            <description>Cluster of Linux Agents</description>
            <distribution>Network Alias</distribution>
            <ignoreInactiveAgents>true</ignoreInactiveAgents>
            <ignoreSuspendedAgents>true0</ignoreSuspendedAgents>
            <lastAgentUsed>sb-qa-123</lastAgentUsed>
            <lastResolution>2018-09-12 09:52:03.410 -0500</lastResolution>
            <limitAmount>5</limitAmount>
            <limitType>Unlimited</limitType>
            <name>Cluster 1</name>
            <networkAlias>qa-123</networkAlias>
            <networkAliasPort />
            <notifications>
		<emailNotification>
			<sysId>2b7286b87a7048399fbd95c01a380002</sysId>
			<bcc />
			<body />
			<cc />
			<emailConnection>uc - Gmail Account</emailConnection>
			<emailTemplate>uc - Template</emailTemplate>
			<replyTo />
			<state>Agents Unavailable<[/state]>
			<subject />
			<to />
		</emailNotification>
		<snmpNotification>
			<state>Agents Unavailable</state>
			<sysId>21d992c72be44b159aac91c4ee9f40c6</sysId>
			<severity>Minor</severity>
			<snmpManager>SNMP Manager</snmpManager>
		</snmpNotification>
            </notifications>
            <opswiseGroups /> 
            <resolutionDescription>Agent in Use:'sb-qa-123'</resolutionDescription>
            <resolutionStatus>Success</resolutionStatus>
            <resumedOn>2021-06-29 19:18:30 -400</resumedOn>
            <strictBsrvcMembership>false</strictBsrvcMembership>
            <suspended>false</suspended>
            <suspendedOn />
            <sysId>cb5b876aa9fec69f0032b55e0391d693</sysId>
            <type>Windows</type>
      </agentCluster>
      <agentCluster version="1">
            <agents>
                  <agent>
                        <agentName794499081>pc - SS0002</agentName794499081>
                        <membershipDecommissioned>false</membershipDecommissioned>
                        <membershipResumedOn />
                        <membershipSuspended>true</membershipSuspended>
                        <membershipSuspendedOn>2021-06-29 19:18:30 -400</membershipSuspendedOn>
                        <sysId>af1984d3481b4bccb9bea0e4e1d6fbf3</sysId>
                        <type>Windows</type>
                  </agent>
            </agents>
            <currentCount>0</currentCount>
            <description>Cluster of Windows Agents</description>
            <distribution>Network Alias</distribution>
            <ignoreInactiveAgents>true</ignoreInactiveAgents>
            <ignoreSuspendedAgents>true0</ignoreSuspendedAgents>
            <lastAgentUsed>sb-qa-123</lastAgentUsed>
            <lastResolution>2018-09-13 10:52:03.410 -0500</lastResolution>
            <limitAmount>5</limitAmount>
            <limitType>Unlimited</limitType>
            <name>Cluster 2</name>
            <networkAlias>qa-123</networkAlias>
            <networkAliasPort />
            <notifications>
		<emailNotification>
			<sysId>2b7286b87a7048399fbd95c01a380002</sysId>
			<bcc />
			<body />
			<cc />
			<emailConnection>uc - Gmail Account</emailConnection>
			<emailTemplate>uc - Template</emailTemplate>
			<replyTo />
			<state>Agents Unavailable</state>
			<subject />
			<to />
		</emailNotification>
		<snmpNotification>
			<state>Agents Unavailable</state>
			<sysId>21d992c72be44b159aac91c4ee9f40c6</sysId>
			<severity>Minor</severity>
			<snmpManager>SNMP Manager</snmpManager>
		</snmpNotification>
            </notifications>
            <opswiseGroups /> 
            <resolutionDescription>Agent in Use:'sb-qa-123'</resolutionDescription>
            <resolutionStatus>Success</resolutionStatus>
            <resumedOn />
            <strictBsrvcMembership>false</strictBsrvcMembership>
            <suspended>true</suspended>
            <suspendedOn>2021-06-29 19:18:30 -400</suspendedOn>
            <sysId>cb5b876aa9fec69f0032b55e0391d694</sysId>
            <type>Windows</type>
      </agentCluster>
</agentClusters>

Expand

title	JSON

[
  {
  "agents": [ {
    "agentName": "Mark-4 - AGNT001",
    "membershipDecommissioned": true,
    "membershipResumedOn": null,
    "membershipSuspended": true,
    "membershipSuspendedOn": "2021-06-29 19:18:30 -400",
    "sysId": "941e558d6f2b4656bdb870e2551fa85e",
    "type": "Linux/Unix"
  } ],
  "currentCount": 0,
  "description": "Cluster of Linux Agents",
  "distribution": "Network Alias",
  "ignoreInactiveAgents": true,
  "ignoreSuspendedAgents": true,
  "lastAgentUsed": "sb-qa-123",
  "lastResolution": "2018-09-12 09:52:03.410 -0500",
  "limitAmount": 5,
  "limitType": "Unlimited",
  "name": "Cluster 1",
  "networkAlias": "qa-123",
  "networkAliasPort": null,
  "notifications": {
    "emailNotifications": [ {
      "bcc": null,
      "body": "${ops_system_identifier}",
      "cc": null,
      "emailConnection": "ecu-office-365",
      "emailTemplate": "agent-built-variables",
      "replyTo": null,
      "state": "Agents Unavailable",
      "subject": null,
      "sysId": "e120f05abd104e2e952c6b9e693891ab",
      "to": "support@stonebranch.com"
    } ],
    "snmpNotifications": [ {
      "severity": "Minor",
      "snmpManager": "test_manager",
      "state": "Agents Unavailable",
      "sysId": "fc4f4e8b0dea4b51a77a3c20f7e62b2a"
    } ]
  },
  "opswiseGroups": [],
  "resolutionDescription": "Agent in Use:'sb-qa-123'",
  "resolutionStatus": "Success",
  "resumedOn": "2021-06-29 19:18:30 -400",
  "strictBsrvcMembership":false,
  "suspended": false,
  "suspendedOn": null,
  "sysId": "35dc94a7a8834d28b51e03b5780cd90c",
  "type": "Windows"
  "version": 1
  },
  {
  "agents": [ {
    "agentName794499081": "Mark-4 - AGNT002",
    "membershipDecommissioned": false,
    "membershipResumedOn": null,
    "membershipSuspended": true, 
    "membershipSuspendedOn": "2021-06-29 19:18:30 -400",
    "sysId": "941e558d6f2b4656bdb870e2551fa85f",
    "type": "Windows"
  } ],
  "currentCount": 0,
  "description": "Cluster of Windows Agents",
  "distribution": "Network Alias",
  "ignoreInactiveAgents": true,
  "ignoreSuspendedAgents": true,
  "lastAgentUsed": "sb-qa-123",
  "lastResolution": "2018-09-13 10:52:03.410 -0500",
  "limitAmount": 5,
  "limitType": "Unlimited",
  "name": "Cluster 2",
  "networkAlias": "qa-123",
  "networkAliasPort": null,
  "notifications": {
    "emailNotifications": [ {
      "bcc": null,
      "body": "${ops_system_identifier}",
      "cc": null,
      "emailConnection": "ecu-office-365",
      "emailTemplate": "agent-built-variables",
      "replyTo": null,
      "state": "Agents Unavailable",
      "subject": null,
      "sysId": "e120f05abd104e2e952c6b9e693891ab",
      "to": "support@stonebranch.com"
    } ],
    "snmpNotifications": [ {
      "severity": "Minor",
      "snmpManager": "test_manager",
      "state": "Agents Unavailable",
      "sysId": "fc4f4e8b0dea4b51a77a3c20f7e62b2a"
    } ]
  },
  "opswiseGroups": [],
  "resolutionDescription": "Agent in Use:'sb-qa-123'",
  "resolutionStatus": "Success",
  "resumedOn": null,
  "strictBsrvcMembership":false,
  "suspended": true,
  "suspendedOn": 2021-06-29 19:18:30 -400,
  "sysId": "35dc94a7a8834d28b51e03b5780cd90d",
  "type": "Windows"
  "version": 1
  }
]

...

	Description
URI	http://host_name/uc/resources/agentcluster/listadv
HTTP Method	GET
Description	Retrieves Agent Clusters details using specific query parameters.
Example URI	http://localhost:8080/uc/resources/agentcluster/listadv http://localhost:8080/uc/resources/agentcluster/listadv?agentclustername=cluster http://localhost:8080/uc/resources/agentcluster/listadv?businessServices=bs1 http://localhost:8080/uc/resources/agentcluster/listadv?type=Linux/Unix http://localhost:8080/uc/resources/agentcluster/listadv?agentclustername=cluster&businessServices=bs1,bs2&type=Windows
Authentication	HTTP Basic
Produces Content-Type	application/xml, application/json
Consumes Content-Type	n/a
Example Responses	See List Agent Cluster - Advanced: XML and JSON Examples
URI Properties	See List Agent Cluster - Advanced: URI Properties

Anchor

	List Agent Cluster - Advanced URI Properties
	List Agent Cluster - Advanced URI Properties

...

Property

UI Field Name

Description

Specifications

Required

agentclustername

Name

Name or partial name of one or more agent clusters.

Wildcards are supported.

N

businessServices

Member of Business Services

Business Services that one or more agent clusters belong to.

String value of comma-separated Business Services.

N

type

n/a

Agent Cluster Type of agent clusters to list.

Valid values: One of the following (not case sensitive):

As String = Windows, As Value = 1
As String = Linux/Unix, As Value = 2
As String = IBM i, As Value = 9

If type is not specified, defaults to all types.

N

...

Description

URI

http://host_name/uc/resources/agentcluster

HTTP Method

PUT

Description

Modifies the Agent Cluster specified by the sysId.

Example URI

http://localhost:8080/uc/resources/agentcluster

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Anchor

	Example Request
	Example Request

Example Request

See Modify an Agent Cluster: XML and JSON Examples.

Agent Cluster Properties

See Agent Cluster Properties 794499081.

Agent Properties

See Agent Properties 794499081.

Agent Cluster: Email Notification Properties

See Agent Cluster Email Notification Properties 794499081.

Agent Cluster: SNMP Notification Properties

See Agent Cluster SNMP Notification Properties 794499081.

Example Response

Status 200 /OK
Successfully updated the agent cluster with sysId {sysId}.

...

XML

JSON

Expand

title	XML

<windowsAgentCluster>
      <description>Cluster of Windows Agents</description>
      <distribution>Any</distribution>
      <ignoreInactiveAgents>true</ignoreInactiveAgents>
      <ignoreSuspendedAgents>true0</ignoreSuspendedAgents>
      <limitAmount>5</limitAmount>
      <limitType>Limited</limitType>
      <name>cluster1</name>
      <networkAlias />
      <networkAliasPort />
      <notifications>
		<emailNotification>
			<sysId>2b7286b87a7048399fbd95c01a380002</sysId>
			<bcc />
			<body />
			<cc />
			<emailConnection>uc - Gmail Account</emailConnection>
			<emailTemplate>uc - Template</emailTemplate>
			<replyTo />
			<state>Agents Unavailable</state>
			<subject />
			<to />
		</emailNotification>
		<snmpNotification>
			<state>Agents Unavailable</state>
			<sysId>21d992c72be44b159aac91c4ee9f40c6</sysId>
			<severity>Minor</severity>
			<snmpManager>SNMP Manager</snmpManager>
		</snmpNotification>
      </notifications>
      <sysId>35dc94a7a8834d28b51e03b5780cd90c</sysId>
</windowsAgentCluster>

Expand

title	JSON

{
  "type": "windowsAgentCluster",
  "description": "Cluster of Windows Agents",
  "distribution": "Any",
  "ignoreInactiveAgents": true,
  "ignoreSuspendedAgents": true,
  "limitAmount": 5,
  "limitType": "Unlimited",
  "name": "cluster1",
  "networkAlias": null,
  "networkAliasPort": null,
  "notifications": {
    "emailNotifications": [ {
      "bcc": null,
      "body": "${ops_system_identifier}",
      "cc": null,
      "emailConnection": "ecu-office-365",
      "emailTemplate": "agent-built-variables",
      "replyTo": null,
      "state": "Agents Unavailable",
      "subject": null,
      "sysId": "e120f05abd104e2e952c6b9e693891ab",
      "to": "support@stonebranch.com"
    } ],
    "snmpNotifications": [ {
      "severity": "Minor",
      "snmpManager": "test_manager",
      "state": "Agents Unavailable",
      "sysId": "fc4f4e8b0dea4b51a77a3c20f7e62b2a"
    } ]
  },
  "sysId": "35dc94a7a8834d28b51e03b5780cd90c",
}

...

	Description
URI	http://host_name/uc/resources/agentcluster
HTTP Method	GET
Description	Retrieves information on a specific Agent cluster.
URI Parameters	See Read an Agent Cluster URI Parameters 794499081.
Example URI	http://localhost:8080/uc/resources/agentcluster?agentclustername=cluster1
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Response	See Read an Agent Cluster: XML and JSON Examples.
Agent Cluster Properties	See Agent Cluster Properties 794499081.
Agent Properties	See Agent Properties 794499081.
Agent Cluster: Email Notification Properties	See Agent Cluster Email Notification Properties 794499081.
Agent Cluster: SNMP Notification Properties	See Agent Cluster SNMP Notification Properties 794499081.

Anchor

	Read an Agent Cluster URI Parameters
	Read an Agent Cluster URI Parameters

...

Read an Agent Cluster: XML and JSON Examples

The retainSysIds and version properties are specified as attributes in XML.

The exportReleaseLevel and exportTable properties are specified as attributes in XML.

XML

JSON

Expand

title	XML

<windowsAgentCluster exportReleaseLevel="7.2.0.0" exportTable="ops_windows_agent_cluster" retainsSysIds="true" version="1">
      <agents>
            <agent>
                  <agentName794499081>pc - SS0001</agentName794499081>
                  <membershipResumedOn />
                  <membershipSuspended>true</membershipSuspended>
                  <membershipSuspendedOn>2021-06-29 19:18:30 -400</membershipSuspendedOn>
                  <sysId>af1984d3481b4bccb9bea0e4e1d6fbf2</sysId>
                  <type>Windows</type>
            </agent>
      </agents>
      <currentCount>0</currentCount>
      <description>Cluster of Windows Agents</description>
      <distribution>Network Alias</distribution>
      <ignoreInactiveAgents>true</ignoreInactiveAgents>
      <ignoreSuspendedAgents>true0</ignoreSuspendedAgents>
      <lastAgentUsed>sb-qa-123</lastAgentUsed>
      <lastResolution>2018-09-12 09:52:03.410 -0500</lastResolution>
      <limitAmount>5</limitAmount>
      <limitType>Unlimited</limitType>
      <name>Cluster 1</name>
      <networkAlias>qa-123</networkAlias>
      <networkAliasPort />
      <notifications>
		<emailNotification>
			<sysId>2b7286b87a7048399fbd95c01a380002</sysId>
			<bcc />
			<body />
			<cc />
			<emailConnection>uc - Gmail Account</emailConnection>
			<emailTemplate>uc - Template</emailTemplate>
			<replyTo />
			<state>Agents Unavailable</state>
			<subject />
			<to />
		</emailNotification>
		<snmpNotification>
			<state>Agents Unavailable</state>
			<sysId>21d992c72be44b159aac91c4ee9f40c6</sysId>
			<severity>Minor</severity>
			<snmpManager>SNMP Manager</snmpManager>
		</snmpNotification>
      </notifications>
      <opswiseGroups /> 
      <resolutionDescription>Agent in Use:'sb-qa-123'</resolutionDescription>
      <resolutionStatus>Success</resolutionStatus>
      <resumedOn>2021-06-29 19:18:30 -400</resumedOn>
      <strictBsrvcMembership>false</strictBsrvcMembership>
      <suspended>false</suspended>
      <suspendedOn /
      <sysId>35dc94a7a8834d28b51e03b5780cd90c</sysId>
</windowsAgentCluster>

Expand

title	JSON

{
  "type": "windowsAgentCluster",
  "agents": [ {
    "agentName794499081": "Mark-4 - AGNT001",
    "membershipResumedOn": null,
    "membershipSuspended": true, 
    "membershipSuspendedOn": "2021-06-29 19:18:30 -400",
    "sysId": "941e558d6f2b4656bdb870e2551fa85e",
    "type": "Windows"
  } ],
  "currentCount": 0,
  "description": "Cluster of Windows Agents",
  "distribution": "Network Alias",
  "exportReleaseLevel": "7.2.0.0",
  "exportTable": "ops_windows_agent_cluster",
  "ignoreInactiveAgents": true,
  "ignoreSuspendedAgents": true,
  "lastAgentUsed": "sb-qa-123",
  "lastResolution": "2018-09-12 09:52:03.410 -0500",
  "limitAmount": 5,
  "limitType": "Unlimited",
  "name": "Cluster 1",
  "networkAlias": "qa-123",
  "networkAliasPort": null,
  "notifications": {
    "emailNotifications": [ {
      "bcc": null,
      "body": "${ops_system_identifier}",
      "cc": null,
      "emailConnection": "ecu-office-365",
      "emailTemplate": "agent-built-variables",
      "replyTo": null,
      "state": "Agents Unavailable",
      "subject": null,
      "sysId": "e120f05abd104e2e952c6b9e693891ab",
      "to": "support@stonebranch.com"
    } ],
    "snmpNotifications": [ {
      "severity": "Minor",
      "snmpManager": "test_manager",
      "state": "Agents Unavailable",
      "sysId": "fc4f4e8b0dea4b51a77a3c20f7e62b2a"
    } ]
  },
  "opswiseGroups": [],
  "resolutionDescription": "Agent in Use:'sb-qa-123'",
  "resolutionStatus": "Success",
  "retainSysIds": true,
  "resumedOn": "2021-06-29 19:18:30 -400",
  "strictBsrvcMembership":false,
  "suspended": false,
  "suspendedOn": null,
  "sysId": "35dc94a7a8834d28b51e03b5780cd90c",
  "version": 1
}

...

	Description
URI	http://host_name/uc/resources/agentcluster/resolve
HTTP Method	POST
Description	Resolves the Network Alias for the specified agent cluster.
Example URI	http://localhost:8080/uc/resources/agentcluster/resolve
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Resolve an Agent Cluster: XML and JSON Examples.
Request Properties	See Resolve an Agent Cluster: Request Properties.
Example Response	See Resolve an Agent Cluster: XML and JSON Examples.

Anchor

	Resolve an Agent Cluster XML and JSON Examples
	Resolve an Agent Cluster XML and JSON Examples

...

Example

XML

JSON

Example Request

Expand

title	XML

<resolve-agent-cluster>
  <agentClusterName>Agent_Cluster_Alias_Production</agentClusterName>
</resolve-agent-cluster>

Expand

title	JSON

{
  "agentClusterName": "Agent_Cluster_Alias_Production"
}

Example Response

Expand

title	XML

<command-response>
  <type>resolve_agent_cluster</type>
  <success>true</success>
  <info>Successfully resolved network alias for agent cluster "Agent_Cluster_Alias_Production".</info>
  <errors></errors>
</command-response>

Expand

title	JSON

{
    "type": "resolve_agent_cluster",
    "success": true,
    "info": "Successfully resolved agent cluster\"Agent_Cluster_Alias_Production\".",
    "errors": ""
}

...

	Description
URI	http://host_name/uc/resources/agentcluster/resume
HTTP Method	POST
Description	Resumes the specified agent cluster.
Example URI	http://localhost:8080/uc/resources/agentcluster/resume
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Resume an Agent Cluster: XML and JSON Examples.
Request Properties	See Resume an Agent Cluster: Request Properties.
Example Response	See Resume an Agent Cluster: XML and JSON Examples.

Anchor

	Resume an Agent Cluster XML and JSON Examples
	Resume an Agent Cluster XML and JSON Examples

...

Example

XML

JSON

Example Request

Expand

title	XML

<resume-agent-cluster>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
</resume-agent-cluster>

Expand

title	JSON

{
  "agentClusterNameagentClusterName": "uc - Default Windows Cluster"
}

Example Response

Expand

title	XML

<command-response>
  <type>resume_agent_cluster</type>
  <success>true</success>
  <info>Successfully resumed agent cluster "uc - Default Windows Cluster".</info>
  <errors />
</command-response>

Expand

title	JSON

{
    "type": "resume_agent_cluster",
    "success": true,
    "info": " Successfully resumed agent cluster "uc - Default Windows Cluster".",
    "errors": ""
}

...

	Description
URI	http://host_name/uc/resources/agent/ops-resume-agent-cluster-membership
HTTP Method	POST
Description	Resumes the specified agent cluster membership.
Example URI	http://localhost:8080/uc/resources/agent/ops-resume-agent-cluster-membership
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Resume an Agent Cluster Membership: XML and JSON Examples.
Request Properties	See Resume an Agent Cluster Membership: Request Properties.
Example Response	See Resume an Agent Cluster Membership: XML and JSON Examples.

Anchor

	Resume an Agent Cluster Membership XML and JSON Examples
	Resume an Agent Cluster Membership XML and JSON Examples

...

Example

XML

JSON

Example Request

Expand

title	XML

By Agent Name

<resume-agent-cluster-membership>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
  <agentName>XPS-8300 - AGNT0001</agentName>
</resume-agent-cluster-membership>

By Agent ID

<resume-agent-cluster-membership>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
  <agentID>AGNT0001</agentID>
</resume-agent-cluster-membership>

Expand

title	JSON

By Agent Name

{
  "agentClusterName": "uc - Default Windows Cluster",
  "agentName": "XPS-8300 - AGNT0001"
}

By Agent ID

{
  "agentClusterName": "uc - Default Windows Cluster",
  "agentID": "AGNT0001"
}

Example Response

Expand

title	XML

<command-response>
  <type>resume_agent_cluster_membership</type>
  <success>true</success>
  <info>Successfully resumed agent cluster membership.</info>
  <errors />
</command-response>

Expand

title	JSON

{
    "type": "resume_agent_cluster_membership",
    "success": true,
    "info": " Successfully resumed agent cluster membership.",
    "errors": ""
}

...

	Description
URI	http://hostName:port/uc/resources/agentcluster/agent
HTTP Method	GET
Description	Retrieves information on a specific Agent from an Agent Cluster for which a Distribution method of Any or Lowest CPU Utilization is specified.
URI Parameters	See Return an Agent from an Agent Cluster: URI Parameters.
Consumes Content-Type	n/a
Produces Content-Type	application/xml, application/json
Example Request URI	http://localhost:8080/uc/resources/agentcluster/agent?agentclustername=testCluster&ignoreexecutionlimit=true
Example Response	See Return an Agent from an Agent Cluster: Example Response.

Anchor

	Return an Agent from an Agent Cluster URI Parameters
	Return an Agent from an Agent Cluster URI Parameters

...

	Description
URI	http://host_name/uc/resources/agentcluster/taskexecutionlimit
HTTP Method	POST
Description	Sets the task execution limit for the specified agent cluster.
Example URI	http://localhost:8080/uc/resources/agentcluster/taskexecutionlimit
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Set an Agent Cluster Task Execution Limit: XML and JSON Examples.
Request Properties	See Set an Agent Cluster Task Execution Limit: Request Properties.
Example Response	See Set an Agent Cluster Task Execution Limit: XML and JSON Examples.

Anchor

	Set an Agent Cluster Task Execution Limit XML and JSON Examples
	Set an Agent Cluster Task Execution Limit XML and JSON Examples

...

Example

XML

JSON

Example Request

Expand

title	XML

Limit Type: Limited

<set-agent-cluster-task-execution-limit>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
  <limitAmount>15</limitAmount>
  <limitType>Limited</limitType>
</set-agent-cluster-task-execution-limit>

Limit Type: Unlimited

<set-agent-cluster-task-execution-limit>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
  <limitType>Unlimited</limitType>
</set-agent-cluster-tas

Expand

title	JSON

Limit Type: Limited

{
  "agentClusterName": "uc - Default Windows Cluster",
  "limitAmount": 15,
  "limitType": "Limited"
}

Limit Type: Unlimited

{
  "agentClusterName": "uc - Default Windows Cluster",
  "limitType": "Unlimited"
}

Example Response

Expand

title	XML

<command-response>
  <type>set_agent_cluster_task_execution_limit</type>
  <success>true</success>
  <info>Successfully updated agent cluster"uc - Default Windows Cluster" with task limit type: "Limited", amount: "15".</info>
  <errors />
</command-response>

Expand

title	JSON

{
    "type": "set_agent_cluster_task_execution_limit",
    "success": true,
    "info": " Successfully updated agent cluster"uc - Default Windows Cluster" with task limit type: "Limited", amount: "15".",
    "errors": ""
}

...

	Description
URI	http://host_name/uc/resources/agentcluster/suspend
HTTP Method	POST
Description	Suspends the specified agent cluster.
Example URI	http://localhost:8080/uc/resources/agentcluster/suspend
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Suspend an Agent Cluster: XML and JSON Examples.
Request Properties	See Suspend an Agent Cluster: Request Properties.
Example Response	See Suspend an Agent Cluster: XML and JSON Examples.

Anchor

	Suspend an Agent Cluster XML and JSON Examples
	Suspend an Agent Cluster XML and JSON Examples

...

Example

XML

JSON

Example Request

Expand

title	XML

<suspend-agent-cluster>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
</suspend-agent-cluster>

Expand

title	JSON

{
  "agentClusterName": "uc - Default Windows Cluster"
}

Example Response

Expand

title	XML

<command-response>
  <type>suspend_agent_cluster</type>
  <success>true</success>
  <info>Successfully suspended agent cluster "uc - Default Windows Cluster".</info>
  <errors />
</command-response>

Expand

title	JSON

{
    "type": "suspend_agent_cluster",
    "success": true,
    "info": " Successfully suspended agent cluster "uc - Default Windows Cluster".",
    "errors": ""
}

...

	Description
URI	http://host_name/uc/resources/agent/ops-suspend-agent-cluster-membership
HTTP Method	POST
Description	Suspends the specified agent cluster membership.
Example URI	http://localhost:8080/uc/resources/agent/ops-suspend-agent-cluster-membership
Authentication	HTTP Basic
Consumes Content-Type	application/xml, application/json
Produces Content-Type	application/xml, application/json
Example Request	See Suspend an Agent Cluster Membership: XML and JSON Examples.
Request Properties	See Suspend an Agent Cluster Membership: Request Properties.
Example Response	See Suspend an Agent Cluster Membership: XML and JSON Examples.

Anchor

	Suspend an Agent Cluster Membership XML and JSON Examples
	Suspend an Agent Cluster Membership XML and JSON Examples

...

Example

XML

JSON

Example Request

Expand

title	XML

By Agent Name

<suspend-agent-cluster-membership>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
  <agentName>XPS-8300 - AGNT0001</agentName>
</suspend-agent-cluster-membership>

By Agent ID

<suspend-agent-cluster-membership>
  <agentClusterName>uc - Default Windows Cluster</agentClusterName>
  <agentID>AGNT0001</agentID>
</suspend-a

Expand

title	JSON

By Agent Name

{
  "agentClusterName": "uc - Default Windows Cluster",
  "agentName": "XPS-8300 - AGNT0001"
}

By Agent ID

{
  "agentClusterName": "uc - Default Windows Cluster",
  "agentID": "AGNT0001"
}

Example Response

Expand

title	XML

<command-response>
  <type>suspend_agent_cluster_membership</type>
  <success>true</success>
  <info>Successfully suspended agent cluster membership.</info>
  <errors />
</command-response>

Expand

title	JSON

{
    "type": "suspend_agent_cluster_membership",
    "success": true,
    "info": " Successfully suspended agent cluster membership.",
    "errors": ""
}

...

Versions Compared

Old Version 2

New Version Current

Key

Read an Agent Cluster: XML and JSON Examples