All Products
Search

This Product

    Security Center:GetAuthSummary

    Document Center

    Security Center:GetAuthSummary

    Last Updated:Oct 30, 2025
    This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

    Queries the statistics of asset protection quota.

    Debugging

    You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • For mandatory resource types, indicate with a prefix of * .
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    yundun-sas:GetAuthSummaryget
    *All Resources
    *
      none
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    The current API does not require request parameters

    Response parameters

    ParameterTypeDescriptionExample
    object
    RequestIdstring

    The request ID.

    		0B48AB3C-***-B9270EF46038
    DefaultAuthToAllinteger

    Indicates whether the protection quota is supported for all assets. Valid values:

    • 0: no
    • 1: yes
    		1
    AllowPartialBuyinteger

    Indicates whether you can purchase protection quota on demand when you purchase Security Center. Valid values:

    • 0: no
    • 1: yes
    		1
    AllowUpgradePartialBuyinteger

    Indicates whether you can purchase protection quota on demand after an upgrade. Valid values:

    • 0: no
    • 1: yes
    		1
    HasPreBindSettingboolean

    Indicates whether pre-bound assets exist. If you select assets to bind when you purchase Security Center, pre-bound assets exist. Valid values:

    • 0: no
    • 1: yes
    		1
    IsMultiVersioninteger

    Indicates whether Security Center Multi-edition is purchased. Valid values:

    • 0: no
    • 1: yes
    		1
    AutoBindinteger

    Indicates whether automatic binding is enabled. Valid values:

    • 0: disabled
    • 1: enabled
    		1
    HighestVersioninteger

    The most advanced edition that is used. Valid values:

    • 1: Basic edition
    • 3: Enterprise edition
    • 5: Advanced edition
    • 6: Anti-virus edition
    • 7: Ultimate edition
    • 10: Value-added Plan edition
    Note If you purchase Security Center Multi-edition, the value indicates the most advanced edition that is used. Otherwise, the value indicates the specific edition that is purchased.
    		1
    Machineobject

    The statistics of the protection quota for assets.

    RiskCoreCountinteger

    The number of cores of the assets that are at risk.

    		10
    BindCoreCountinteger

    The number of cores of the assets that are bound to Security Center.

    		10
    TotalEcsCountinteger

    The total number of assets.

    		10
    BindEcsCountinteger

    The number of the assets that are bound to Security Center.

    		10
    TotalCoreCountinteger

    The total number of asset cores.

    		10
    RiskEcsCountinteger

    The number of the assets that are at risk.

    		10
    UnBindEcsCountinteger

    The number of unbound assets.

    		10
    UnBindCoreCountinteger

    The number of cores of unbound assets.

    		10
    PostPaidBindCoreCountinteger

    Bind the number of cores for postpaid authorization assets.

    		10
    PostPaidBindEcsCountinteger

    The number of assets bound to the postpaid authorization.

    		10
    VersionSummaryarray<object>

    The quota consumption statistics.

    versionobject

    The quota consumption statistics

    Indexinteger

    The index of the current edition. The smaller the value, the higher the edition. The index is used for sorting.

    		1
    Versioninteger

    The edition of purchased Security Center. Valid values:

    • 1: Basic edition
    • 3: Enterprise edition
    • 5: Advanced edition
    • 6: Anti-virus edition
    • 7: Ultimate edition
    • 8: Multi-edition
    • 10: Value-added Plan edition
    		3
    UsedCoreCountinteger

    The consumed quota of server cores.

    Note This parameter takes effect only if AuthBindType is set to CORE or ASSET_AND_CORE.
    		10
    UnUsedCountinteger

    The remaining quota of servers.

    Note This parameter takes effect only if AuthBindType is set to ASSET or ASSET_AND_CORE.
    		10
    UsedEcsCountinteger

    The used quota of servers.

    Note This parameter takes effect only if AuthBindType is set to ASSET or ASSET_AND_CORE.
    		10
    TotalCountinteger

    The total quota of servers in the current edition.

    Note This parameter takes effect only if AuthBindType is set to ASSET or ASSET_AND_CORE.
    		10
    TotalEcsAuthCountinteger

    The total quota of servers.

    Note This parameter takes effect only if AuthBindType is set to ASSET or ASSET_AND_CORE.
    		10
    TotalCoreAuthCountinteger

    The total quota of server cores.

    Note This parameter takes effect only if AuthBindType is set to CORE or ASSET_AND_CORE.
    		10
    UnusedEcsAuthCountinteger

    The remaining quota of servers.

    Note This parameter takes effect only if AuthBindType is set to ASSET or ASSET_AND_CORE.
    		10
    UnusedCoreAuthCountinteger

    The remaining quota of server cores.

    Note This parameter takes effect only if AuthBindType is set to CORE or ASSET_AND_CORE.
    		10
    AuthBindTypestring

    The type of the quota that is consumed. Valid values:

    • ASSET: quota of servers.
    • CORE: quota of server cores.
    • ASSET_AND_CORE: both.
    		ASSET
    AllowUserUnbindinteger

    Indicates whether all bound assets can be immediately unbound. Valid values:

    • 0: no
    • 1: yes
    		1
    PostPaidVersionSummaryarray<object>

    Statistics on pay-as-you-go service authorization for host and container security.

    postPaidVersionobject
    AuthBindTypestring

    The type of authorization consumed during binding, with values: - ASSET: Consumes the number of authorized devices - CORE: Consumes the number of authorized cores - ASSET_AND_CORE: Consumes both the number of authorized devices and cores.

    		ASSET
    Versioninteger

    Bound host assets with postpaid versions, values: - 1: Free version - 3: Enterprise version - 5: Advanced version - 6: Anti-virus version - 7: Flagship version

    		3
    Indexinteger

    Current version index, the higher the number, the newer the version, used for sorting. Values: - 1: Free Edition - 2: Anti-virus Edition - 3: Advanced Edition - 4: Enterprise Edition - 5: Flagship Edition

    		1
    UsedCoreCountlong

    Number of authorized cores used. > This parameter is valid when AuthBindType is set to CORE or ASSET_AND_CORE.

    		10
    UsedEcsCountlong

    Number of authorized devices used. > This parameter is valid when AuthBindType is ASSET or ASSET_AND_CORE.

    		10
    PostPaidHostAutoBindstring

    The pay-as-you-go service for host and container security adds an automatic binding identifier for new hosts, with values: - 0: Off - 1: On

    		1
    PostPaidHostAutoBindVersionstring

    The version for the pay-as-you-go service of host and container security to automatically bind new assets, with values: - 1: Free Edition - 3: Enterprise Edition - 5: Advanced Edition - 6: Antivirus Edition - 7: Flagship Edition

    		7
    PostPaidHighestVersionstring

    Activate the pay-as-you-go service protection version for hosts and container security, which is the highest protection version among all bound hosts. Values: - 1: Free Edition - 3: Enterprise Edition - 5: Advanced Edition - 6: Antivirus Edition - 7: Flagship Edition

    		7
    InvalidBindStatusstring

    Binding effective status, value:

    • NORMAL : Effective

    • INVALID_NODE_VERSION: Invalid

    		Effective
    ClusterNodeCheckinteger

    Cluster node need to check the machine version, Value:

    • 0 : Not required

    • 1 : Required

    		Required

    Examples

    Sample success responses

    JSONformat

    {
  "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": "Effective",
  "ClusterNodeCheck": 0
}

    Error codes

    HTTP status codeError codeError messageDescription
    403NoPermissioncaller has no permissionYou are not authorized to do this operation.
    500ServerErrorServerError-

    For a list of error codes, visit the Service error codes.