Add notifications API specs

model/_plugins/notifications/config.smithy

@@ -0,0 +1,133 @@
+//  SPDX-License-Identifier: Apache-2.0
+//
+//  The OpenSearch Contributors require contributions made to
+//  this file be licensed under the Apache-2.0 license or a
+//  compatible open source license.
+
+$version: "2"
+namespace OpenSearch
+
+structure NotificationsConfig {
+    config_id: String,
+    @required
+    config: NotificationsConfigItem
+}
+
+@documentation("Type of notification configuration.")
+enum NotificationConfigType {
+    SLACK = "slack",
+    CHIME = "chime",
+    MICROSOFT_TEAMS = "microsoft_teams",
+    WEBHOOK = "webhook",
+    EMAIL = "email",
+    SNS = "sns",
+    SES_ACCOUNT = "ses_account",
+    SMTP_ACCOUNT = "smtp_account",
+    EMAIL_GROUP = "email_group"
+}
+
+structure NotificationsConfigItem {
+    @required
+    name: String,
+    description: String
+    @required
+    config_type: NotificationConfigType,
+    is_enabled: Boolean,
+    sns: SnsItem,
+    slack: SlackItem,
+    chime: Chime,
+    webhook: Webhook,
+    smtp_account: SmtpAccount,
+    ses_account: SesAccount,
+    email_group: EmailGroup,
+    email: Email,
+    microsoft_teams: MicrosoftTeamsItem
+}
+
+structure MicrosoftTeamsItem {
+    @required
+    url: String
+}
+
+structure SlackItem {
+    @required
+    url: String
+}
+
+structure SnsItem {
+    @required
+    topic_arn: String,
+    role_arn: String
+}
+
+structure Chime {
+    @required
+    url: String
+}
+
+enum HttpMethodType {
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH"
+}
+
+map HeaderParamsMap {
+    key: String
+    value: Integer
+}
+
+structure Webhook {
+    @required
+    url: String,
+    method: HttpMethodType,
+    header_params: HeaderParamsMap,
+}
+
+enum EmailEncryptionMethod {
+    SSL = "ssl",
+    START_TLS = "start_tls",
+    NONE = "none"
+}
+
+structure SmtpAccount {
+    @required
+    host: String,
+    @required
+    port: Integer,
+    @required
+    method: EmailEncryptionMethod,
+    @required
+    from_addess: String
+}
+
+structure SesAccount {
+    @required
+    region: String,
+    role_arn: String,
+    @required
+    from_addess: String
+}
+
+list EmailGroupIdList {
+    member: String
+}
+
+list RecipientList {
+    member: RecipientListItem
+}
+
+structure RecipientListItem {
+    recipient: String
+}
+
+structure EmailGroup {
+    @required
+    recipient_list: RecipientList,
+    email_group_id_list: EmailGroupIdList
+}
+
+structure Email {
+    @required
+    email_account_id: String,
+    recipient_list: RecipientList
+}

model/_plugins/notifications/create_config/operations.smithy

@@ -0,0 +1,22 @@
+//  SPDX-License-Identifier: Apache-2.0
+//
+//  The OpenSearch Contributors require contributions made to
+//  this file be licensed under the Apache-2.0 license or a
+//  compatible open source license.
+
+$version: "2"
+namespace OpenSearch
+
+@externalDocumentation(
+    "API Reference": "https://opensearch.org/docs/latest/observing-your-data/notifications/api/#create-channel-configuration"
+)
+
+@xOperationGroup("notifications.create_config")
+@xVersionAdded("2.0")
+@suppress(["HttpUriConflict"])
+@http(method: "POST", uri: "/_plugins/_notifications/configs")
+@documentation("Create channel configuration.")
+operation NotificationsConfigs_Post {
+    input: NotificationsConfigs_Post_Input,
+    output: NotificationsConfigs_Post_Output
+}

model/_plugins/notifications/create_config/structures.smithy

@@ -0,0 +1,20 @@
+//  SPDX-License-Identifier: Apache-2.0
+//
+//  The OpenSearch Contributors require contributions made to
+//  this file be licensed under the Apache-2.0 license or a
+//  compatible open source license.
+
+$version: "2"
+namespace OpenSearch
+
+@input
+structure NotificationsConfigs_Post_Input {
+    @required
+    @httpPayload
+    content: NotificationsConfig
+}
+
+@output
+structure NotificationsConfigs_Post_Output {
+    config_id: String
+}

model/_plugins/notifications/delete_config/operations.smithy

