All Products
Search

This Product

    Security Center:DescribeVersionConfig

    Document Center

    Security Center:DescribeVersionConfig

    Last Updated:Nov 25, 2024

    Queries the details about the edition of purchased Security Center.

    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:
      • The required resource types are displayed in bold characters.
      • 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:DescribeVersionConfigget
    *All Resources
    *
      none
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    SourceIpstringNo

    The source IP address of the request.

    		192.0.XX.XX
    ResourceDirectoryAccountIdstringNo

    The ID of the Alibaba Cloud account that uses Security Center.

    Note You can call the GetUser operation to query the IDs of Alibaba Cloud accounts.
    		127608589417****

    Response parameters

    ParameterTypeDescriptionExample
    object
    MVAuthCountinteger

    The total quota in the Multi-version edition of purchased Security Center.

    		5000
    SasLoginteger

    Indicates whether log analysis is purchased. Valid values:

    • 0: no
    • 1: yes
    		1
    SasScreeninteger

    Indicates whether the security screen feature is purchased. Valid values:

    • 0: no
    • 1: yes
    		0
    HoneypotCapacitylong

    The purchased quota for the cloud honeypot feature.

    		20
    MVUnusedAuthCountinteger

    The total remaining quota in the Multi-version edition of purchased Security Center.

    		40
    WebLockinteger

    Indicates whether the web tamper proofing feature is enabled. Valid values:

    • 0: no
    • 1: yes
    		0
    AppWhiteListAuthCountlong

    The quota for the application whitelist feature.

    Note The quantity of servers that are allowed by the quota is deducted by one each time you apply an application whitelist to a server. After you enable the application whitelist feature, the quota is 20 by default.
    		20
    RequestIdstring

    The ID of the request.

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

    The timestamp when the last trial of Security Center ends. Unit: milliseconds.

    		1603934844000
    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-version edition
    • 10: Value-added Plan edition
    		3
    WebLockAuthCountlong

    The quota for the web tamper proofing feature. The quantity of servers that are allowed by the quota is deducted by one each time a server is protected by the web tamper proofing feature. Valid values: 0 to N.

    Note N indicates the number of servers that you own.
    		0
    ReleaseTimelong

    The timestamp when the Security Center subscription ends. Unit: milliseconds.

    Note If you do not renew the subscription within seven days after the expiration date, Security Center of a paid edition is automatically downgraded to Security Center Basic. In this case, you can no longer use the features of the paid edition or view the existing configurations or statistics such as DDoS alerts in Security Center. You must purchase Security Center of a paid edition to use relevant features. For more information, see Purchase Security Center.
    		1625846400000
    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 the Multi-version edition of Security Center, the value indicates the most advanced edition that is used in the Multi-version edition. If you do not purchase the Multi-version edition of Security Center, the value indicates the edition of Security Center.
    		1
    AssetLevelinteger

    The quota for servers that can be protected.

    		30
    IsOverBalanceboolean

    Indicates whether the number of existing servers exceeds the purchased quota. Valid values:

    • false: no
    • true: yes
      Notice This parameter is deprecated. You can ignore it.
    		false
    InstanceIdstring

    The ID of purchased Security Center.

    		sas-vg6hafdsafs****
    SlsCapacitylong

    The log storage capacity that you purchase. Unit: GB. Valid values: 0 to 200000.

    		10240
    VmCoresinteger

    The quota for the cores of servers that can be protected.

    		10
    AllowPartialBuyinteger

    Indicates whether the pay-as-you-go billing method is supported.

    • 0: no
    • 1: yes
    		1
    AppWhiteListinteger

    Indicates whether the application whitelist feature is enabled. Valid values:

    • 0: no
    • 2: yes
    		2
    ImageScanCapacitylong

    The purchased quota for the container image scan feature.

    		8954
    IsTrialVersioninteger

    Indicates whether Security Center runs the free trial edition. Valid values:

    • 0: no
    • 1: yes
    		0
    UserDefinedAlarmsinteger

    Indicates whether the custom alert feature is enabled. Valid values:

    • 0: no
    • 2: yes
    		0
    OpenTimelong

    The timestamp when Security Center is purchased. Unit: milliseconds.

    		1657244824669
    IsNewContainerVersionboolean

    Indicates whether Security Center runs the latest version of the Ultimate edition.

    • true: yes
    • false: no
    		true
    IsNewMultiVersionboolean

    Indicates whether Security Center runs the latest version of the Multi-version edition. Valid values:

    • true
    • false
    		true
    ThreatAnalysisCapacitylong

    The purchased log storage capacity for threat analysis. Unit: GB.

    		25
    CspmCapacitylong

    The purchased quota for configuration assessment. Unit: times/month.

    		10
    VulFixCapacitylong

    The purchased quota for vulnerability fixing. Unit: times/month.

    		10
    RaspCapacitylong

    The purchased quota for application protection. Unit: process/month.

    		10
    AgentlessCapacitylong

    The quota for agentless detection.

    Note The agentless detection feature is unavailable for purchase. You can ignore this parameter.
    		10
    IsPostpayboolean

    Indicates whether the pay-as-you-go billing method is used. Valid values:

    • false
    • true
    		true
    PostPayInstanceIdstring

    The instance ID of Security Center that uses the pay-as-you-go billing method.

    		postpay-sas-**
    PostPayModuleSwitchstring

    The configuration of the pay-as-you-go module. Valid values:

    • VUL: vulnerability fixing module
    		{"VUL":1}
    PostPayStatusinteger

    The status of Security Center that uses the pay-as-you-go billing method. Valid values:

    • 1: The instance runs as expected.
    • 2: The instance is stopped due to overdue payments.
    		1
    PostPayOpenTimelong

    The creation time of Security Center that uses the pay-as-you-go billing method.

    		1698915219000
    SdkCapacitylong

    The purchased quota for malicious file detection SDK. Unit: process/month.

    		100
    AntiRansomwareServiceinteger

    Switch of anti-ransomware hosting service. Valid values:

    • 0: off
    • 1: on
    		1
    NewThreatAnalysisinteger

    Indicates whether the new version of the threat analysis and response feature is enabled. With the new version, you can purchase the amount of log data that you want to add to the feature and log storage capacity. Valid values:

    • 0: no
    • 1: yes
    		1
    ThreatAnalysisFlowinteger

    The amount of log data that you purchase for the threat analysis and response feature. Unit: GB-day.

    		10

    When you call this operation, both the response parameters in the preceding table and the following parameters are returned.

    • AvdsFlag
    • FLag
    • CreateTime
    • IsSasOpening
    • Log
    • AgentlessCapacity
    Note The preceding parameters are deprecated. You can ignore the parameters.

    Examples

    Sample success responses

    JSONformat

    {
  "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": 100,
  "AntiRansomwareService": 1,
  "NewThreatAnalysis": 1,
  "ThreatAnalysisFlow": 10
}

    Error codes

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

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

    Change history

    Change timeSummary of changesOperation
    2024-04-17The Error code has changed. The response structure of the API has changedView Change Details
    2024-02-27The Error code has changed. The response structure of the API has changedView Change Details
    2023-11-28The Error code has changed. The response structure of the API has changedView Change Details
    2023-11-06The Error code has changed. The response structure of the API has changedView Change Details
    2023-07-07The Error code has changed. The response structure of the API has changedView Change Details