调用CreateLakeHouseSpace接口，在DMS数仓开发中创建新的项目空间。

  • 同一租户下项目空间名称唯一，使用重复的项目空间名称调用此接口会导致调用失败。
  • 管理员或DBA可调用GetLhSpaceByName查询是否存在该名称的项目空间。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateLakeHouseSpace

系统规定参数。取值：CreateLakeHouseSpace。

SpaceName String 是 test_space

项目空间名称。
Description String 否 test

项目空间的描述信息。
Mode String 是 1

项目空间模式，取值如下：

  • 0：简单模式，暂不支持。
  • 1：标准模式。
DwDbType String 是 14

数据库类型，当前仅支持：

  • 14：AnalyticDB MySQL版
  • 18：AnalyticDB PostgreSQL版
SpaceConfig String 是 {\"skipManualRunCheck\":true,\"skipPublishApprove\":true}

项目空间配置，支持的配置项：

  • skipManualRunCheck：试运行免安全规则检查。
  • skipPublishApprove：发布、运维免审批。
DevDbId String 是 2435****

开发库的数据库ID（DatabaseId），可通过调用接口ListDatabases或SearchDatabase获取该参数的值。

ProdDbId String 否 2442****

生产库的数据库ID（DatabaseId），可通过调用接口ListDatabases或SearchDatabase获取该参数的值。

Tid Long 否 3***

租户ID，可通过调用接口GetUserActiveTenant或ListUserTenants获取该参数的值。

RegionId String 否 cn-hangzhou

DMS服务地域，取值请参见RegionID参数说明。

返回数据

名称 类型 示例值 描述
SpaceId Long 24

项目空间ID。
RequestId String 7FAD400F-7A5C-4193-8F9A-39D86C4F0231

请求ID。
ErrorCode String InvalidParameterValid

错误码。
ErrorMessage String Invalid parameters: space name、mode、prod db id、db type、config.

错误信息。
Success Boolean true

请求是否成功，返回值如下：

  • true：请求成功
  • false：请求失败

示例

请求示例

http(s)://dms-enterprise.aliyuncs.com/?Action=CreateLakeHouseSpace
&SpaceName=test_space
&Description=test
&Mode=1
&DwDbType=14
&SpaceConfig={\"skipManualRunCheck\":true,\"skipPublishApprove\":true}
&DevDbId=2435****
&ProdDbId=2442****
&Tid=3***
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateLakeHouseSpaceResponse>
    <RequestId>7FAD400F-7A5C-4193-8F9A-39D86C4F0231</RequestId>
    <SpaceId>24</SpaceId>
    <Success>true</Success>
</CreateLakeHouseSpaceResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7FAD400F-7A5C-4193-8F9A-39D86C4F0231",
  "SpaceId" : 24,
  "Success" : true
}

错误码

访问错误中心查看更多错误码。