文档中心

ArkClaw 企业版

请输入

Template

BindSpaceTemplateUsers - 为用户派发自定义Claw模板

为指定用户派发自定义Claw模板，派发后该用户可使用该模板创建ArkClaw实例。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：BindSpaceTemplateUsers

要执行的操作，取值：BindSpaceTemplateUsers。

Version string 必选示例值：2026-05-01

API的版本，取值：2026-05-01。

TemplateUserBindings object[] 必选示例值：--

操作列表。

TemplateId string 必选示例值：ctpl-yeqlflu0****

自定义Claw模板ID。可以在ArkClaw控制台“模板中心”页面的“Claw模板 > 自定义模板”页签下获取。

UserId string 必选示例值：baadc2dc-****

用户ID。可以在ArkClaw控制台“用户管理”页面获取。

SpaceId string 必选示例值：csi-yei7mptudceb****

模板所属空间ID，可以在ArkClaw控制台“空间概览”页面的“基本信息”获取。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

OperationDetails object[] 示例值：--

返回操作执行结果。

Error object 示例值：--

操作失败时的具体错误信息。如果操作成功，则此字段为空或不返回。

Code string 示例值：OperationDenied.UserAlreadyBound

错误码。

Message string 示例值：The specified user is already bound to the template.

错误信息。

TemplateId string 示例值：ctpl-yeqlflu0****

目标模板ID。

UserId string 示例值：baadc2dc-****

目标用户ID。

请求示例

POST /?Action=BindSpaceTemplateUsers&Version=2026-05-01 HTTP/1.1​
Host: arkclaw.cn-beijing.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260528T100528Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260528/cn-beijing/arkclaw_stg/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "TemplateUserMappings": [​
    {​
      "UserId": "baadc2dc-****",​
      "TemplateId": "ctpl-yeqlflu0****"​
      ​
    },​
    {​
      "UserId": "9fc5ff57-****",​
      "TemplateId": "ctpl-yej5492****"​
      ​
    }​
  ],​
  "SpaceId": "csi-yei7mptudceb****"​
}​
​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202605281805520131531****",​
        "Action": "BindSpaceTemplateUsers",​
        "Version": "2026-05-01",​
        "Service": "arkclaw_stg",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "OperationDetails": [​
            {​
                "UserId": "baadc2dc-****",​
                "TemplateId": "ctpl-yeqlflu0****",​
                "Error": null​
            },​
            {​
                "UserId": "9fc5ff57-****",​
                "TemplateId": "ctpl-yej5492****",​
                "Error": {​
                    "Code": "OperationDenied.UserAlreadyBound",​
                    "Message": "The specified user is already bound to the template."​
                }​
            }​
        ]​
    }​
}​
​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
200	OperationDenied.UserAlreadyBound	The specified user is already bound to the template.	用户已绑定该模板。
200	InvalidTemplate.NotFound	The specified template does not exist.	指定模板不存在。
200	InvalidUser.NotFound	The specified User does not exist.	指定的user不存在或者不合法。
400	MissingParameter.SpaceId	The required parameter SpaceId is not supplied.	参数SpaceId不能为空。
400	MissingParameter.TemplateId	The required parameter TemplateId is not supplied.	参数TemplateId不能为空。
400	MissingParameter.UserId	The required parameter UserId is not supplied.	参数UserId不能为空。
400	MissingParameter.TemplateUserBindings	The required parameter TemplateUserBindings is not supplied.	TemplateUserBindings 不能为空。
404	InvalidSpace.NotFound	The specified space does not exist.	指定ArkClaw空间不存在。
429	FlowLimitExceeded	The request was rejected due to flow control.	请求触发限流。
500	InternalError	An internal error has occurred.	内部错误，请重试。如果多次尝试失败，请提交工单。

最近更新时间：2026.09.08 14:33:38

这个页面对您有帮助吗？

有用

无用