You need to enable JavaScript to run this app.
导航
ListLayeredGroupsDetail - 主机多级分组详情
最近更新时间:2025.04.03 10:56:58首次发布时间:2025.04.03 10:56:58
我的收藏
有用
有用
无用
无用

主机多级分组详情

调试

请求参数

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

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

ListLayeredGroupsDetail

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

Version
String

2024-05-08

API的版本,取值:2024-05-08。

GroupName
String

GroupName

分组名称, 模糊匹配,无论是哪一层出现都会匹配。返回值一定包括上层分组,往上查询

GroupID
String

crl9aa73pfsdrned3gmg

分组ID,默认为空,为空表示查询当前租户所有的分组

返回参数

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

参数
类型
示例值
描述
Total
Integer

123

总数

Groups
Array of Object

--

分组列表详情

请求示例

POST /?Action=ListLayeredGroupsDetail&Version=2024-05-08 HTTP/1.1
Host: seccenter.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241214T154055Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241214/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "GroupID": "crl9aa73pfsdrned3gmg"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241214234134195073007038CEC5D2",
    "Action": "ListLayeredGroupsDetail",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "Total": 123,
    "Groups": [
      {
        "Level": 1,
        "TopGroupID": "crl9aa73pfsdrned3gmg",
        "GroupID": "crl9aa73pfsdrned3gmg",
        "GroupName": "未分组",
        "ParentID": "",
        "GroupPath": "/未分组",
        "HostCount": "123"
      }
    ]
  }
}

错误码

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

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

The specified parameter %s is invalid.

请求参数错误

400
OperationDenied

Operation is denied because the specified resource is in use.

不允许的操作