Panel | ||||
---|---|---|---|---|
|
...
Formatting specifications for each web service, including details about property requirements, are provided.
Anchor | ||||
---|---|---|---|---|
|
Create an Agent Cluster
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 | |
Agent Cluster Properties | |
Agent Properties | See Agent Properties 63543106. |
Agent Cluster: Email Notification Properties | |
Agent Cluster: SNMP Notification Properties | |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Agent Cluster Properties
Property | UI Field Name | Description | Specifications | Required | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Agent Limit Amount | If agentLimitType = Limited; Limit of number of agents in this agent cluster. | Default is 10. | N | |||||||||||
| Agent Limit | Specification for whether the agent cluster has a Limited or Unlimited number of agents. | Valid Values:
Default is Unlimited (1). | N | |||||||||||
currentCount | Current Task Count | If | Integer; Read only. | N | |||||||||||
description | Description | User-defined; description of this record. | N | ||||||||||||
distribution | Distribution | Method used to select an Agent in the Agent Cluster. | Valid Values:
Default is Any (1). | N | |||||||||||
exportReleaseLevel | n/a | Universal Controller release that the record was exported from. | read only | N | |||||||||||
exportTable | n/a | Record table information. | read only | N | |||||||||||
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 | |||||||||||
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 | |||||||||||
lastAgentUsed | Last Agent Used | Agent that was selected the last time a task was sent to this Agent Cluster. | Read only. | N | |||||||||||
lastResolution | Last Resolution | If | Read only. | N | |||||||||||
limitAmount | Limit Amount | If | N | ||||||||||||
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:
Default is Unlimited (1). | N | |||||||||||
name | Cluster Name | Name of this Agent Cluster. | Y | ||||||||||||
networkAlias | Network Alias | If | N | ||||||||||||
networkAliasPort | Agent Port | If | N | ||||||||||||
opswiseGroups | Member of Business Services | List of Business Services that this Agent Cluster belongs to.
| N | ||||||||||||
resolutionDescription | Resolution Description | If | Read only. | N | |||||||||||
resolutionStatus | Resolution Status | If | Read only. | N | |||||||||||
resumedOn | Resumed On | Date and time when a suspended Agent Cluster was resumed. | Read only. | N | |||||||||||
retainSysIds | n/a | Specification for whether or not the Create an Agent Cluster web service will persist the sysId - CAC 63543106 property.
| Optional; Valid values: true/false (default is true). | N | |||||||||||
| 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 | |||||||||||
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 | |||||||||||
suspendedOn | Suspended On | Date and time when the Agent Cluster was suspended. | Read only. | N | |||||||||||
sysId | n/a | sys_id used within the Controller to identify this Agent Cluster. | N | ||||||||||||
type | n/a | Type of Agent Cluster. | For List Agent Clusters: Read only; Valid values:
For Create/Modify/Read Agent Clusters: Applicable to JSON only; Specifies agent cluster type to create/modify. Valid values: | N |
Anchor | ||||
---|---|---|---|---|
|
Agent Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
agentName | Agent | Name of an Agent in the Agent Cluster. | Y | |||||||
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 | |||||||
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 | ||||||
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 | ||||||
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 | ||||||
type | n/a | Type of Agent | Read only; Valid values:
| N | ||||||
sysId | n/a | sys_id used within the Controller to identify the Agent Cluster membership of this Agent. | N |
Anchor | ||||
---|---|---|---|---|
|
Agent Cluster: Email Notification Properties
Property | UI Field Name | Description | Specifications | ||||||
---|---|---|---|---|---|---|---|---|---|
bcc | Bcc | Email address of the party being sent a blind (hidden) copy of the email, if any. | Use commas to separate multiple recipients. Variables and Functions are supported. | ||||||
body | Body | Text of the email message. | Variables and Functions are supported. If the | ||||||
cc | Cc | Email address of the party being sent a copy of the email, if any. | Use commas to separate multiple recipients. Variables and Functions are supported. | ||||||
emailConnection | Email Connection | Name of an Email Connection. | If you specify both an | ||||||
emailTemplate | Email Template | Name of an Email Template. | If you specify both an | ||||||
replyTo | Reply-To | Email address of the sender of the email. | Use commas to separate multiple recipients. Variables and Functions are supported. | ||||||
state | Notification State | Comma-separated list of Notification states | Valid values:
| ||||||
subject | Subject | Subject line of the email. | Variables and Functions are supported. | ||||||
sysId | n/a | sys_id used within the Controller to identify this Email Notification. | |||||||
to | To | Email address of the recipient. | Use commas to separate multiple recipients Variables and Functions are supported. |
Anchor | ||||
---|---|---|---|---|
|
Agent Cluster: SNMP Notification Properties
Property | UI Field Name | Description | Specifications | ||||||
---|---|---|---|---|---|---|---|---|---|
severity | Notification Severity | Severity level of this notification. | Valid values:
Default is Normal (1). | ||||||
snmpManager | SNMP Manager | SNMP Manager that will receive this notification. | |||||||
state | Notification State | Comma-separated list of Notification states | Valid values:
| ||||||
sysId | n/a | sys_id used within the Controller to identify this SNMP Notification. |
Anchor | ||||
---|---|---|---|---|
|
Delete an Agent Cluster
Description | |
---|---|
URI | http://host_name/uc/resources/agentcluster |
HTTP Method | DELETE |
Description | Deletes a specific Agent Cluster. |
URI Parameters | |
Example URI | http://localhost:8080/uc/resources/agentcluster?agentclusterid=35dc94a7a8834d28b51e03b5780cd90c |
Authentication | HTTP Basic |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Delete an Agent Cluster: URI Parameters
Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| Unique ID for this Agent Cluster. | Y |
| |
| Name used within the Controller to identify this Agent Cluster. | Y |
|
Anchor | ||||
---|---|---|---|---|
|
List Agent Clusters
Description | |
---|---|
URI | |
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 | |
Agent Cluster Properties | |
Agent Properties | See Agent Properties 63543106. |
Agent Cluster: Email Notification Properties | |
Agent Cluster: SNMP Notification Properties |
Anchor | ||||
---|---|---|---|---|
|
List Agent Clusters: XML and JSON Examples
XML | JSON | |||||
---|---|---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
List Agent Cluster - Advanced
Description | |
---|---|
URI | http://host_name/uc/resources/agentcluster/listadv |
HTTP Method | GET |
Description | Retrieves Agent Clusters details using specific query parameters. |
Example URI | |
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 |
Anchor | ||||
---|---|---|---|---|
|
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):
If type is not specified, defaults to all types. | N |
Anchor | ||||
---|---|---|---|---|
|
List Agent Cluster - Advanced: XML and JSON Examples
XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Modify an Agent Cluster
Description | |||||||
---|---|---|---|---|---|---|---|
URI | http://host_name/uc/resources/agentcluster | ||||||
HTTP Method | PUT | ||||||
Description | Modifies the Agent Cluster specified by the | ||||||
Example URI | http://localhost:8080/uc/resources/agentcluster | ||||||
Consumes Content-Type | application/xml, application/json | ||||||
Produces Content-Type | n/a | ||||||
| |||||||
Agent Cluster Properties | |||||||
Agent Properties | See Agent Properties 63543106. | ||||||
Agent Cluster: Email Notification Properties | |||||||
Agent Cluster: SNMP Notification Properties | |||||||
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Modify an Agent Cluster: XML and JSON Examples
XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Read an Agent Cluster
Description | |
---|---|
URI | http://host_name/uc/resources/agentcluster |
HTTP Method | GET |
Description | Retrieves information on a specific Agent cluster. |
URI Parameters | |
Example URI | http://localhost:8080/uc/resources/agentcluster?agentclustername=cluster1 |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
Example Response | |
Agent Cluster Properties | |
Agent Properties | See Agent Properties 63543106. |
Agent Cluster: Email Notification Properties | |
Agent Cluster: SNMP Notification Properties |
Anchor | ||||
---|---|---|---|---|
|
Read an Agent Cluster: URI Parameters
Parameter | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| ID used within the Controller to identify this Agent cluster. | String; URI parameter. | Y (unless |
|
| Name used within the Controller to identify this Agent cluster. | String; URI parameter. | Y (unless |
|
Anchor | ||||
---|---|---|---|---|
|
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 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Resolve an Agent Cluster
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 | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Resolve an Agent Cluster: XML and JSON Examples
Example | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Resolve an Agent Cluster: Request Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
agentClusterName | Cluster Name | Name used within the Controller to identify this agent cluster. | Y |
Anchor | ||||
---|---|---|---|---|
|
Resume an Agent Cluster
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 | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Resume an Agent Cluster: XML and JSON Examples
Example | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Resume an Agent Cluster: Request Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
agentClusterName | Cluster Name | Name used within the Controller to identify this agent cluster. | Y |
Anchor | ||||
---|---|---|---|---|
|
Resume an Agent Cluster Membership
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 | |
Example Response | See Resume an Agent Cluster Membership: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Resume an Agent Cluster Membership: XML and JSON Examples
Example | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Resume an Agent Cluster Membership: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
agentClusterName | Cluster Name | Name used within the Controller to identify this agent cluster. | Y | ||||||||
agentID | Agent ID | Defined by the user when installing the Agent; name used within the Controller to identify this resource. | Y |
| |||||||
agentName | Agent Name | Unique ID for this Agent, created during installation. The name of the communications server message queue. The Controller uses the communications server for communications between the Controller scheduler and Agents. | Y |
|
Anchor | ||||
---|---|---|---|---|
|
Return an Agent from an Agent Cluster
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 | |
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
Parameter | Description | Specifications | Required |
---|---|---|---|
| Name used within the Controller to identify this agent cluster. | Type = String; URI property. | Y |
| Specification to use or ignore the task execution limit. | Type = Boolean (true/false), Default is false; URI property. | N |
Anchor | ||||
---|---|---|---|---|
|
Return an Agent from an Agent Cluster: Example Response
XML Response | JSON Response | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Set an Agent Cluster Task Execution Limit
Description | |
---|---|
URI | |
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
Example | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Set an Agent Cluster Task Execution Limit: Request Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
agentClusterName | Cluster Name | Name used within the Controller to identify this agent cluster. | Y | |||||||
limitAmount | Limit Amount | Number of tasks that can be running at the same time by the Agents in this agent cluster. | Set only if | N | ||||||
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:
| Y |
Anchor | ||||
---|---|---|---|---|
|
Suspend an Agent Cluster
Description | |
---|---|
URI | |
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 | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Suspend an Agent Cluster: XML and JSON Examples
Example | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Suspend an Agent Cluster: Request Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
agentClusterName | Cluster Name | Name used within the Controller to identify this agent cluster. | Y |
Anchor | ||||
---|---|---|---|---|
|
Suspend an Agent Cluster Membership
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
Example | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
Suspend an Agent Cluster Membership: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
agentClusterName | Cluster Name | Name used within the Controller to identify this agent cluster. | Y | ||||||||
agentID | Agent ID | Unique ID for this Agent, created during installation. | Y |
| |||||||
agentName | Agent Name | Name used within the Controller to identify this resource. | Y |
|
...