Overview
Provides an interface to the notification service.
Version information
Version : 0.9.142 (BETA)
License information
License : Apache 2.0
Terms of service : https://www.cloudera.com/legal/commercial-terms-and-conditions.html
URI scheme
Schemes : HTTPS
Consumes
-
application/json
Produces
-
application/json
Paths
CreateOrUpdateAccountMetadata
POST /api/v1/notification/createOrUpdateAccountMetadata
Description
Creates or Updates Account metadata, such as allowed domains list for the Account.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
CreateOrUpdateDistributionList
POST /api/v1/notification/createOrUpdateDistributionList
Description
Creates or updates a distribution list with the given preferences.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
CreateOrUpdateResourceSubscription
POST /api/v1/notification/createOrUpdateResourceSubscription
Description
Creates or Updates the subscription with events and channel preferences provided by user.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
DeleteAllSubscriptionsForResource
POST /api/v1/notification/deleteAllSubscriptionsForResource
Description
Deletes Resource subscription by resource or user CRN.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
API endpoint used to delete app registration
POST /api/v1/notification/deleteAppRegistration
Description
Used to delete App Registration.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
DeleteDistributionList
POST /api/v1/notification/deleteDistributionList
Description
Deletes a distribution list.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
DeleteDistributionListsForResource
POST /api/v1/notification/deleteDistributionListsForResource
Description
Deletes distribution lists for the resource CRN.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
DeleteResourceSubscription
POST /api/v1/notification/deleteResourceSubscription
Description
Deletes user subscription for the resourceCrn.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
DeleteResourceSubscriptionsForResource
POST /api/v1/notification/deleteResourceSubscriptionsForResource
Description
Deletes Resource subscription by resource or user CRN.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
GetAccountMetadata
POST /api/v1/notification/getAccountMetadata
Description
Fetches the Account metadata such as allowed email domains.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
API endpoint to get AppRegistrationStatus
POST /api/v1/notification/getAppRegistrationStatus
Description
Fetches the app registration status for the tenant.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
GetDistributionList
POST /api/v1/notification/getDistributionList
Description
Fetches an existing distribution list with events and channel preferences.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
GetOAuthURL
POST /api/v1/notification/getOAuthUrl
Description
Fetches the OAuth Request Url for the App Integrations.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
GetResourceSubscription
POST /api/v1/notification/getResourceSubscription
Description
Fetches existing resource subscription with events and channel preferences.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
ListDistributionLists
POST /api/v1/notification/listDistributionLists
Description
Lists all distribution lists.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
Lists all the types of resource events available in the catalog.
POST /api/v1/notification/listResourceEventCatalog
Description
Lists all the types of resource events available in the catalog.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
ListResourceSubscriptions
POST /api/v1/notification/listResourceSubscriptions
Description
Lists all resource subscriptions for a user.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
API endpoint to get UpdateAppAuthorizationCode
POST /api/v1/notification/updateAppAuthorizationCode
Description
Registers/Updates the App temporary authorization code with the Notification Service.
Parameters
Type | Name | Schema |
---|---|---|
Body |
input |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 |
Expected response to a valid request. |
|
default |
The default response on an error. |
Definitions
ChannelType
Represents the types of channels.
Type : enum (UNKNOWN, EMAIL, IN_APP, SLACK)
CreateOrUpdateAccountMetadataRequest
Request object for the CreateOrUpdateAccountMetadata.
Name | Description | Schema |
---|---|---|
allowedDomains |
The list of allowed domains for the Account. |
< string > array |
CreateOrUpdateAccountMetadataResponse
Response object for the CreateOrUpdateAccountMetadata.
Type : object
CreateOrUpdateDistributionListRequest
Request object to create or update a distribution list.
Name | Description | Schema |
---|---|---|
distributionListId |
Optional identifier of an existing distribution list, if specified, is used for an update. |
string |
distributionListManagementType |
SYSTEM_MANAGED: Created by internal actors, modifiable only by internal users. USER_MANAGED: Created by non-internal actors, modifiable by internal or external users |
string |
emailAddresses |
List of recipient email addresses. |
< string > array |
eventChannelPreferences |
Channel preference for individual events to be subscribed to, does not require notification type. |
< EventChannelPreference > array |
parentResourceCrn |
Parent resource crn for which the resource authorization has to be done. |
string |
resourceCrn |
CRN of resource to create a topic for. |
string |
resourceName |
The name of the resource to be subscribed. |
string |
slackChannelIds |
List of recipient Slack channel identifiers. |
< string > array |
CreateOrUpdateDistributionListResponse
Response object for creating or updating the distribution list.
Name | Description | Schema |
---|---|---|
distributionListDetails |
Contains details of the distribution lists created or updated. |
< DistributionListDetails > array |
CreateOrUpdateResourceSubscriptionRequest
CreateOrUpdateResourceSubscriptionRequest holds the fields required to create new subscription.
Name | Description | Schema |
---|---|---|
eventChannelPreferences |
Channel preference for the individual events. |
< EventChannelPreference > array |
existingSubscriptionId |
Existing subscription identifier, an optional parameter to be passed when updating the existing subscription. |
string |
parentResourceCrn |
Parent resource crn for which the resource authorization has to be done. |
string |
resourceCrn |
CRN of resource for which user want to subscribe. |
string |
CreateOrUpdateResourceSubscriptionResponse
CreateOrUpdateResourceSubscriptionResponse is response for subscription creation.
Name | Description | Schema |
---|---|---|
subscriptionDetails |
Contains details of the subscription created. |
DeleteAllSubscriptionsForResourceRequest
Request object for the deletion of all subscriptions by resourceCrn.
Name | Description | Schema |
---|---|---|
resourceCrn |
CRN of the resource for which all associated resource subscriptions must be deleted. |
string |
DeleteAllSubscriptionsForResourceResponse
Response object for the deletion of all subscriptions by resourceCrn.
Name | Description | Schema |
---|---|---|
recordsDeleted |
Response string which describes the number of records deleted. |
string |
DeleteAppRegistrationRequest
Request object for deleting the App registration
Name | Description | Schema |
---|---|---|
notificationType |
Notification identifier for the apps |
DeleteAppRegistrationResponse
Response object for deleting the App registration
Type : object
DeleteDistributionListRequest
The request object for deleting a distribution list.
Name | Description | Schema |
---|---|---|
distributionListId |
The identifier of the distribution list to be deleted. |
string |
DeleteDistributionListResponse
The response object for deleting a distribution list.
Type : object
DeleteDistributionListsForResourceRequest
Request object for the deletion of Distribution List by resourceCrn.
Name | Description | Schema |
---|---|---|
resourceCrn |
CRN of resource for which the resource subscriptions has to be delete. |
string |
DeleteDistributionListsForResourceResponse
Response object for the deletion of Distribution List by resourceCrn.
Name | Description | Schema |
---|---|---|
recordsDeleted |
Response string which describes the number of records deleted. |
string |
DeleteResourceSubscriptionRequest
DeleteResourceSubscriptionRequest holds the fields required to delete any existing subscription.
Name | Description | Schema |
---|---|---|
subscriptionId |
The subscription identifier of the subscription to be deleted for the user. |
string |
DeleteResourceSubscriptionResponse
The response object for deleteResourceSubscription.
Type : object
DeleteResourceSubscriptionsForResourceRequest
Request object for the deletion of Subscriptions.
Name | Description | Schema |
---|---|---|
resourceCrn |
CRN of resource for which the resource subscriptions has to be delete. |
string |
DeleteResourceSubscriptionsForResourceResponse
Response object for the deletion of Subscriptions.
Name | Description | Schema |
---|---|---|
recordsDeleted |
Response string which describes the number of records deleted. |
string |
DistributionList
The list of distribution lists.
Name | Description | Schema |
---|---|---|
distributionListId |
The distribution list identifier. |
string |
distributionListManagementType |
Attribute to identify system vs user managed distribution list. |
|
emailAddresses |
The list of email addresses if configured. |
< string > array |
parentResourceCrn |
CRN of the parent resource of the Distribution List’s resource. |
string |
resourceCrn |
CRN of resource the group has subscribed to. |
string |
resourceName |
The name of the resource to be subscribed. |
string |
resourceType |
Type of resource. This should be service name as represented in a CRN. |
string |
slackChannelIds |
The list of Slack channel ids configured. |
< string > array |
subscribedEvents |
List of all events subscribed under the given resource. |
< SubscribedEvents > array |
DistributionListDetails
Details of the distribution list.
Name | Description | Schema |
---|---|---|
distributionListId |
Identifier of the distribution list. |
string |
resourceCrn |
The resourceCrn of the subscription. |
string |
DistributionListManagementType
Represents the management types of distribution list.
Type : enum (USER_MANAGED, SYSTEM_MANAGED)
Error
An object returned on an error.
Name | Description | Schema |
---|---|---|
code |
The error code. |
string |
message |
The error message. |
string |
EventCatalog
The details of the events present in the event catalog.
Name | Description | Schema |
---|---|---|
eventDescription |
Description of the event in the catalog. |
string |
eventName |
Name of the event in the catalog. |
string |
eventSeverityLists |
List of severity for the catalog. |
< string > array |
eventTypeId |
ID of the event in the catalog. |
string |
targetedEventType |
Type of the targeted event. Either user_targeted or resource_targeted. |
EventChannelPreference
EventChannelPreference contains event identifier and its channel preference.
Name | Description | Schema |
---|---|---|
channels |
The channel preference for the event where the event notification has to be delivered. e.g.: IN_APP, EMAIL |
< ChannelType > array |
eventSeverityLists |
The chosen severity list for the particular event. |
< string > array |
eventTypeId |
The event identifier. |
string |
GetAccountMetadataRequest
Request object for fetching the Account metadata.
Type : object
GetAccountMetadataResponse
Response object for the GetAccountMetadata.
Name | Description | Schema |
---|---|---|
allowedDomains |
Get allowed domains for the Account. |
< string > array |
GetAppRegistrationStatusRequest
Request object to for GetAppRegistrationStatus
Name | Description | Schema |
---|---|---|
notificationType |
Notification identifier for the apps |
GetAppRegistrationStatusResponse
Response object to for GetAppRegistrationStatus
Name | Description | Schema |
---|---|---|
appRegistrationStatus |
The App app registration status for the tenant. |
string |
GetDistributionListRequest
Request object for fetching a distribution list.
Name | Description | Schema |
---|---|---|
distributionListId |
The identifier for which the distribution list is requested. |
string |
GetDistributionListResponse
Response object for the GetDistributionList.
Name | Description | Schema |
---|---|---|
distributionList |
Contains details of the distribution list fetched. |
GetOAuthUrlRequest
Request object to for GetOAuthUrl
Type : object
GetOAuthUrlResponse
Response object to for GetOAuthUrl
Name | Description | Schema |
---|---|---|
requestUrl |
OAuth Request url. |
string |
GetResourceSubscriptionRequest
Request object for the GetResourceSubscription.
Name | Description | Schema |
---|---|---|
resourceCrn |
The resource crn for which the subscription is requested. |
string |
GetResourceSubscriptionResponse
Response object for the GetResourceSubscription.
Name | Description | Schema |
---|---|---|
resourceSubscription |
Contains details of the resource subscription fetched. |
ListDistributionListsRequest
The request object for listing the distribution lists.
Name | Description | Schema |
---|---|---|
distributionListManagementType |
The optional distribution list management type, if specified, only distribution lists related to this type will be returned. |
string |
pageSize |
The page size. |
integer (int32) |
pageToken |
A token to specify where to start paginating. This is the nextToken from a previously truncated response. |
string |
resourceCrn |
The optional resource CRN, if specified, only distribution lists related to this resource will be returned. |
string |
ListDistributionListsResponse
The response object for listing the distribution lists.
Name | Description | Schema |
---|---|---|
distributionLists |
List of distribution lists. |
< DistributionList > array |
nextPageToken |
The token to use when requesting the next set of results. If not present, there are no additional results. |
string |
totalSubscriptions |
This field represents the total number of resource subscriptions. |
integer (int32) |
ListResourceEventCatalogRequest
The request object to list all the types of resource events available in the catalog.
Name | Description | Schema |
---|---|---|
resourceCrn |
The resource CRN to which the resource catalog events are associated with. |
string |
ListResourceEventCatalogResponse
The response object to list all the types of resource events available in the catalog.
Name | Description | Schema |
---|---|---|
resourceEvents |
List of resource events that the user can potentially subscribe to. |
< EventCatalog > array |
ListResourceSubscriptionsRequest
The request object for listing the resource subscriptions.
Name | Description | Schema |
---|---|---|
pageSize |
The page size. |
integer (int32) |
pageToken |
A token to specify where to start paginating. This is the nextToken from a previously truncated response. |
string |
resourceCrn |
The optional resource CRN, if specified, only subscriptions related to this resource will be returned. |
string |
ListResourceSubscriptionsResponse
The response object for listing the resource subscriptions.
Name | Description | Schema |
---|---|---|
nextPageToken |
The token to use when requesting the next set of results. If not present, there are no additional results. |
string |
resourceSubscriptions |
List of resource subscriptions for the user. |
< ResourceSubscription > array |
totalSubscriptions |
This field represents the total number of resource subscriptions. |
integer (int32) |
NotificationAppType
Contains details regarding Notification Type
SLACK
- default
Type : enum (SLACK)
ResourceSubscription
ResourceSubscription holds a list of subscribed events and delivery details for a particular resource.
Name | Description | Schema |
---|---|---|
parentResourceCrn |
CRN of the parent resource of the resource for which the notification event is subscribed. |
string |
resourceCrn |
CRN of resource for which the event is subscribed. |
string |
resourceName |
Name of the resource for which the event is scoped to. This should be resource name as represented in a CRN. |
string |
serviceName |
Name of the service for which the event is scoped to. This should be service name as represented in a CRN. |
string |
subscribedEvents |
List of all events subscribed under the given resource. |
< SubscribedEvents > array |
subscriptionId |
The Subscription identifier. |
string |
SubscribedEvents
Details related to a subscribed event.
Name | Description | Schema |
---|---|---|
channels |
Subscribed channel preferences of the event. |
< ChannelType > array |
description |
Description of the event. |
string |
eventName |
Name of an event. |
string |
eventSeverityLists |
The list of severity for the event. |
< string > array |
eventTypeId |
ID of an event. |
string |
SubscriptionDetails
Contains details of the subscription created.
Name | Description | Schema |
---|---|---|
resourceCrn |
The resourceCrn of the subscription. |
string |
subscriptionId |
Identifier of the newly created subscription. |
string |
userCrn |
The userCrn of the subscription. |
string |
TargetedEventType
Represents the type of the targeted event.
Type : enum (RESOURCE_TARGETED, USER_TARGETED)
UpdateAppAuthorizationCodeRequest
Request object for getting the temporary authorization code.
Name | Description | Schema |
---|---|---|
notificationType |
Notification identifier for the apps |
|
temporaryAuthorizationCode |
The App temporary authorization code which needs to be passed to backend notification service. |
string |
UpdateAppAuthorizationCodeResponse
Response object for the UpdateAppAuthorizationCode.
Type : object