You need to enable JavaScript to run this app.
文档中心
ArkClaw 企业版

ArkClaw 企业版

复制全文
下载 pdf
Template
ListSpaceTemplateUserBindings - 批量查询自定义Claw模板与用户绑定详情
复制全文
下载 pdf
ListSpaceTemplateUserBindings - 批量查询自定义Claw模板与用户绑定详情
批量查询指定空间内用户与自定义Claw模板的绑定详情,支持按用户ID或自定义Claw模板ID筛选。​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:ListSpaceTemplateUserBindings​
要执行的操作,取值:ListSpaceTemplateUserBindings。​
​
Version string 必选 示例值:2026-05-01​
API的版本,取值:2026-05-01。​
​
MaxResults integer 可选 示例值:10​
分页查询时设置的每页行数。​
  • 最小值:1。​
  • 最大值:100。​
  • 默认值:10。​
  • 若传入非法MaxResults值,会被自动调整为默认值。​
​
NextToken string 可选 示例值:Y2kteWVqMXJreTVma3F0YzM4e******​
分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次 API 调用返回的 NextToken 参数值。​
​
SpaceId string 必选 示例值:csi-yehw6ow1kwa5g0****​
ArkClaw空间ID。可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。​
​
UserIds.N string[] 可选 示例值:UserIds.1=baadc2dc-****&UserIds.2=9fc5ff57-****​
用户ID列表。​
  • 传入具体值:按指定用户筛选绑定详情。​
  • 传入的无效ID将被忽略。​
  • 不传此参数:不按用户过滤,返回所有用户的绑定详情。​
  • 参数 - N:表示用户ID的序号,取值范围:1~100。多个用户ID之间用&分隔。​
说明​
同时传入 UserIds.N 和 TemplateIds.N 时,返回两者的交集结果。​
​
TemplateIds.N string[] 可选 示例值:TemplateIds.1=ctpl-yem74jg****&TemplateIds.2=ctpl-yeon1iew****​
自定义Claw模板ID列表。​
  • 传入具体值:按指定模板筛选绑定详情。​
  • 不传此参数:不按模板过滤,返回所有模板的绑定详情。​
  • 参数 - N:表示Claw模板ID的序号,取值范围:1~100。多个模板ID之间用&分隔。​
说明​
同时传入 UserIds.N 和 TemplateIds.N 时,返回两者的交集结果。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
NextToken string 示例值:Y2kteWVqMXJreTVma3F0YzM4e******​
本次调用返回的查询凭证值,返回为空表示该页为末页。​
​
TemplateUserBindings object[] 示例值:--​
用户与自定义Claw模板的绑定详情。​
SpaceId string 示例值:csi-yehw6ow1kwa5g0****​
空间ID。​
​
TemplateId string 示例值:ctpl-yem74jg****​
自定义Claw模板ID。​
​
UserId string 示例值:baadc2dc-****​
自定义Claw模板绑定的用户ID。​
​
​
​
​
请求示例​
​
GET /?Action=ListSpaceTemplateUserBindings&Version=2026-05-01&SpaceId=csi-yehw6ow1kwa5g0**** HTTP/1.1​
Host: https://arkclaw.cn-beijing.volcengineapi.com​
X-Date: 20260723T094527Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260723/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202607231094313010225146612****",​
"Action": "ListSpaceTemplateUserBindings",​
"Version": "2026-05-01",​
"Service": "arkclaw",​
"Region": "cn-beijing"​
},​
"Result": {​
"TemplateUserBindings": [​
{​
"SpaceId": "csi-yehw6ow1kwa5g0****",​
"TemplateId": "ctpl-yem74jg****",​
"UserId": "baadc2dc-****"​
},​
{​
"SpaceId": "csi-yehw6ow1kwa5g0****",​
"TemplateId": "ctpl-yeon1iew****",​
"UserId": "9fc5ff57-****"​
}​
],​
"NextToken": "Y2kteWVqMXJreTVma3F0YzM4e******"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidTemplateIds.Malformed​
The specified TemplateIds are invalid.​
指定的 TemplateIds 不合法。​
400​
InvalidNextToken.Malformed​
The specified NextToken is malformed.​
指定的 NextToken 不合法。​
400​
MissingParameter.SpaceId​
The required parameter SpaceId is not supplied.​
参数SpaceId不能为空。​
404​
InvalidSpace.NotFound​
The specified space does not exist.​
指定Space资源不存在。​
​
​
最近更新时间:2026.09.08 14:33:38
这个页面对您有帮助吗?
有用
有用
无用
无用