查询账号组

请求参数

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

返回参数

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

请求示例

POST /?Action=DescribeAccountGroups&Version=2025-01-01 HTTP/1.1
Host: config.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20251117T071120Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251117/cn-beijing/config/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "AccountGroupIds": [
    "a9e592ea-ebe1-4bde-8b6a-fdbd2ee7015e"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20251117151342173156136250DE4AEC",
    "Action": "DescribeAccountGroups",
    "Version": "2025-01-01",
    "Service": "config",
    "Region": "cn-beijing"
  },
  "Result": {
    "AccountGroups": [
      {
        "AccountGroupId": "a9e592ea-ebe1-4bde-8b6a-fdbd2ee7015e",
        "GroupName": "账号组名称",
        "Status": " Enabled",
        "GroupType": "Org",
        "CreatedTime": "2025-11-16T14:23:58+08:00",
        "UpdatedTime": "2025-11-17T10:45:58+08:00",
        "Description": "描述",
        "Principals": [
          "trn:organization::123:organization/456"
        ]
      }
  ]
}
}

错误码

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