Updated on 2025-11-06 GMT+08:00

Updating a Message Notification Configuration

Function

This API is used to update a message notification configuration.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

AccessAnalyzer:notificationSetting:update

Write

notificationSetting *

-

-

-

URI

PUT /v5/notification-settings/{notification_setting_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

notification_setting_id

Yes

String

Unique identifier of the message notification configuration.

Minimum: 1

Maximum: 36

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

mc_switch

Yes

Boolean

Whether to enable message notifications.

smn_topic_urns

Yes

Array of strings

URN list of SMN topics configured for message notifications.

Response Parameters

Status code: 200

OK

Status code: 400

Table 3 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

request_id

String

Request ID.

encoded_authorization_message

String

Authentication information.

Status code: 403

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

request_id

String

Request ID.

encoded_authorization_message

String

Authentication information.

Status code: 404

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

request_id

String

Request ID.

encoded_authorization_message

String

Authentication information.

Example Requests

Updating a message notification configuration

POST https://{hostname}/v5/notification-settings/{notification_setting_id}

{
  "mc_switch" : true,
  "smn_topic_urns" : [ "urn:smn:cn-north-7:******:test1" ]
}

Example Responses

None

Status Codes

Status Code

Description

200

OK

400

Bad request

403

Forbidden

404

NotFound

Error Codes

See Error Codes.