修改工作空间
功能介绍
修改工作空间接口用于更新指定工作空间的配置信息。
该接口适用于以下场景：当用户需要更改工作空间的名称、描述或其他配置信息时，可以通过此接口进行修改。使用该接口的前提条件是工作空间已存在且用户具有修改该工作空间的权限。修改操作完成后，接口将返回更新后的工作空间详细信息，包括但不限于工作空间名称、描述、更新时间等。若工作空间不存在或用户无权限操作，接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v1/{project_id}/workspaces/{workspace_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
workspace_id |
是 |
String |
参数解释：工作空间ID。未创建工作空间时默认值为“0”，存在创建并使用的工作空间，以实际取值为准。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
grants |
否 |
Array of grants objects |
参数解释：训练作业使用的数据集。 约束限制：不可与data_url或dataset_id/dataset_version_id同时使用。 取值范围：不涉及。 默认取值：不涉及。 |
|
auth_type |
否 |
String |
参数解释：授权类型。 约束限制：不涉及。 取值范围：可选值有：
默认取值：默认值为PUBLIC。 |
|
name |
否 |
String |
参数解释：工作空间名称。约束限制：长度限制为4-64字符，支持中文、大小写字母、数字、中划线和下划线。同时'default'为系统预留的默认工作空间名称，用户无法自己创建名为'default'的工作空间。取值范围：不涉及。默认取值：不涉及。 |
|
description |
否 |
String |
参数解释：工作空间描述。 约束限制：长度限制为0-256字符。 取值范围：不涉及。 默认取值：默认为空。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
user_id |
否 |
String |
参数解释：IAM用户ID。 约束限制：此参数与user_name必填一个。两者都填优先使用user_id。 取值范围：不涉及。 默认取值：不涉及。 |
|
user_name |
否 |
String |
参数解释：IAM用户名称。 约束限制：此参数与user_id必填一个。 取值范围：不涉及。 默认取值：不涉及。 |
|
user_type |
否 |
String |
参数解释： 授权用户类型。 约束限制： 如果是联邦用户或者委托用户的话必填。 取值范围： IAM:IAM用户, FEDERATE：联邦用户, AGENCY：委托用户。 默认取值： IAM。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
workspace_id |
String |
参数解释：工作空间ID。 取值范围：不涉及。 |
请求示例
PUT https://{endpoint}/v1/{project_id}/workspaces/ccd05d1a553b4e188ea878e7dcb85e47
{
"name" : "my_workspace",
"description" : "It is my workspace",
"auth_type" : "INTERNAL",
"grants" : [ {
"user_name" : "my_iam_user"
} ]
}
响应示例
状态码：200
修改工作空间成功的响应参数。
{
"workspace_id" : "***05d1a553b4e188ea878e7dcb85***"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
修改工作空间成功的响应参数。 |
错误码
请参见错误码。
