DescribeNotificationItems
更新时间:2024-11-22 11:03:13
PDF
获取通知项列表。
可根据通知项 ID,通知列表 ID 或通知类型作过滤条件,来获取通知项的列表。 如果不指定任何过滤条件,默认返回你的所有通知项。
Request Parameters
Parameter name | Type | Description | Required |
---|---|---|---|
notification_items |
Array |
通知项 ID |
No |
notification_list |
String |
通知列表 ID ,可返回指定通知列表中的通知项。 |
No |
notification_item_type |
String |
通知项类型:email, phone, webhook |
No |
offset |
Integer |
数据偏移量,默认为 0 |
No |
limit |
Integer |
返回数据长度,默认为 20,最大 100 |
No |
Response Elements
Name | Type | Description |
---|---|---|
action |
String |
响应动作 |
notification_items |
Array |
JSON 格式的列表,每项参数可见下面 Response Item |
total_count |
Integer |
根据过滤条件得到的通知列表总数 |
Response Item
Name | Type | Description |
---|---|---|
notification_list_id |
String |
通知列表 ID |
notification_item_id |
String |
通知列表名称 |
content |
String |
通知项内容,可以是邮箱地址,手机号或 webhook url |
create_time |
TimeStamp |
创建时间,为UTC时间,格式可参见 ISO8601. |
verification_code |
String |
验证码,可用于验证通知项 VerifyNotificationItem 。 如已完成验证,此码的值变成空字符串。 |
Example
Example Request
https://api.qingcloud.com/iaas/?action=DescribeNotificationItems &COMMON_PARAMS
Example Response
{ "action":"DescribeNotificationItemsResponse", "notification_items":[ { "verification_code":"xxxxxxxxxxxxxx", "verify_time":"2017-09-26T16:14:29Z", "content":"test@example.com", "create_time":"2017-09-26T16:14:29Z", "remarks":"tester1", "notification_item_id":"ni-xxxx", "notification_item_type":"email" } ], "total_count":1, "ret_code":0 }