Obtaining Instance Alarm Configurations

Function

URI

GET /v2/{project_id}/audit/{instance_id}/alarm/topic

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Parameter description: Specifies the project ID. You can obtain the value by calling the IAM API for querying the project list of a specified IAM user. Restrictions: N/A Value range: The value is subject to the return value of the IAM service interface. The value contains 32 to 64 characters. Default value: N/A
instance_id	Yes	String	Parameter description: Instance ID. The value can be obtained from the ID field of the API for querying the instance list. Restrictions: N/A Value range: The value is subject to the value of the API for querying the instance list. The value contains 32 to 64 characters. Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Parameter description: User token. You can obtain the token by calling the IAM API used to query the user token. The token is the value of X-Subject-Token in the response header. Restrictions: N/A Value range: Used by the IAM service to query the user token. Default value: N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
alarm_cpu	String	Specifies the CPU alarm threshold.
alarm_disk	String	Specifies the disk alarm threshold.
alarm_memory	String	Specifies the memory alarm threshold.
alarm_num	String	Daily alarms
alarm_risk	Array of strings	Alarm severity high: high medium: medium low: low
alarm_switch	String	Notification switch ON: enabled OFF: disabled
alarm_topic_urn	String	URN of the notification topic. You can call the SMN API to obtain the URN.
smn_effective	Boolean	Specifies whether SMN subscription is supported. true: support false: not supported

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
details	Array of DbssErrorDetail objects	PDP5 authentication exception information
encoded_authorization_message	String	PDP5 authentication exception information
error_code	String	Error Codes
error_msg	String	Error message.

**Table 5** DbssErrorDetail
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	PDP5 error information

Status code: 401

**Table 6** Response body parameters
Parameter	Type	Description
details	Array of DbssErrorDetail objects	PDP5 authentication exception information
encoded_authorization_message	String	PDP5 authentication exception information
error_code	String	Error Codes
error_msg	String	Error message.

**Table 7** DbssErrorDetail
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	PDP5 error information

Status code: 403

**Table 8** Response body parameters
Parameter	Type	Description
details	Array of DbssErrorDetail objects	PDP5 authentication exception information
encoded_authorization_message	String	PDP5 authentication exception information
error_code	String	Error Codes
error_msg	String	Error message.

**Table 9** DbssErrorDetail
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	PDP5 error information

Status code: 500

**Table 10** Response body parameters
Parameter	Type	Description
details	Array of DbssErrorDetail objects	PDP5 authentication exception information
encoded_authorization_message	String	PDP5 authentication exception information
error_code	String	Error Codes
error_msg	String	Error message.

**Table 11** DbssErrorDetail
Parameter	Type	Description
error_code	String	Error Codes
error_msg	String	PDP5 error information

Example Requests

/v2/{project_id}/audit/{instance_id}/alarm/topic

Example Responses

Status code: 200

{
  "alarm_cpu" : 80,
  "alarm_disk" : 80,
  "alarm_memory" : 80,
  "alarm_num" : 10,
  "alarm_risk" : [ "high", "low" ],
  "alarm_switch" : false,
  "alarm_topic_urn" : "urn:smn:cn-north-7:b9351f98c724428xxxxxxxxx:DBSS-Message",
  "smn_effective" : false
}