调用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),可通过调用接口ListDatabasesSearchDatabase获取该参数的值。

ProdDbId String 2442****

生产库的数据库ID(DatabaseId),可通过调用接口ListDatabasesSearchDatabase获取该参数的值。

Tid Long 3***

租户ID,可通过调用接口GetUserActiveTenantListUserTenants获取该参数的值。

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
}

错误码

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