面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/list-seat-info-usages-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

查询席位信息及用量

POST https://ark.cn-beijing.volcengineapi.com/?Action=ListSeatInfoUsages&Version=2024-01-01

批量查询多个席位的信息及用量。

鉴权#

本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。

  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数#

Body 参数#

SeatIDs string[] 必选  |  席位 ID 列表

待查询的席位 ID 列表,单次请求最多携带 1000 个。

ProjectName string 默认值 default  |  项目名称

项目名称,资源不在默认项目中时需填写实际项目名称。

响应参数#

Data object[]  |  席位用量列表

符合查询条件的席位详情数组。

AccountID integer  |  主账号 ID

Data.AccountID

席位所属火山引擎主账号 ID。

MonthlyResetMilestone integer  |  月配额刷新时间

Data.MonthlyResetMilestone

月配额资源刷新时间。

MonthlySubscribeMilestone integer  |  月配额刷新开始时间

Data.MonthlySubscribeMilestone

本月度配额资源刷新开始时间。

MonthlyUsage string  |  本月累计用量

Data.MonthlyUsage

席位本计费月(按订阅周期划分)累计用量。

ProjectName string  |  项目名称

Data.ProjectName

席位所属的项目名称。

SeatID string  |  席位 ID

Data.SeatID

席位唯一标识 ID。

ShortTermUsage string  |  近 5 分钟用量

Data.ShortTermUsage

席位最近 5 分钟的短时用量,用于实时监控限流。

UserID integer  |  绑定子用户 ID

Data.UserID

席位绑定的子用户 ID。

UserName string  |  绑定子用户名

Data.UserName

席位绑定的子用户名称。

WeeklyUsage string  |  本周累计用量

Data.WeeklyUsage

席位本计费周(按订阅周期划分)累计用量。

Total integer  |  席位总数

符合查询条件的席位总数量。