You need to enable JavaScript to run this app.
文档中心
云安全中心

云安全中心

复制全文
下载 pdf
HIDS_TENANT
GetTenantQuota - 获取租户配额信息
复制全文
下载 pdf
GetTenantQuota - 获取租户配额信息

返回当前火山引擎租户的基础服务、增值服务、能力白名单和授权有效期信息,用于判断各安全能力是否可用。

调试

请求参数

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

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

GetTenantQuota

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

Version
String
是

2024-05-08

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

返回参数

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

参数
类型
示例值
描述
ID
String

tenant-auth-id-001

租户授权记录 ID

ValueAdded
Object

--

增值服务信息

AccountID
String

account-id-001

当前租户所属的火山引擎账号 ID

ExpireTime
Long

1786533780

授权到期时间,Unix 时间戳,单位:秒;-1 表示长期有效,大于当前时间表示未过期

InsertTime
Long

1783941780

首次购买时间,Unix 时间戳,单位:秒

UpdateTime
Long

1786530180

最近更新时间,Unix 时间戳,单位:秒

BasicQuota
Object

--

基本服务授权信息

CapWhiteList
Object

--

功能白名单开启状态,若为0或者不存在则表示没有开启

Labels
Array of String

["production"]

账户标签信息,可以为空,空数组表示没有标签

请求示例

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

{}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "GetTenantQuota",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "AccountID": "account-id-001",
    "BasicQuota": {
      "Action": "ListHidsAlarms",
      "ExpireTime": 1786579199,
      "NeedRemove": true,
      "PaidType": "PrePaid",
      "RunningUsedCount": 1,
      "TotalCount": 1,
      "UsedCount": 1,
      "Version": 1
    },
    "CapWhiteList": {
      "BashAuditCap": 1,
      "ClientBruteforceBanCap": 1,
      "FileMonitorCap": 1,
      "UserAutoDefenseCap": 1
    },
    "ExpireTime": 1786533780,
    "ID": "tenant-auth-id-001",
    "InsertTime": 1783941780,
    "Labels": [
      "production"
    ],
    "UpdateTime": 1786530180,
    "ValueAdded": {
      "LLMEvalQuota": {
        "Action": "ListHidsAlarms",
        "ExpireTime": 1786579199,
        "NeedRemove": true,
        "TotalCount": 1,
        "UsedCount": 1,
        "Version": 1
      },
      "LogAnalysisQuota": {
        "Action": "ListHidsAlarms",
        "ExpireTime": 1786579199,
        "NeedRemove": true,
        "PaidType": "PrePaid",
        "TotalCount": 1,
        "UsedCount": 1,
        "Version": 1
      },
      "MlpDefenderQuota": {
        "Action": "ListHidsAlarms",
        "ExpireTime": 1786579199,
        "NeedRemove": true,
        "TotalCount": 1,
        "UsedCount": 1,
        "Version": 1
      },
      "MultiLevelManagement": {
        "AppSec": {
          "Action": "ListHidsAlarms",
          "ExpireTime": 1786579199,
          "NeedRemove": true,
          "TotalCount": 1,
          "UsedCount": 1,
          "Version": 1
        },
        "ClusterSec": {
          "Action": "ListHidsAlarms",
          "ExpireTime": 1786579199,
          "NeedRemove": true,
          "TotalCount": 1,
          "UsedCount": 1,
          "Version": 1
        },
        "ProtectHost": {
          "Action": "ListHidsAlarms",
          "ExpireTime": 1786579199,
          "NeedRemove": true,
          "TotalCount": 1,
          "UsedCount": 1,
          "Version": 1
        }
      },
      "RaspAuthQuota": {
        "Action": "ListHidsAlarms",
        "ExpireTime": 1786579199,
        "NeedRemove": true,
        "PaidType": "PrePaid",
        "TotalCount": 1,
        "UsedCount": 1,
        "Version": 1
      },
      "VarmorQuota": {
        "Action": "ListHidsAlarms",
        "ExpireTime": 1786579199,
        "NeedRemove": true,
        "PaidType": "PrePaid",
        "TotalCount": 1,
        "UsedCount": 1,
        "Version": 1
      }
    }
  }
}

错误码

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

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

The required parameter %s is missing.

请求参数缺失,请检查参数是否已正确传入。

400
InvalidParameter

The specified parameter %s is invalid.

请求参数错误,请检查参数传递内容是否正确。

400
OperationDenied

Operation is denied because the specified resource is in use.

不允许的操作,请检查当前资源是否被占用

403
OperationDenied.TenantUnauthorized(%s)

The request has failed due to tenant not found(%s)

未授权的租户操作

500
InternalError

The request has failed due to an unknown error.

服务器内部错误,请稍后重试或联系技术支持。

最近更新时间:2026.08.21 20:36:35
这个页面对您有帮助吗?
有用
有用
无用
无用