You need to enable JavaScript to run this app.
文档中心
大数据研发治理套件

大数据研发治理套件

复制全文
下载 pdf
独享资源组
ListExclusiveComputeResourceGroups - 查询独享计算资源组列表
复制全文
下载 pdf
ListExclusiveComputeResourceGroups - 查询独享计算资源组列表

该接口用于分页查询独享计算资源组摘要,支持项目、名称关键字、状态和标签过滤。

调试

请求参数

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

Query

参数
类型
是否必填
示例值
描述
Action
String
是

ListExclusiveComputeResourceGroups

要执行的操作,取值:ListExclusiveComputeResourceGroups。

Version
String
是

2026-03-01

API的版本,取值:2026-03-01。

Body

参数
类型
是否必填
示例值
描述
PageNumber
Integer
否

1

页码,从 1 开始。

PageSize
Integer
否

10

每页大小,范围 1-100。

ProjectName
String
否

default

火山项目名过滤。

Keyword
String
否

iac_

资源组名称关键字过滤。

Status
String
否

running

用户视角资源组状态过滤。

TagFilters
Array of Object
否

--

标签过滤条件。

返回参数

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

参数
类型
示例值
描述
PageNumber
Integer

1

当前页码。

PageSize
Integer

10

当前每页大小。

TotalCount
Long

1

查询结果总数。

ResourceGroups
Array of Object

--

资源组详情列表。

请求示例

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

{
  "PageNumber": 1,
  "PageSize": 10,
  "ProjectName": "default",
  "Keyword": "iac_",
  "Status": "running",
  "TagFilters": [
    {
      "Key": "sam.infcs.io/resource-owner",
      "Values": [
        "luma"
      ]
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202607190000000000000000000000000001",
    "Action": "ListExclusiveComputeResourceGroups",
    "Version": "2026-03-01",
    "Service": "dataleap",
    "Region": "cn-beijing"
  },
  "Result": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 1,
    "ResourceGroups": [
      {
        "ResourceGroupId": 1771527484,
        "ResourceGroupNo": "DataLeap_Test2000000861508829378",
        "Name": "iac_compute_rg_01",
        "Status": "running",
        "ExpireTime": "2026-08-19T15:59:59Z",
        "ResourceCount": 1,
        "ProjectName": "default",
        "Tags": []
      }
    ]
  }
}

错误码

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

状态码
错误码
错误信息
说明
400
MissingParameter

The required parameter is missing.

请求缺少必填参数。

400
InvalidParameter

The specified parameter is invalid.

请求参数非法。

400
InvalidParameter.Type

The specified parameter Type is invalid.

路由资源类型非法。

400
InvalidParameter.Status

The specified parameter Status is invalid.

Status 不是支持的用户视角资源组状态。

400
InvalidParameter.TagFilters

The specified parameter TagFilters is invalid.

标签过滤条件非法。

500
InternalError

The request has failed due to an unknown error. Contact support with the RequestId.

内部异常或依赖返回不符合预期。

最近更新时间:2026.09.02 17:54:43
这个页面对您有帮助吗?
有用
有用
无用
无用