SessionList
本页内容
当前可查询的临时凭据列表。使用 next_cursor 分页,并按会话 ID 查询和管理已有授权。
如何阅读本模型
先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。
应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。
字段定义
“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。
| 字段 | 必需 | 说明 |
|---|---|---|
items |
是 | 与当前请求条件匹配的记录。数组元素的字段见下方各行。 |
items[].id |
是 | 该条记录的公开标识。调用后续接口时请完整保留,包括前缀。 查看取值约束
|
items[].app_id |
是 | 业务应用的完整 ID,来自列出应用或预留新应用的响应。 查看取值约束
|
items[].name |
是 | 签发时填写的临时只读凭据名称。 查看取值约束
|
items[].actions |
是 | 授权动作名称。查询或修改资源时仍须满足资源范围和来源 IP 条件。 |
items[].actions[] |
是 | 数组中每个元素的取值要求。 查看取值约束
|
items[].rpm |
是 | 每分钟最多允许的请求次数,同时受账号和 API 应用额度约束。 查看取值约束
|
items[].created_at |
是 | 记录创建时间,Unix 秒。 |
items[].expires_at |
是 | 此临时凭据的截止时间,Unix 秒;同时受原父密钥和授权是否有效限制。 |
items[].last_used_at |
是 | 最近一次使用凭据的时间,Unix 秒。0 表示尚无记录。 |
items[].state |
是 | 当前记录的处理状态或请求筛选的状态。 查看取值约束
|
next_cursor |
是 | 传给下一次请求的 cursor。为 null 表示已到末页。 查看取值约束
|
相关接口
下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。