Help Center/ Identity and Access Management_Identity and Access Management (New Edition)/ API Reference/ API/ Access Analyzer/ Message Notification Configuration/ Deleting a Message Notification Configuration
Updated on 2026-07-22 GMT+08:00
View PDF
Share

Deleting a Message Notification Configuration

Function

This API is used to delete a message notification configuration.

Authorization Information

Each account root user 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:delete

Write

notificationSetting *

-

-

-

URI

DELETE /v5/notification-settings/{notification_setting_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

notification_setting_id

Yes

String

Definition:

Unique identifier of the message notification configuration.

You can call ListNotificationSettings API. This API returns a list of message notification configurations. Each configuration summary object in the list contains a unique id field, which is the message notification configuration ID.

Range:

1 to 36 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

Request Parameters

None

Response Parameters

Status code: 204

Deleted

Status code: 400

Table 2 Response body parameters

Parameter

Type

Description

error_code

String

Definition:

Error code.

Range:

N/A

error_msg

String

Definition:

Error message.

Range:

N/A

request_id

String

Definition:

Request ID.

Range:

N/A

encoded_authorization_message

String

Definition:

Authentication information.

Range:

N/A

Status code: 403

Table 3 Response body parameters

Parameter

Type

Description

error_code

String

Definition:

Error code.

Range:

N/A

error_msg

String

Definition:

Error message.

Range:

N/A

request_id

String

Definition:

Request ID.

Range:

N/A

encoded_authorization_message

String

Definition:

Authentication information.

Range:

N/A

Example Requests

This API is used to delete a message notification configuration.

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

Example Responses

None

Status Codes

Status Code

Description

204

Deleted

400

Bad request

403

Forbidden

Error Codes

See Error Codes.