All Products
Search

This Product

    Security Center:GetAuthSummary

    Document Center

    Security Center:GetAuthSummary

    Last Updated:Jul 09, 2026

    Retrieves authorization statistics.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example

    No parameters required.

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID. It is a unique identifier generated by Alibaba Cloud for this request and can be used to troubleshoot issues.

    0B48AB3C-***-B9270EF46038
    DefaultAuthToAll

    integer

    Indicates whether all assets are authorized by default. Valid values:

    • 0: No.

    • 1: Yes.

    1
    AllowPartialBuy

    integer

    Indicates whether on-demand authorization purchase is allowed during a new purchase. Valid values:

    • 0: Not allowed.

    • 1: Allowed.

    1
    AllowUpgradePartialBuy

    integer

    Indicates whether upgrading to on-demand authorization purchase is allowed during an upgrade. Valid values:

    • 0: Not allowed.

    • 1: Allowed.

    1
    HasPreBindSetting

    boolean

    Indicates whether a pre-bindingasset configuration exists. Pre-binding refers to the asset binding configuration selected in advance during purchase. Valid values:

    • 0: Does not exist.

    • 1: Exists.

    1
    IsMultiVersion

    integer

    Indicates whether multiple versions exist. Valid values:

    • 0: No.

    • 1: Yes.

    1
    AutoBind

    integer

    Indicates whether new subscription assets are automatically bound when the host and container security subscription service is activated. Valid values:

    • 0: Disabled.

    • 1: Enabled.

    1
    HighestVersion

    integer

    The highest purchased edition of Security Center. Valid values:

    • 1: Free Edition.

    • 3: Enterprise Edition.

    • 5: Premium Edition.

    • 6: Anti-virus Edition.

    • 7: Ultimate Edition.

    • 10: Value-added services only.

    Note

    If a single edition is purchased, this value indicates the corresponding edition. If multiple editions are purchased, this value indicates the highest edition among the sub-editions.

    1
    Machine

    object

    The asset authorization statistics information.

    RiskCoreCount

    integer

    The number of cores of assets that have security risks.

    10
    BindCoreCount

    integer

    The number of cores of assets that are bound with authorization.

    10
    TotalEcsCount

    integer

    The total number of assets.

    10
    BindEcsCount

    integer

    The number of bound assets.

    10
    TotalCoreCount

    integer

    The total number of asset cores.

    10
    RiskEcsCount

    integer

    The number of assets that have security risks.

    10
    UnBindEcsCount

    integer

    The number of unbound assets.

    10
    UnBindCoreCount

    integer

    The number of cores of unbound assets.

    10
    PostPaidBindCoreCount

    integer

    The number of cores of assets bound with pay-as-you-go authorization.

    10
    PostPaidBindEcsCount

    integer

    The number of assets bound with pay-as-you-go authorization.

    10
    VersionSummary

    array<object>

    The authorization usage statistics information.

    object

    The authorization usage statistics information.

    Index

    integer

    The index of the current edition. A larger value indicates a higher edition. This parameter is used for sorting. Valid values:

    • 1: Free Edition.

    • 2: Anti-virus Edition.

    • 3: Premium Edition.

    • 4: Enterprise Edition.

    • 5: Ultimate Edition.

    1
    Version

    integer

    The purchased edition of Security Center. Valid values:

    • 1: Free Edition.

    • 3: Enterprise Edition.

    • 5: Premium Edition.

    • 6: Anti-virus Edition.

    • 7: Ultimate Edition.

    • 8: Multi-version.

    • 10: Value-added services only.

    3
    UsedCoreCount

    integer

    The number of authorized cores that have been used.

    Note

    This parameter is valid only when AuthBindType is set to CORE or ASSET_AND_CORE.

    10
    UnUsedCount

    integer

    The number of unused authorized assets.

    Note

    This parameter is valid only when AuthBindType is set to ASSET or ASSET_AND_CORE.

    10
    UsedEcsCount

    integer

    The number of authorized assets that have been used.

    Note

    This parameter is valid only when AuthBindType is set to ASSET or ASSET_AND_CORE.

    10
    TotalCount

    integer

    The total number of authorized assets for the current edition.

    Note

    This parameter is valid only when AuthBindType is set to ASSET or ASSET_AND_CORE.

    10
    TotalEcsAuthCount

    integer

    The total number of authorized assets.

    Note

    This parameter is valid only when AuthBindType is set to ASSET or ASSET_AND_CORE.

    10
    TotalCoreAuthCount

    integer

    The total number of authorized cores.

    Note

    This parameter is valid only when AuthBindType is set to CORE or ASSET_AND_CORE.

    10
    UnusedEcsAuthCount

    integer

    The number of unused authorized assets.

    Note

    This parameter is valid only when AuthBindType is set to ASSET or ASSET_AND_CORE.

    10
    UnusedCoreAuthCount

    integer

    The number of unused authorized cores.

    Note

    This parameter is valid only when AuthBindType is set to CORE or ASSET_AND_CORE.

    10
    AuthBindType

    string

    The type of authorization consumed during binding. Valid values:

    • ASSET: consumes authorized asset count.

    • CORE: consumes authorized core count.

    • ASSET_AND_CORE: consumes both authorized asset count and authorized core count.

    ASSET
    AllowUserUnbind

    integer

    Indicates whether immediately unbinding all bound assets is allowed. Valid values:

    • 0: No.

    • 1: Yes.

    1
    PostPaidVersionSummary

    array<object>

    The service authorization statistics for the host and container security pay-as-you-go service.

    object

    AuthBindType

    string

    The type of authorization consumed during binding. Valid values:

    • ASSET: consumes authorized asset count.

    • CORE: consumes authorized core count.

    • ASSET_AND_CORE: consumes both authorized asset count and authorized core count.

    ASSET
    Version

    integer

    The pay-as-you-go edition bound to the host assets. Valid values:

    • 1: Free Edition.

    • 3: Enterprise Edition.

    • 5: Premium Edition.

    • 6: Anti-virus Edition.

    • 7: Ultimate Edition.

    3
    Index

    integer

    The index of the current edition. A larger value indicates a higher edition. This parameter is used for sorting. Valid values:

    • 1: Free Edition.

    • 2: Anti-virus Edition.

    • 3: Premium Edition.

    • 4: Enterprise Edition.

    • 5: Ultimate Edition.

    1
    UsedCoreCount

    integer

    The number of authorized cores that have been used.

    Note

    This parameter is valid only when AuthBindType is set to CORE or ASSET_AND_CORE.

    10
    UsedEcsCount

    integer

    The number of authorized assets that have been used.

    Note

    This parameter is valid only when AuthBindType is set to ASSET or ASSET_AND_CORE.

    10
    PostPaidHostAutoBind

    string

    Indicates whether new hosts are automatically bound for the host and container security pay-as-you-go service. Valid values:

    • 0: Disabled.

    • 1: Enabled.

    1
    PostPaidHostAutoBindVersion

    string

    The edition to which new assets are automatically bound for the host and container security pay-as-you-go service. Valid values:

    • 1: Free Edition.

    • 3: Enterprise Edition.

    • 5: Premium Edition.

    • 6: Anti-virus Edition.

    • 7: Ultimate Edition.

    7
    PostPaidHighestVersion

    string

    The protection edition of the host and container security pay-as-you-go service. This value represents the highest protection edition among all bound hosts. Valid values:

    • 1: Free Edition.

    • 3: Enterprise Edition.

    • 5: Premium Edition.

    • 6: Anti-virus Edition.

    • 7: Ultimate Edition.

    7
    InvalidBindStatus

    string

    The binding validity status. Valid values:

    • NORMAL: Valid.

    • INVALID_NODE_VERSION: Invalid.

    INVALID_NODE_VERSION
    ClusterNodeCheck

    integer

    Indicates whether the cluster node requires machine version verification. Valid values:

    • 0: Not required.

    • 1: Required.

    1
    EdrSummary

    object

    BoundCount

    string

    PostPaidAutoBind

    string

    HybridPaidAutoBind

    string

    Examples

    Success response

    JSON format

    {
  "RequestId": "0B48AB3C-***-B9270EF46038",
  "DefaultAuthToAll": 1,
  "AllowPartialBuy": 1,
  "AllowUpgradePartialBuy": 1,
  "HasPreBindSetting": true,
  "IsMultiVersion": 1,
  "AutoBind": 1,
  "HighestVersion": 1,
  "Machine": {
    "RiskCoreCount": 10,
    "BindCoreCount": 10,
    "TotalEcsCount": 10,
    "BindEcsCount": 10,
    "TotalCoreCount": 10,
    "RiskEcsCount": 10,
    "UnBindEcsCount": 10,
    "UnBindCoreCount": 10,
    "PostPaidBindCoreCount": 10,
    "PostPaidBindEcsCount": 10
  },
  "VersionSummary": [
    {
      "Index": 1,
      "Version": 3,
      "UsedCoreCount": 10,
      "UnUsedCount": 10,
      "UsedEcsCount": 10,
      "TotalCount": 10,
      "TotalEcsAuthCount": 10,
      "TotalCoreAuthCount": 10,
      "UnusedEcsAuthCount": 10,
      "UnusedCoreAuthCount": 10,
      "AuthBindType": "ASSET"
    }
  ],
  "AllowUserUnbind": 1,
  "PostPaidVersionSummary": [
    {
      "AuthBindType": "ASSET",
      "Version": 3,
      "Index": 1,
      "UsedCoreCount": 10,
      "UsedEcsCount": 10
    }
  ],
  "PostPaidHostAutoBind": "1",
  "PostPaidHostAutoBindVersion": "7",
  "PostPaidHighestVersion": "7",
  "InvalidBindStatus": "INVALID_NODE_VERSION",
  "ClusterNodeCheck": 1,
  "EdrSummary": {
    "BoundCount": "",
    "PostPaidAutoBind": "",
    "HybridPaidAutoBind": ""
  }
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    500 ServerError ServerError
    403 NoPermission caller has no permission

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.