Update Alert Plugin Using PUT

Before updating a notification plugin, the plugin should be disabled. During the update process if there are any untrusted certificates returned by the server the patchAlertPlugin call should be made. Once the update is successfully completed, use modifyAlertPluginState API to enable the plugin.

Request

URI

PUT

https://{api_host}/api/alertplugins

COPY

Request Body

The NotificationPlugin to create, including plugin type and configuration details

notification-plugin of type(s) application/json

Required

{
    "certificates": [
        {
            "certificateDetails": "string",
            "expires": "string",
            "issuedBy": "string",
            "issuedTo": "string",
            "thumbprint": "string"
        }
    ],
    "configValues": [
        {
            "name": "string",
            "value": "string"
        }
    ],
    "description": "string",
    "enabled": false,
    "name": "string",
    "pluginId": "string",
    "pluginTypeId": "string",
    "version": 0
}

array of certificate

certificates

Optional

Any set of untrusted certificates returned by the adapter source

array of name-value

configValues

Optional

The list of name value pairs for Plugin configuration

string

description

Optional

The description for the configuration

boolean

enabled

Optional

A read-only property whose value is set by the system

string

name

Required

The name for the configuration

string As uuid As uuid

pluginId

Optional

The Plugin Id, cannot be null during update operations

string

pluginTypeId

Optional

The plugin type identifier

integer As int64 As int64

version

Optional

A read-only version identifier. This value will be returned after getting an existing configuration. And the correct value is necessary to update an existing configuration.

Authentication

This operation uses the following authentication methods.

CSPToken

Responses

200

The updated Notification Plugin Instance

Returns notification-plugin of type(s) application/json

{
    "certificates": [
        {
            "certificateDetails": "string",
            "expires": "string",
            "issuedBy": "string",
            "issuedTo": "string",
            "thumbprint": "string"
        }
    ],
    "configValues": [
        {
            "name": "string",
            "value": "string"
        }
    ],
    "description": "string",
    "enabled": false,
    "name": "string",
    "pluginId": "string",
    "pluginTypeId": "string",
    "version": 0
}

array of certificate

certificates

Optional

Any set of untrusted certificates returned by the adapter source

array of name-value

configValues

Optional

The list of name value pairs for Plugin configuration

string

description

Optional

The description for the configuration

boolean

enabled

Optional

A read-only property whose value is set by the system

string

name

Required

The name for the configuration

string As uuid As uuid

pluginId

Optional

The Plugin Id, cannot be null during update operations

string

pluginTypeId

Optional

The plugin type identifier

integer As int64 As int64

version

Optional

A read-only version identifier. This value will be returned after getting an existing configuration. And the correct value is necessary to update an existing configuration.

On This Page

Description

Request

Request Body

Authentication

Response

200 Response Body

Alert Plugins Operations

POST

Create Alert Plugin Using POST

DELETE

Delete Alert Plugin Using DELETE