# 批量绑定企业版席位

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

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

将企业版席位批量绑定到指定子用户。支持在单次调用中为多个席位指派对应的用户，采用部分成功语义：返回结果中分别列出绑定成功与失败的席位，调用方可据此重试失败项。已绑定其他用户的席位不会被覆盖，会作为失败项返回。

> **注意**
>
> 本接口为部分成功语义：返回结果中 SuccessIds 与 FailedResult 分别列出绑定成功与失败的席位，调用方需根据 FailedResult 自行重试或修复。已绑定其他用户的席位不会被覆盖，会进入 FailedResult。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [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 参数

**Data** `object[]` `必选` | 席位绑定列表

待分配的席位绑定关系列表，每一项指定一个席位 ID 及其对应的目标子用户。

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

`Data.SeatId`

待绑定的席位 ID。

**UserId** `string` `必选` | 子用户 ID

`Data.UserId`

待绑定的目标子用户 ID。

**UserName** `string` `必选` | 子用户名

`Data.UserName`

子用户的显示名称。

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

席位所属的项目空间名称。未传值时使用默认项目；指定不存在的项目时会返回 `NotFound.ProjectName` 错误。

## 响应参数

**FailedResult** `object[]` | 失败席位列表

绑定失败的席位明细列表，包含失败的 *SeatId* 与失败原因。

**Message** `string` | 失败原因

`FailedResult.Message`

绑定失败的具体原因说明。

**SeatId** `string` | 失败席位 ID

`FailedResult.SeatId`

绑定失败的席位 ID。

**SuccessIds** `string[]` | 成功席位 ID

绑定成功的席位 ID 列表。


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=AssignTeamSeats&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 '{
  "Data": [
    { "SeatId": "seat-agt-sm-001", "UserId": "20000001", "UserName": "alice" },
    { "SeatId": "seat-agt-md-001", "UserId": "20000002", "UserName": "bob" },
    { "SeatId": "seat-agt-sm-002", "UserId": "20000003", "UserName": "carol" }
  ]
}
'
```

#### Response

```
{
  "ResponseMetadata": {
    "RequestId": "20260519103128B7A29C481EFC026D93",
    "Action": "AssignTeamSeats",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "SuccessIds": ["seat-agt-sm-001", "seat-agt-md-001"],
    "FailedResult": [
      {
        "SeatId": "seat-agt-sm-002",
        "Message": "The seat is already assigned to another user."
      }
    ]
  }
}
```