跳转到主要内容
PUT
设置用户的计费组织
通过一次请求为最多 100 个用户设置计费组织。仅更改你提交的用户,企业中的其他用户不受影响。如需逐个设置单个用户,也可使用 beta 版用户设置端点,该端点同样接受 billing_org_id。

部分成功

即使同一请求中的其他行无效,有效的分配仍会一并保存,因此 200 响应中也可能包含失败项。请务必检查 failed:其中每个条目都会列出用户、所请求的组织以及 reason。这些用户的计费组织不会发生变化;请修正相应的行后重新发送。 今后可能会新增原因值,因此请将未知值作为失败项处理,而不是视为错误。 错误响应 (4xx 或 5xx) 表示请求中的所有内容均未保存。不包含任何分配、分配数超过 100 个,或同一 user_id 出现多次的请求将被拒绝,并返回 422。 重新发送某个分配会覆盖该用户当前的计费组织,并额外生成一条审计日志条目,因此重复调用是安全的,但并非毫无代价。

权限

需要一个在企业级别同时具有 ManageBilling 和 ViewOrganizations 权限的服务用户或个人访问令牌。ManageOrganizations 已包含 ViewOrganizations,因此同样满足该要求。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

请求体

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
必填

要为各用户设置的计费组织。每个用户只能出现一次。

Required array length: 1 - 100 elements

响应

成功响应

assigned
UserBillingOrgAssignmentResponse · object[]
必填

已应用的分配。

failed
UserBillingOrgFailureResponse · object[]
必填

已跳过的分配及其原因。这些用户的计费组织未发生变化。