文档首页 > > API参考> 工作空间管理> 创建工作空间

创建工作空间

分享
更新时间: 2019/12/30 GMT+08:00

功能介绍

创建工作空间。

URI

POST /v1/{project_id}/workspaces

参数说明如 表1所示。
表1 参数说明

参数

是否必选

参数类型

说明

project_id

String

用户项目ID。

请求消息

请求参数如 表2所示。
表2 请求参数

参数

是否必选

参数类型

说明

name

String

工作空间名称,utf8。

长度限制为4-64字符,支持中文、大小写字母、数字、中划线和下划线。同时“default”为系统预留的默认工作空间名称,用户无法自己创建名为“default”的工作空间。

description

String

工作空间描述,默认为空。长度限制为0-256字符。

enterprise_project_id

String

企业项目ID。

说明:

关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理服务用户指南》。

该字段不传(或传为字符串“0”),则将资源绑定给默认企业项目。

auth_type

String

授权类型。可选值有PUBLIC、PRIVATE、INTERNAL。默认值为PUBLIC。

  • PUBLIC:租户内部公开访问。
  • PRIVATE:仅创建者和主账号可访问。
  • INTERNAL:创建者、主账号、指定IAM子账号可访问,需要与grants参数配合使用。

grants

grant结构数组

授权用户列表。默认为空。需要与“auth_type”参数配合使用,且仅当授权类型为“INTERNAL”时才会生效。

表3 grants属性列表

参数

是否必选

参数类型

说明

user_id

String

IAM用户ID。此参数与user_name必填一个。两者都填优先使用user_id。

user_name

String

IAM用户名称。此参数与user_id必填一个。

响应消息

响应参数如表2所示。

表4 响应参数

参数

参数类型

说明

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

request_id

String

调用失败时的request_id信息。

调用成功时无此字段。

id

String

工作空间ID,系统生成的32位UUID,不带橫线。

name

String

工作空间名称。

description

String

工作空间描述。

owner

String

创建者名称。

create_time

Long

创建时间,UTC。

update_time

Long

最后修改时间,UTC。

enterprise_project_id

String

企业项目ID。

enterprise_project_name

String

企业项目名称。

auth_type

String

授权类型。默认值为PUBLIC。

  • PUBLIC:租户内部公开访问。
  • PRIVATE:仅创建者和主账号可访问。
  • INTERNAL:创建者、主账号、指定IAM子账号可访问,需要与grants参数配合使用。

status

String

工作空间状态。

  • CREATE_FAILED:创建失败。
  • NORMAL:状态正常。
  • DELETING:正在删除。
  • DELETE_FAILED:删除失败。

grants

grant结构数组

授权用户列表。

表5 grants属性列表

参数

参数类型

说明

user_id

String

IAM用户ID。

user_name

String

IAM用户名称。

示例

  • 请求示例
    POST https://{endpoint}/v1/{project_id}/workspaces
    {
        "name": "test-workspace",
        "description": "It's a test project",
        "enterprise_project_id": "10eb0091-887f-4839-9929-cbc884f1e20e",
        "auth_type": "internal",
        "grants": [
            {
                "user_name": "test"
            }
        ]
    }
  • 成功响应示例
    { 
      "id": "cfedf4a550124446a0c781c2deababe0",
      "name": "test-workspace",
      "description": "It's a test project", 
      "owner": "testUser", 
      "create_time": 1470000020000, 
      "update_time": 1470000020000, 
      "enterprise_project_id":"10eb0091-887f-4839-9929-cbc884f1e20e",
      "enterprise_project_name": "test-eps",
      "auth_type": "public",
      "status": "NORMAL"
    }
  • 失败响应示例
    {
      "error_msg": "Error message.",
      "error_code": "ModelArts.0104",
      "request_id": "21b81005261c4da5a627b4e9b9d58d50"
    }

状态码

状态码请参见表1

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区