GetAccountSummary - 查询访问控制概要信息--访问控制-火山引擎

文档中心

立即注册

导航

GetAccountSummary - 查询访问控制概要信息

最近更新时间：2025.05.26 17:56:10首次发布时间：2025.05.26 11:36:18

获取账号中的 IAM 的使用情况概览（实体配额与用量）。

调试

API Explorer

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

去调试

请求参数

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

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

返回参数

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

参数	类型	示例值	描述
SummaryMap	Object	请参考数据结构内具体参数示例值。	访问控制信息概览的数据结构。

请求示例

GET /?Action=GetAccountSummary&Version=2018-01-01 HTTP/1.1
Host: iam.volcengineapi.com
X-Date: 20250526T032209Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250526/cn-beijing/iam/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250526112214229210232022908432",
    "Action": "GetAccountSummary",
    "Version": "2018-01-01",
    "Service": "iam",
    "Region": "cn-beijing"
  },
  "Result": {
    "SummaryMap": {
      "AccessKeysPerUserQuota": 2,
      "AccessKeysPerAccountQuota": 2,
      "AttachedPoliciesPerGroupQuota": 40,
      "AttachedSystemPoliciesPerGroupQuota": 40,
      "AttachedPoliciesPerRoleQuota": 40,
      "AttachedSystemPoliciesPerRoleQuota": 40,
      "AttachedSystemPoliciesPerUserQuota": 40,
      "AttachedPoliciesPerUserQuota": 40,
      "GroupsQuota": 300,
      "PoliciesQuota": 1500,
      "RolesQuota": 1000,
      "UsersQuota": 5000,
      "PolicySize": 6144,
      "RolesUsage": 20,
      "UsersUsage": 100,
      "GroupsUsage": 10,
      "PoliciesUsage": 50,
      "GroupsPerUserQuota": 20
    }
  }
}

错误码

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

状态码	错误码	错误信息	说明
500	ServiceFailure	The requested service failed due to an unknown error	内部服务错误。