批量查询指定空间内用户与自定义Claw模板的绑定详情，支持按用户ID或自定义Claw模板ID筛选。 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **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 时，返回两者的交集结果。

## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **NextToken** string `示例值：Y2kteWVqMXJreTVma3F0YzM4e******` 本次调用返回的查询凭证值，返回为空表示该页为末页。 **TemplateUserBindings** object[] `示例值：--` 用户与自定义Claw模板的绑定详情。 **SpaceId** string `示例值：csi-yehw6ow1kwa5g0****` 空间ID。 **TemplateId** string `示例值：ctpl-yem74jg****` 自定义Claw模板ID。 **UserId** string `示例值：baadc2dc-****` 自定义Claw模板绑定的用户ID。 ## 请求示例 ```json 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 ``` ## 返回示例 ```json { "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******" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |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资源不存在。 |

ArkClaw 企业版