文档首页/ 可信智能计算服务 TICS/ API参考/ 计算节点API/ 通知管理/ 查询通知列表 - listNotices_tenant
更新时间：2025-11-04 GMT+08:00
查看PDF
分享

查询通知列表 - listNotices_tenant

功能介绍

本接口用于查询通知列表。

调用方法

请参见如何调用API。

URI

GET /v1/agents/{agent_id}/notices

表1 路径参数

参数

是否必选

参数类型

描述

agent_id

是

String

可信计算节点id。

支持数字，英文字母，下划线，长度32。
表2 Query参数

参数

是否必选

参数类型

描述

offset

是

Integer

起始位置，取值0-2147483647。取值为0时系统默认返回第1页，与取值为1相同。

limit

是

Integer

查询个数，查询返回通知消息的个数，取值0-100，默认值为0。

filter

否

String

过滤条件，可用于筛选通知，筛选的条件可选择为空间创建人或者空间名称

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用接口获取用户Token接口获取。

X-Language

是

String

根据自己偏好的语言来获取不同语言的返回内容，zh-cn或者en_us

Content-Type

是

String

消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

total

Long

总个数

lists

Array of NoticeListVo objects

通知列表
表5 NoticeListVo

参数

参数类型

描述

id

String

通知记录id。

支持数字，英文字母，下划线，长度32。

notice_type

String

通知类型

creator_partner_alias

String

通知创建者别名

notice_status

String

通知处理状态

create_time

String

创建时间

handle_time

String

处理时间

请求示例

查询通知列表

get https://x.x.x.x:12345/v1/agents/{agent_id}/notices?offset=0&limit=10

响应示例

状态码：200

查询通知列表成功

{
  "total" : 1,
  "lists" : [ {
    "id" : "3a6e70c4b3a849fa9faffc480c903c9b",
    "notice_type" : "DATASET_USE_APPROVAL",
    "creator_partner_alias" : "space_creator",
    "notice_status" : "OPEN"
  } ],
  "create_time" : "2022-02-25T03:12:09.296+00:00"
}

状态码

状态码

描述

200

查询通知列表成功

401

操作无权限

500

内部服务器错误
父主题： 通知管理

相关文档