ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版开发者指南API 参考TemplateListSpaceTemplateUserBindings - 批量查询自定义Claw模板与用户绑定详情
复制全文
下载 pdfListSpaceTemplateUserBindings - 批量查询自定义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值，会被自动调整为默认值。
分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次 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
这个页面对您有帮助吗？
有用
有用
无用
无用