All Products
Search

This Product

    Security Center:DescribeVersionConfig

    Document Center

    Security Center:DescribeVersionConfig

    Last Updated:Mar 24, 2026

    Queries the details about the edition of purchased Security Center.

    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
    SourceIp

    string

    No

    The IP address of the access source.

    192.0.XX.XX
    ResourceDirectoryAccountId

    integer

    No

    The Alibaba Cloud account ID using the Cloud Security Center service.

    Note

    Call the GetUser API to obtain this parameter.

    127608589417****

    Response elements

    Element

    Type

    Description

    Example

    object

    MVAuthCount

    integer

    Total number of licenses when purchasing multiple versions.

    5000
    SasLog

    integer

    Whether log analysis has been purchased. Values:

    • 0: Not purchased

    • 1: Purchased

    1
    SasScreen

    integer

    Whether the security dashboard has been purchased. Values:

    • 0: Not purchased

    • 1: Purchased

    0
    HoneypotCapacity

    integer

    Number of purchased honeypot licenses.

    20
    MVUnusedAuthCount

    integer

    Total remaining licenses when purchasing multiple versions.

    40
    WebLock

    integer

    Indicates whether the web tamper-proof service is enabled. Values:

    • 0: Not enabled

    • 1: Enabled

    0
    AppWhiteListAuthCount

    integer

    Number of application whitelist authorizations.

    Note

    One authorization allows the application of a whitelist policy to one server. After enabling the application whitelist function, the account will have 20 authorizations by default.

    20
    RequestId

    string

    The unique identifier generated by Alibaba Cloud for this request.

    C2DC96D2-DD2E-49D9-A28E-85590475DF55
    LastTrailEndTime

    integer

    The timestamp of the last trial expiration for Cloud Security Center, in milliseconds.

    1603934844000
    Version

    integer

    Purchased Cloud Security Center version. Values:

    • 1: Free Edition

    • 3: Enterprise Edition

    • 5: Advanced Edition

    • 6: Anti-Virus Edition

    • 7: Flagship Edition

    • 8: Multi-Edition

    • 10: Value-Added Services Only

    3
    WebLockAuthCount

    integer

    The number of purchased web tamper-proof licenses. One license can enable web tamper protection for one server. Value range: 0~N.

    Note

    N is the number of servers you have.

    0
    ReleaseTime

    integer

    The timestamp of when the Cloud Security Center instance will expire, in milliseconds.

    Note

    If you do not renew the service within 7 days after it expires, your paid instance will be downgraded to a free version, and you will no longer be able to use the features of the paid version. Your previous Cloud Security Center configuration data and historical alert data (e.g., DDoS alerts) will become inaccessible. At this point, you can only re-enable the paid version of Cloud Security Center by repurchasing it. For more information, see Purchasing Cloud Security Center.

    1625846400000
    HighestVersion

    integer

    Purchase the highest version of the Security Center. Values:

    • 1: Free Edition

    • 3: Enterprise Edition

    • 5: Advanced Edition

    • 6: Anti-Virus Edition

    • 7: Flagship Edition

    • 10: Purchase Additional Services Only

    Note

    When purchasing a single version, it indicates the corresponding version. When purchasing multiple versions, this value represents the highest version among the purchased multi-versions of Cloud Security Center.

    1
    AssetLevel

    integer

    Number of purchased server licenses.

    30
    IsOverBalance

    boolean

    Whether the number of existing servers exceeds the maximum authorized purchase quantity. Values:

    • false: Not exceeded

    • true: Exceeded
      Important This parameter is deprecated, and you do not need to pay attention to it.

    false
    InstanceId

    string

    ID of the purchased Cloud Security Center instance.

    sas-vg6hafdsafs****
    SlsCapacity

    integer

    Purchased log storage capacity in GB. Range: 0 to 200000.

    10240
    VmCores

    integer

    Number of authorized cores purchased.

    10
    AllowPartialBuy

    integer

    Whether to allow pay-as-you-go purchases.

    • 0: Not allowed

    • 1: Allowed

    1
    AppWhiteList

    integer

    Whether to enable the application whitelist. Values:

    • 0: Not enabled

    • 2: Enabled

    2
    ImageScanCapacity

    integer

    Number of purchased image scanning authorizations.

    8954
    IsTrialVersion

    integer

    Indicates whether the current Cloud Security Center version is a trial version. Values:

    • 0: Not a trial version

    • 1: Trial version

    0
    UserDefinedAlarms

    integer

    Whether to enable the custom alarm function. Values:

    • 0: Not enabled

    • 2: Enabled

    0
    OpenTime

    integer

    Service activation timestamp, unit: milliseconds.

    1657244824669
    IsNewContainerVersion

    boolean

    Whether it is the new flagship version.

    • true: It is the latest version

    • false: It is not the latest version

    true
    IsNewMultiVersion

    boolean

    Whether it is the latest multi-version.

    • true: It is the latest multi-version

    • false: It is not the latest multi-version

    true
    ThreatAnalysisCapacity

    integer

    Purchased threat analysis capacity. Unit: GB.

    25
    CspmCapacity

    integer

    Purchased cloud platform configuration check scan count. Unit: times/month.

    10
    VulFixCapacity

    integer

    Number of purchased vulnerability fixes. Unit: times/month.

    10
    RaspCapacity

    integer

    Number of purchased application protections. Unit: per month.

    10
    AgentlessCapacity

    integer

    Number of agentless detections.

    Note

    Agentless detection is not yet available for sale, so there's no need to pay attention to this field at the moment.

    10
    IsPostpay

    boolean

    Whether to enable pay-as-you-go. Values:

    • false: Not enabled

    • true: Enabled

    true
    PostPayInstanceId

    string

    Pay-As-You-Go instance ID.

    postpay-sas-**
    PostPayModuleSwitch

    string

    Pay-as-you-go module switch status, in the format of JsonString, with values as follows:

    • Key:

      • VUL: Vulnerability Repair Module

      • CSPM: Cloud Security Posture Management Module

      • AGENTLESS: Agentless Detection Module

      • SERVERLESS: Serverless Security Module

      • CTDR: Threat Analysis and Response Module

      • POST_HOST: Host and Container Security Module

      • SDK: Malicious File Detection SDK Module

      • RASP: Application Protection Module

    • Value: 0 indicates off, 1 indicates on

    {"VUL":1}
    PostPayStatus

    integer

    Pay-As-You-Go instance status. Values:

    • 1: Normal

    • 2: Stopped due to unpaid bills

    1
    PostPayOpenTime

    integer

    Pay-as-you-go activation time

    1698915219000
    SdkCapacity

    integer

    Number of SDK authorizations for malicious file detection

    10
    AntiRansomwareCapacity

    integer

    Ransomware protection backup capacity, in GB.

    160
    NewThreatAnalysis

    integer

    Whether to enable the new version of Threat Analysis and Response service. The new version of Threat Analysis and Response service refers to the one that supports purchasing access traffic and log storage capacity. Values:

    • 0: No

    • 1: Yes

    1
    ThreatAnalysisFlow

    integer

    Purchased threat analysis and response log access traffic. Unit is GB/day.

    10
    MergedVersion

    integer

    When both the annual/monthly and pay-as-you-go services for Cloud Security Center's host and container security are activated, the higher protection version of the two is selected. Values:

    • 1: Free Edition

    • 6: Anti-Virus Edition

    • 5: Advanced Edition

    • 3: Enterprise Edition

    • 7: Ultimate Edition

    7
    PostPayHostVersion

    integer

    When activating the pay-as-you-go service for host and container security, it represents the highest protection version of the already bound assets. Values:

    • 1: Free Edition

    • 3: Enterprise Edition

    • 5: Advanced Edition

    • 6: Anti-Virus Edition

    • 7: Flagship Edition

    7
    AntiRansomwareService

    integer

    Ransomware Guardian Service. Values:

    • 0: Not activated

    • 1: Activated

    1
    MultiVersion

    string

    Usage of multiple version numbers and license counts

    null
    CanTryPostPaidPackage

    integer

    Whether it supports the activation of a post-paid trial package. Values:

    • 0: Not supported

    • 1: Supported

    1
    InstanceBuyType

    integer

    Instance purchase type. Values:

    • 0: Self-purchased

    • 1: Allocated from multiple accounts

    0
    OnboardedAssets

    integer

    AI Digital Human Management Instance

    10
    IntelligentAnalysisFlow

    integer

    AI digital human analyzes traffic

    100

    When you call this operation, in addition to the response parameters listed in the preceding table, additional parameters are also returned.

    • AvdsFlag

    • FLag

    • CreateTime

    • IsSasOpening

    • Log

    • AgentlessCapacity

    Note

    The parameters in the preceding list are deprecated. You do not need to pay attention to them.

    Examples

    Success response

    JSON format

    {
  "MVAuthCount": 5000,
  "SasLog": 1,
  "SasScreen": 0,
  "HoneypotCapacity": 20,
  "MVUnusedAuthCount": 40,
  "WebLock": 0,
  "AppWhiteListAuthCount": 20,
  "RequestId": "C2DC96D2-DD2E-49D9-A28E-85590475DF55",
  "LastTrailEndTime": 1603934844000,
  "Version": 3,
  "WebLockAuthCount": 0,
  "ReleaseTime": 1625846400000,
  "HighestVersion": 1,
  "AssetLevel": 30,
  "IsOverBalance": false,
  "InstanceId": "sas-vg6hafdsafs****",
  "SlsCapacity": 10240,
  "VmCores": 10,
  "AllowPartialBuy": 1,
  "AppWhiteList": 2,
  "ImageScanCapacity": 8954,
  "IsTrialVersion": 0,
  "UserDefinedAlarms": 0,
  "OpenTime": 1657244824669,
  "IsNewContainerVersion": true,
  "IsNewMultiVersion": true,
  "ThreatAnalysisCapacity": 25,
  "CspmCapacity": 10,
  "VulFixCapacity": 10,
  "RaspCapacity": 10,
  "AgentlessCapacity": 10,
  "IsPostpay": true,
  "PostPayInstanceId": "postpay-sas-**",
  "PostPayModuleSwitch": "{\"VUL\":1}",
  "PostPayStatus": 1,
  "PostPayOpenTime": 1698915219000,
  "SdkCapacity": 10,
  "AntiRansomwareCapacity": 160,
  "NewThreatAnalysis": 1,
  "ThreatAnalysisFlow": 10,
  "MergedVersion": 7,
  "PostPayHostVersion": 7,
  "AntiRansomwareService": 1,
  "MultiVersion": "null",
  "CanTryPostPaidPackage": 1,
  "InstanceBuyType": 0,
  "OnboardedAssets": 10,
  "IntelligentAnalysisFlow": 100
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 NoPermission no permission
    400 RdCheckNoPermission Resource directory account verification has no permission.
    500 ServerError ServerError
    500 RdCheckInnerError Resource directory account service internal error.
    403 NoPermission caller has no permission You are not authorized to do this operation.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.