创建工作共享空间
功能介绍
该接口支持创建工作共享空间,便于对任务进行分类管理。一个租户创建的工作共享空间上限为500个,工作共享空间名称不能重复(大小写不敏感)。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v1/workspaces
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
IAM Token信息,用于租户鉴权,该字段由租户请求IAM的Token接口获得。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
workspace_name |
是 |
String |
工作共享空间名称。支持中文、英文、数字以及“_”字符,长度限制2~50个字符。 |
workspace_description |
否 |
String |
工作共享空间描述。支持中文、英文、数字以及“_”字符,长度限制200个字符以内。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
workspace_id |
String |
工作共享空间ID。 |
workspace_name |
String |
工作共享空间名称。 |
workspace_description |
String |
工作共享空间描述。 |
tenant_domain_id |
String |
华为云IAM租户账号ID。 |
creator |
String |
创建人。 |
latest_operator |
String |
最近修改人。 |
create_time |
String |
创建时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 |
update_time |
String |
更新时间。返回UTC时间格式字符串,格式为yyyy-MM-dd'T'HH:mm:ss'Z'。 |
star |
Integer |
工作共享空间是否置顶显示(最多可置顶4个)。 |
can_delete |
Boolean |
工作共享空间是否允许删除标志位。当工作共享空间置顶显示或者该空间下存在任务时,取值为“true”,表示不可以删除。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。格式为:KMP.XXXXXXXX,其中X表示数字。 最小长度:12 最大长度:12 |
error_msg |
String |
错误描述。 最小长度:2 最大长度:512 |
请求示例
该请求创建一个工作共享空间。
POST https://{Endpoint}/v1/workspaces { "workspace_name" : "测试空间", "workspace_description" : "空间描述" }
响应示例
状态码: 200
请求成功。
{ "workspace_id" : "3eceb0cb8b834f5bb0a66d4108c2067f", "workspace_name" : "测试空间", "workspace_description" : "空间描述", "creator" : "xxxx", "latest_operator" : "xxxx", "create_time" : "2023-05-23T07:26:28Z", "update_time" : "2023-05-23T07:26:28Z", "star" : 0, "can_delete" : false }
状态码
状态码 |
描述 |
---|---|
200 |
请求成功。 |
400 |
非法请求。 |
500 |
服务内部错误。 |
错误码
请参见错误码。