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

批量开/关企业版席位自动续费

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

企业版管理员批量设置企业版席位的自动续费状态。支持同时为多个席位开启或关闭自动续费,并采用部分成功语义返回处理结果。

鉴权#

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

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

请求参数#

Body 参数#

Plan string 必选  |  商品名称

待设置自动续费状态的企业版商品名称。取值:

  • AgentPlanTeam:Agent Plan 企业版
  • CodingPlanTeam:Coding Plan 企业版
SeatIds string[] 必选  |  席位 ID 列表

待设置自动续费状态的席位 ID 列表。单次请求最多支持 200 个席位 ID,不允许传入空串或重复值。

AutoRenew boolean 必选  |  自动续费

是否开启自动续费。取值:

  • true:开启自动续费
  • false:关闭自动续费
ProjectName string 默认值 default  |  项目名称

席位所属的项目空间名称。未传值时使用默认项目。

响应参数#

SuccessIds string[]  |  成功席位 ID

本次操作中自动续费状态更新成功的席位 ID 列表。

FailedResults object[]  |  失败席位明细

自动续费状态更新失败的明细列表,仅返回失败席位及其失败原因。

SeatId string  |  失败席位 ID

FailedResults.SeatId

自动续费状态更新失败的席位 ID。

Message string  |  失败原因

FailedResults.Message

自动续费状态更新失败的具体原因。