# 查询个人席位信息及用量

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

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

查询单个席位的信息和用量明细。

> **说明**
>
> 该接口适用于查看某个特定席位详细用量的场景，需传入通过 `ListSeatInfos` 接口获取的单个 `SeatID` 作为入参。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

---

<span id="request-parameters"></span>
## 请求参数

### Body 参数

**SeatID** `string` `必选` | 席位 ID

席位唯一标识 ID，可通过调用 *ListSeatInfos* 接口获取。

**ProjectName** `string` `默认值 default` | 项目名称

席位所属的项目名称，资源不在默认项目中时需填写实际项目名称。

## 响应参数

**SeatInfoUsage** `object` | 席位信息及用量

席位的基本信息和用量统计详情。

**AccountID** `integer` | 主账号 ID

`SeatInfoUsage.AccountID`

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

**MonthlyResetMilestone** `integer` | 月配额刷新时间

`SeatInfoUsage.MonthlyResetMilestone`

月配额资源刷新时间。

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

`SeatInfoUsage.MonthlySubscribeMilestone`

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

**MonthlyUsage** `string` | 本月累计用量

`SeatInfoUsage.MonthlyUsage`

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

**ProjectName** `string` | 项目名称

`SeatInfoUsage.ProjectName`

席位所属的项目名称。

**SeatID** `string` | 席位 ID

`SeatInfoUsage.SeatID`

席位唯一标识 ID。

**ShortTermUsage** `string` | 近 5 分钟用量

`SeatInfoUsage.ShortTermUsage`

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

**UserID** `integer` | 绑定子用户 ID

`SeatInfoUsage.UserID`

当前绑定该席位的子用户 ID。

**UserName** `string` | 绑定子用户名

`SeatInfoUsage.UserName`

当前绑定该席位的子用户名称。

**WeeklyUsage** `string` | 本周累计用量

`SeatInfoUsage.WeeklyUsage`

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


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetSeatInfoUsage&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
  "SeatID": "seat-cdp-01"
}
'
```

#### Response

```
{
  "ResponseMetadata": {
    "RequestId": "20260324222419087182109179D287B2",
    "Action": "GetSeatInfoUsage",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "SeatInfoUsage": {
      "SeatID": "seat-cdp-01",
      "AccountID": 2100000000,
      "ProjectName": "default",
      "UserID": 210000000000,
      "UserName": "dev_user_01",
      "MonthlySubscribeMilestone": 500,
      "MonthlyResetMilestone": 500,
      "ShortTermUsage": "12.5",
      "WeeklyUsage": "120.8",
      "MonthlyUsage": "460.4"
    }
  }
}
```