调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必填	示例值	描述
Action	String	是	CreateExclusiveComputeResourceGroup	要执行的操作，取值：CreateExclusiveComputeResourceGroup。
Version	String	是	2026-03-01	API的版本，取值：2026-03-01。

Body

参数	类型	是否必填	示例值	描述
DryRun	Boolean	否	true	是否只做预检，不真实下单和创建资源。
Name	String	是	iac_compute_rg_01	资源组名称。最大 128 字符，不能是空白字符串。
ProjectName	String	否	default	火山项目名，不是 DataLeap 项目名。
Tags	Array of Object	否	--	火山标签列表。
PurchaseDuration	Object	否	--	购买周期。
Conf	Object	是	--	资源类型专属配置。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
DryRun	Boolean	false	是否为 DryRun 请求。
ResourceGroupId	Long	1771527484	资源组数据库自增 ID。
Name	String	iac_compute_rg_01	资源组名称。
ResourceGroupNo	String	DataLeap_Test2000000861508829378	资源组实例号，当前等于内部 instanceNo。
Status	String	running	用户视角资源组状态。
ExpireTime	String	2026-08-19T15:59:59Z	到期时间，UTC ISO-8601 字符串。
CreatedTime	String	2026-07-19T03:08:20Z	创建时间，UTC ISO-8601 字符串。
UpdatedTime	String	2026-07-19T03:09:20Z	更新时间，UTC ISO-8601 字符串。
ProjectName	String	default	火山项目名。
Tags	Array of Object	--	火山标签列表。
RegionId	String	cn-shanghai	地域 ID。
PurchaseDuration	Object	--	购买周期。
Conf	Object	--	资源类型专属配置。

请求示例

POST /?Action=CreateExclusiveComputeResourceGroup&Version=2026-03-01 HTTP/1.1
Host: dataleap.cn-beijing.volcengineapi.com
Content-Type: application/json

{
  "DryRun": true,
  "Name": "iac_compute_rg_01",
  "ProjectName": "default",
  "Tags": [
    {
      "Key": "sam.infcs.io/resource-owner",
      "Value": "luma"
    }
  ],
  "PurchaseDuration": {
    "Months": 1,
    "AutoRenew": true
  },
  "Conf": {
    "ComputeSpec": {
      "CpuCores": 4,
      "MemoryGiB": 16,
      "ResourceCount": 1
    },
    "Network": {
      "ZoneId": "cn-shanghai-a",
      "VpcId": "vpc-xxx",
      "SubnetIds": [
        "subnet-xxx"
      ],
      "SecurityGroupIds": [
        "sg-xxx"
      ]
    }
  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202607190000000000000000000000000001",
    "Action": "CreateExclusiveComputeResourceGroup",
    "Version": "2026-03-01",
    "Service": "dataleap",
    "Region": "cn-beijing"
  },
  "Result": {
    "DryRun": true,
    "ResourceGroupId": null,
    "ResourceGroupNo": null,
    "Name": "iac_compute_rg_01",
    "Status": null,
    "ExpireTime": null,
    "CreatedTime": null,
    "UpdatedTime": null,
    "ProjectName": "default",
    "Tags": [
      {
        "Key": "sam.infcs.io/resource-owner",
        "Value": "luma"
      }
    ],
    "RegionId": "cn-shanghai",
    "PurchaseDuration": {
      "Months": 1,
      "AutoRenew": true
    },
    "Conf": {
      "ComputeSpec": {
        "CpuCores": 4,
        "MemoryGiB": 16,
        "ResourceCount": 1
      },
      "Network": {
        "ZoneId": "cn-shanghai-a",
        "VpcId": "vpc-xxx",
        "SubnetIds": [
          "subnet-xxx"
        ],
        "SecurityGroupIds": [
          "sg-xxx"
        ]
      }
    }
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter	The required parameter is missing.	请求缺少必填参数。
400	InvalidParameter	The specified parameter is invalid.	请求参数非法。
400	InvalidParameter.ResourceSpec	The specified parameter ResourceSpec is invalid.	资源规格非法。
400	InvalidParameter.Network	The specified parameter Network is invalid.	网络配置非法。
400	InvalidParameter.ZoneId	The specified parameter ZoneId is invalid.	可用区不可用或与当前 Region 不匹配。
400	InvalidParameter.ProjectName	The specified parameter ProjectName is invalid.	火山项目不存在或不可访问。
400	InvalidParameter.Tags	The specified parameter Tags is invalid.	标签格式、长度、数量或重复 Key 非法。
409	ResourceAlreadyExists.ResourceGroup	The specified resource group already exists.	同租户下资源组名称已存在。
500	InternalError	The request has failed due to an unknown error. Contact support with the RequestId.	内部异常或依赖返回不符合预期。

最近更新时间：2026.09.02 17:54:44

这个页面对您有帮助吗？

有用

无用

大数据研发治理套件

调试 #

请求参数 #

Query #

Body #

返回参数 #

请求示例 #

返回示例 #

错误码 #

调试

请求参数

Query

Body

返回参数

请求示例

返回示例

错误码