更新时间：2026-09-11 GMT+08:00

更新空间默认项设置 - UpdateWorkSpaceConfigs

功能介绍

支持更新空间默认项设置。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

PUT /v2/{project_id}/factory/workspaces/{workspace_id}/workspace-configs

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参见项目ID和账号ID。
workspace_id	是	String	参数解释：工作空间ID，获取方法请参见实例ID和工作空间ID。约束限制：长度为1-128个字符。取值范围：不涉及。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	IAM Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值），使用Token认证时必选，最小长度：0，最大长度：4096。
X-Project-Id	否	String	project_id，项目编号。获取方法请参见项目ID和账号ID。多project场景采用AK/SK认证的接口请求，则该字段必选。
workspace	是	String	工作空间ID，获取方法请参见实例ID和工作空间ID。

表3 请求Body参数
参数	是否必选	参数类型	描述
workspace_configs	是	Array of WorkspaceConfig objects	配置项列表。

表4 WorkspaceConfig
参数	是否必选	参数类型	描述
config_name	是	String	配置项名称。
config_value	是	String	配置项值。

响应参数

状态码：200

无

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

请求示例

修改空间调度策略为业务日期模式，历史作业实例取消策略设置为20分钟。

PUT /v2/62099355b894428e8916573ae635f1f9/factory/workspaces/bc5f1e9ddd9648e1bed59a35ec76b0a0/workspace-configs

{
  "workspace_configs" : [ {
    "config_name" : "taskScheduleMode",
    "config_value" : "BIZ_TIME_MODE"
  }, {
    "config_name" : "historyScheduleConfig",
    "config_value" : "20"
  } ]
}

响应示例