@@ -0,0 +1,34 @@
+//  SPDX-License-Identifier: Apache-2.0
+//
+//  The OpenSearch Contributors require contributions made to
+//  this file be licensed under the Apache-2.0 license or a
+//  compatible open source license.
+
+$version: "2"
+namespace OpenSearch
+
+@externalDocumentation(
+    "API Reference": "https://opensearch.org/docs/latest/observing-your-data/notifications/api/#delete-channel-configuration"
+)
+
+@xOperationGroup("notifications.delete_config")
+@xVersionAdded("2.0")
+@idempotent
+@suppress(["HttpUriConflict"])
+@http(method: "DELETE", uri: "/_plugins/_notifications/configs/{config_id}")
+@documentation("Delete channel configuration.")
+operation NotificationsConfigs_Delete_WithPathParams {
+    input: NotificationsConfigs_Delete_WithPathParams_Input,
+    output: NotificationsConfigs_Delete_Output
+}
+
+@xOperationGroup("notifications.delete_config")
+@xVersionAdded("2.2")
+@idempotent
+@suppress(["HttpUriConflict"])
+@http(method: "DELETE", uri: "/_plugins/_notifications/configs")
+@documentation("Delete channel configuration.")
+operation NotificationsConfigs_Delete_WithQueryParams {
+    input: NotificationsConfigs_Delete_WithQueryParams_Input,
+    output: NotificationsConfigs_Delete_Output
+}

model/_plugins/notifications/delete_config/structures.smithy

@@ -0,0 +1,55 @@
+//  SPDX-License-Identifier: Apache-2.0
+//
+//  The OpenSearch Contributors require contributions made to
+//  this file be licensed under the Apache-2.0 license or a
+//  compatible open source license.
+
+$version: "2"
+namespace OpenSearch
+
+@input
+structure NotificationsConfigs_Delete_WithPathParams_Input {
+    @required
+    @httpLabel
+    config_id: String
+}
+
+@input
+structure NotificationsConfigs_Delete_WithQueryParams_Input {
+    @httpQuery("config_id")
+    @documentation("A channel ID.")
+    config_id: String,
+
+    @httpQuery("config_id_list")
+    @documentation("A comma-separated list of channel IDs.")
+    config_id_list: String
+}
+
+structure NotificationsConfigs_Delete_Output {
+    delete_response_list: DeleteResponseList
+}
+
+map DeleteResponseList {
+    key: String
+    value: RestStatus
+}
+
+enum RestStatus {
+    CONTINUE = "continue",
+    SWITCHING_PROTOCOLS = "switching_protocols",
+    OK = "ok",
+    CREATED = "created",
+    ACCEPTED = "accepted",
+    NON_AUTHORITATIVE_INFORMATION = "non_authoritative_information",
+    NO_CONTENT = "no_content",
+    RESET_CONTENT = "reset_content",
+    PARTIAL_CONTENT = "partial_content",
+    MULTI_STATUS = "multi_status",
+    MULTIPLE_CHOICES = "multiple_choices",
+    MOVED_PERMANENTLY = "moved_permanently",
+    FOUND = "found",
+    SEE_OTHER = "see_other",
+    NOT_MODIFIED = "not_modified",
+    USE_PROXY = "use_proxy",
+    TEMPORARY_REDIRECT = "temporary_redirect"
+}

model/_plugins/notifications/get_configs/operations.smithy

@@ -0,0 +1,34 @@
+//  SPDX-License-Identifier: Apache-2.0
+//
+//  The OpenSearch Contributors require contributions made to
+//  this file be licensed under the Apache-2.0 license or a
+//  compatible open source license.
+
+$version: "2"
+namespace OpenSearch
+
+@externalDocumentation(
+    "API Reference": "https://opensearch.org/docs/latest/observing-your-data/notifications/api/#get-channel-configuration"
+)
+
+@xOperationGroup("notifications.get_config")
+@xVersionAdded("2.0")
+@readonly
+@suppress(["HttpUriConflict"])
+@http(method: "GET", uri: "/_plugins/_notifications/configs")
+@documentation("Get channel configuration.")
+operation NotificationsConfigs_Get {
+    input: NotificationsConfigs_Get_Input,
+    output: NotificationsConfigs_Get_Output
+}
+
+@xOperationGroup("notifications.get_config")
+@xVersionAdded("2.0")
+@readonly
+@suppress(["HttpUriConflict"])
+@http(method: "GET", uri: "/_plugins/_notifications/configs/{config_id}")
+@documentation("Get channel configuration.")
+operation NotificationsConfigsItem_Get {
+    input: NotificationsConfigsItem_Get_Input,
+    output: NotificationsConfigs_Get_Output
+}