...
Description | |
---|---|
URI | http://host_name/uc/resources/webhook/assignexecutionuser |
HTTP Method | POST |
Description | Assigns an Execution User to the specified webhook. |
Example URI | http://localhost:8080/uc/resources/webhook/assignexecutionuser?webhookid= http://localhost:8080/uc/resources/webhook/assignExecutionUser?webhookname= |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | N/A |
Example Request | See Assign an Execution User to a Webhook: Example Request Properties. |
Example Response |
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/webhook/enable |
HTTP Method | POST |
Description | Disables a webhook. |
Example URI | |
Authentication | HTTP Basic |
Consumes Content-Type | N/A |
Produces Content-Type | application/xml, application/json |
Example Request | http://localhost:9090/uc/resources/webhook/disable?webhookname= http://localhost:9090/uc/resources/webhook/disable?webhookid= |
Example Response |
...
Disable a Webhook
...
: Query Parameters
Property | UI Field Name | Description | URI | ||
---|---|---|---|---|---|
HTTP Method | POST | ||||
Description | Enables a webhook. | ||||
Example URI | |||||
Authentication | HTTP Basic | ||||
Consumes Content-Type | N/A | ||||
Produces Content-Type | application/xml, application/json | ||||
Example Request | http://localhost:9090Specifications | Required | Mutually Exclusive With | ||
| ID used within the Controller to identify this webhook. | String; URI parameter. | Y |
| |
| Name used within the Controller to identify this webhook. | String; URI parameter. | Y |
|
Enable a Webhook
Description | |
---|---|
URI | http://host_name/uc/resources/webhook/enable?webhookname= |
HTTP Method | POST |
Description | Enables a webhook. |
Example URI | http://localhost:90908080/uc/resources/webhook/enable?webhookid= |
Example Response |
Enable/Disable Webhooks
Description | URI | http://host_name |
---|---|---|
Authentication | HTTP Basic | |
Consumes Content-Type | N/A | |
Produces Content-Type | application/xml, application/json | |
Example Request | Example URI | http://localhost:9090/uc/resources/webhook/ops-enable-disable-webhook |
HTTP Method | POST | |
Description | Enables/Disables a list of webhooks. | |
http://localhost:80809090/uc/resources/webhook/ops-enable-disable-webhook | ||
Authentication | HTTP Basic | |
Consumes Content-Type | application/xml, application/json | |
Produces Content-Type | application/xml, application/json | |
Example Requestenable?webhookid= | ||
Example Response | See Enable/Disable a Webhook: XML and JSON Examples.Example ResponseSee |
Enable
...
a Webhook:
...
List Webhooks
...
Description
...
URI
...
http://host_name/uc/resources/webhook/list
...
HTTP Method
...
GET
...
Description
...
List webhook registrations.
...
Query Parameters
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|---|
| ID used within the Controller to identify this webhook. | String; URI parameter. | Y |
| |
| Name | Name used within the Controller to identify this webhook. | String; URI parameter. | Y |
|
Enable/Disable Webhooks
Description | |
---|---|
URI | http://localhost:8080host_name/uc/resources/webhook/list?webhookname=http://localhost:8080/uc/resources/webhook/list?action=ops-enable-disable-webhook |
HTTP Method | POST |
Description | Enables/Disables a list of webhooks. |
Example URI | http://localhost:8080/uc/resources/webhook/list?description=ops-enable-disable-webhook |
Authentication | HTTP Basic |
Produces Consumes Content-TypeConsumes | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example ResponsesList WebhookRequest | See Enable/Disable a Webhook: XML and JSON Examples. |
Modify Webhooks
...
Description
...
URI
...
http://host_name/uc/resources/webhook
...
HTTP Method
...
PUT
...
Description
...
Modify a webhook.
...
Example URI
...
http://localhost:8080/uc/resources/webhook
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
Application/XML
Application/JSON
...
Consumes Content-Type
...
Application/XML
Application/JSON
...
Example Responses
...
Status 200
Successfully updated the resourcename with id {uuid}.
Status 400
Error message.
Status 403
Operation prohibited due to security constraints.
Status 404
A resourcename with name “{name}” does not exist.
A resourcename with id "{uuid}" does not exist.
Status 500
Unexpected request failure. See log(s) for more details.
Read a Webhook
...
Description
...
URI
...
http://host_name/uc/resources/webhook
...
HTTP Method
...
GET
...
Description
...
Read webhook registration.
...
Example URI
...
http://localhost:8080/uc/resources/webhook?webhookid=
http://localhost:8080/uc/resources/webhook?webhookname=
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
Consumes Content-Type
...
Example Responses
...
Read Webhook: XML and JSON Examples.
...
Property
UI Field Name
Description
Specifications
Required
Mutually Exclusive With
...
webhookid
...
ID used within the Controller to identify this webhook.
...
String; URI parameter.
...
Y
(unless webhookname
is specified)
...
webhookname
...
webhookname
...
Name
...
Name used within the Controller to identify this webhook.
...
String; URI parameter.
...
Y
(unless webhookid
is specified)
...
webhookid
Register a Webhook
Example Response | See Enable/Disable a Webhook: XML and JSON Examples. |
Enable/Disable Webhooks: Payload Properties
Property | UI Field Name | Description |
---|---|---|
| n/a | There are two attributes for this property:
For example: <webhook enable="true" name="test-1"></webhook> |
Enable/Disable a Webhook: XML and JSON Examples
XML | JSON | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
List Webhooks
Description | |||
---|---|---|---|
URI | http://host_name/uc/resources/webhook/list | ||
HTTP Method | POSTGET | ||
Description | Register a List webhook registrations. | ||
Example URI | Authentication | http://localhost:8080/uc/resources/webhook/list?action= http://localhost:8080/uc/resources/webhook/list?description= | |
Authentication | HTTP Basic | ||
Produces Content-Type Application/XML Application/JSON | |||
Consumes Content-Type | Application/XML Application/JSON | ||
Example Request | See Register a Webhook: Example Request | ||
Example Responses |
|
Register a Webhook: Payload Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
| Webhook Name | Name of the Webhook. | Y |
| Description | User-defined; description of this record. | N |
| Member Example Responses | List Webhook: XML and JSON Examples. |
List Webhooks: Query Parameters
Property | UI Field Name | Description | Specifications | Required | |||||
---|---|---|---|---|---|---|---|---|---|
| Name | Name used within the Controller to identify this webhook. | String; URI parameter. | N | |||||
| Description | User-defined; description of this record. | String; URI parameter. | N | |||||
| Action | Type of Action | String; URI parameter. | N | |||||
| Member of Business Services | Business Services that this record belongs to. XML
JSON | String; URI parameter. | N | |||||
| Event | event name | String; URI parameter. | N | |||||
| Task | task name | String; URI parameter. | N |
List Webhooks: Example Response
XML | JSON | ||||||||
---|---|---|---|---|---|---|---|---|---|
|
"opswiseGroups": ["group1","group2"]
N
retainSysIds
n/a
Specification for whether or not the Create a Webhook web service will persist the sysId property.
If retainSysIds="true" and
sysId
is included in the request/response,sysId
will be persisted to the database.If retainSysIds="false" and
sysId
is included in the request/response,sysId
will be ignored; it will be autogenerated by the Controller.
Note
In XML web services, retainSysIds
is specified as an attribute in the <webhook> element.
Valid values: true/false (default is true).
N
action
Action
Type of Action to perform
Valid Values:
As String = URL, As Value = 1
As String = Launch Task, As Value = 2
Default is URL (1).
Y
event
Event
Universal Event Template name.
XML
Code Block | ||
---|---|---|
| ||
<event label="Test Event A">test_event_a</event> |
JSON
Code Block | ||
---|---|---|
| ||
"event": {
"label": "Test Event A",
"value": "test_event_a"
} |
Note |
---|
Only system level event templates will be allowed. |
The label
is included when reading a Webhook; however, it is ignored when creating/updating a Webhook.
Y
filter
Event Criteria
|
|
Modify Webhooks
Description | |
---|---|
URI | http://host_name/uc/resources/webhook |
HTTP Method | PUT |
Description | Modify a webhook. |
Example URI | |
Authentication | HTTP Basic |
Payload Properties | See Register a Webhook: Payload Properties. |
Produces Content-Type | Application/XML Application/JSON |
Consumes Content-Type | Application/XML Application/JSON |
Example Responses |
|
Modify Webhooks: Example Request
XML | JSON | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Read a Webhook
Description | |
---|---|
URI | http://host_name/uc/resources/webhook |
HTTP Method | GET |
Description | Read webhook registration. |
Example URI | |
Authentication | HTTP Basic |
Produces Content-Type | |
Consumes Content-Type | |
Example Responses | Read Webhook: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|---|
| ID used within the Controller to identify this webhook. | String; URI parameter. | Y |
| |
| Name | Name used within the Controller to identify this webhook. | String; URI parameter. | Y |
|
Read a Webhook: Example Response
XML | JSON | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Register a Webhook
Description | |
---|---|
URI | http://host_name/uc/resources/webhook |
HTTP Method | POST |
Description | Register a webhook. |
Example URI | |
Authentication | HTTP Basic |
Produces Content-Type | Application/XML Application/JSON |
Consumes Content-Type | Application/XML Application/JSON |
Example Request | See Register a Webhook: Example Request |
Example Responses |
|
Anchor | ||||
---|---|---|---|---|
|
Register a Webhook: Payload Properties
Property | UI Field Name | Description | Specifications | Required | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Webhook Name | Name of the Webhook. | Y | |||||||||||||
| Description | User-defined; description of this record. | N | |||||||||||||
| Member of Business Services | Business Services that this record belongs to.
JSON
| N | |||||||||||||
| n/a | Specification for whether or not the Create a Webhook web service will persist the sysId property.
Note In XML web services, | Valid values: true/false (default is true). | N | ||||||||||||
| Action | Type of Action to perform | Valid Values:
Default is URL (1). | Y | ||||||||||||
| Event | Universal Event Template name. XML
JSON
| The | Y | ||||||||||||
| Event Criteria | Universal Event criteria to to execute the webhook. | N | |||||||||||||
| URL | full URL of the action to be executed. (Including parameters) | Y (if action | |||||||||||||
| Task | Task of the action to be executed. (Including parameters) | Y (if action | |||||||||||||
| HTTP Authentication | HTTP authentication scheme to use. | Valid values:
Default is None (0). | N | ||||||||||||
| HTTP Headers | HTTP headers. | Format:
| N | ||||||||||||
| URL Query Parameters | Any query parameters to be encoded as a query string and appended to the URL. | Format:
| N | ||||||||||||
| Credentials | Credentials to be used to authenticate | N |
...
XML Request | JSON Request | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Unassign an Execution User from a Webhook
Description | URI | ||
---|---|---|---|
HTTP Method | POST | ||
Description | Unassigns an Execution User to the specified webhook. | ||
Example URI | http://localhost:8080/uc/resources/webhook/unassignexecutionuser?webhookid= http://localhost:8080/uc/resources/webhook/unassignExecutionUser?webhookname= | ||
Authentication | HTTP Basic | ||
Consumes Content-Type | application/xml, application/json | ||
Produces Content-Type | N/A | ||
Example Request | See Unassign an Execution User to a Trigger: URI Parameters. | ||
Example Response | Status 200 /OK Successfully unassigned execution user "test" to webhook "testWebhook".
|
Unassign an Execution User from a Webhook
Description | |
---|---|
URI | http://host_name/uc/resources/webhook/unassignexecutionuser |
HTTP Method | POST |
Description | Unassigns an Execution User to the specified webhook. |
Example URI | http://localhost:8080/uc/resources/webhook/unassignexecutionuser?webhookid= http://localhost:8080/uc/resources/webhook/unassignExecutionUser?webhookname= |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | N/A |
Example Response |
|
Unassign an Execution User from a Webhook: Query Parameters
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|---|
| ID used within the Controller to identify this webhook. | String; URI parameter. | Y |
| |
| Name | Name used within the Controller to identify this webhook. | String; URI parameter. | Y |
|
Unregister a Webhook
Description | |
---|---|
URI | http://host_name/uc/resources/webhook |
HTTP Method | DELETE |
Description | Unregister a webhook. |
Example URI | |
Authentication | HTTP Basic |
Produces Content-Type | |
Consumes Content-Type | |
Example Responses |
|
...