查询通知列表
功能介绍
本接口用于查询通知列表。
调用方法
请参见如何调用API。
URI
GET /v1/agents/{agent_id}/notices
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
agent_id |
是 |
String |
可信计算节点id。 支持数字,英文字母,下划线,长度32。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
是 |
Integer |
起始位置,取值0-2147483647。取值为0时系统默认返回第1页,与取值为1相同。 |
limit |
是 |
Integer |
查询个数,查询返回通知消息的个数,取值0-100,默认值为0。 |
filter |
否 |
String |
过滤条件,可用于筛选通知,筛选的条件可选择为空间创建人或者空间名称 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用接口获取用户Token接口获取。 |
X-Language |
是 |
String |
根据自己偏好的语言来获取不同语言的返回内容,zh-cn或者en_us |
Content-Type |
是 |
String |
消息体的类型(格式),必选,默认取值为“application/json”,有其他取值时会在具体接口中专门说明。 |
请求示例
查询通知列表
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 |
内部服务器错误 |