文档

DescribeVersionConfig - 查看已购买的云安全中心实例的版本详情

更新时间:

查看已购买的云安全中心实例的版本详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sas:DescribeVersionConfigRead
  • 全部资源
    acs:yundun-sas:*:{#accountId}:*

请求参数

名称类型必填描述示例值
SourceIpstring

访问源的 IP 地址。

192.0.XX.XX
ResourceDirectoryAccountIdstring

使用云安全中心服务的阿里云账号 ID。

说明 调用 GetUser 接口获取该参数。
127608589417****

返回参数

名称类型描述示例值
object
MVAuthCountinteger

购买多版本时的总授权数。

5000
SasLoginteger

是否已购买日志分析。取值:

  • 0:未购买
  • 1:已购买
1
SasScreeninteger

是否已购买安全大屏。取值:

  • 0:未购买
  • 1:已购买
0
HoneypotCapacitylong

已购买的蜜罐授权台数。

20
MVUnusedAuthCountinteger

购买多版本时总剩余授权数。

40
WebLockinteger

是否开启了网页防篡改服务。取值:

  • 0:未开启
  • 1:已开启
0
AppWhiteListAuthCountlong

应用白名单授权数。

说明 一个授权可为一台服务器应用白名单策略。开通应用白名单功能后,该账号默认拥有 20 个授权。
20
RequestIdstring

阿里云为该请求生成的唯一标识符。

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

上一次试用云安全中心的截止时间戳,单位为毫秒。

1603934844000
Versioninteger

已购买的云安全中心版本。 取值:

  • 1:免费版
  • 3:企业版
  • 5:高级版
  • 6:防病毒版
  • 7:旗舰版
  • 8:多版本
  • 10:仅采购增值服务
3
WebLockAuthCountlong

已购买的网页防篡改的授权数。1 个授权可为 1 台服务器开启网页防篡改保护。取值范围:0~N。

说明 N 为您保有的服务器数量。
0
ReleaseTimelong

云安全中心实例到期时间戳,单位为毫秒。

说明 如果服务到期 7 天后您未进行续费,您的付费版实例将降级为免费版,您将无法继续使用付费版本的功能,您之前的云安全中心配置数据和历史告警数据(例如:DDoS 告警等)将无法查看。此时,您只有通过重新购买来启用云安全中心付费版服务。更多信息请参见购买云安全中心
1625846400000
HighestVersioninteger

购买安全中心最高版本。取值:

  • 1:免费版
  • 3:企业版
  • 5:高级版
  • 6:防病毒版
  • 7:旗舰版
  • 10:仅采购增值服务
说明 购买是单版本则表示对应的版本,购买为多版本时,该值表示购买云安全中心多版本中的最高版本。
1
AssetLevelinteger

已购买的服务器授权数。

30
IsOverBalanceboolean

现有服务器台数是否超过购买的最大授权数。取值:

  • false:未超过
  • true:已超过
false
InstanceIdstring

已购买的云安全中心实例 ID。

sas-vg6hafdsafs****
SlsCapacitylong

已购买的日志存储容量,单位为 GB。取值范围:0~200000。

10240
VmCoresinteger

已购买的授权核数。

10
AllowPartialBuyinteger

是否允许按量购买。

  • 0:不允许
  • 1:允许
1
AppWhiteListinteger

是否开启应用白名单。取值:

  • 0:未开启
  • 2:已开启
2
ImageScanCapacitylong

已购镜像扫描授权数。

8954
IsTrialVersioninteger

当前云安全中心版本是否是试用版本。取值:

  • 0:非试用版本
  • 1:试用版本
0
UserDefinedAlarmsinteger

是否开启自定义告警功能。取值:

  • 0:未开启
  • 2:已开启
0
OpenTimelong

开通服务时间戳,单位:毫秒。

1657244824669
IsNewContainerVersionboolean

是否是新旗舰版。

  • true:是最新版

  • false:不是最新版

true
IsNewMultiVersionboolean

是否是新多版本。

  • true:是最新多版本

  • false:不是最新多版本

true
ThreatAnalysisCapacitylong

已购威胁分析容量。单位:GB。

25
CspmCapacitylong

已购云平台配置检查扫描数。单位:次/月。

10
VulFixCapacitylong

已购漏洞修复数。单位:次/月。

10
RaspCapacitylong

已购应用防护数。单位:个/月。

10
AgentlessCapacitylong

无代理检测数。

说明 无代理检测暂未售卖,现无需关注该字段。
10
IsPostpayboolean

是否开通按量付费。取值:

  • false:未开通
  • true:已开通
true
PostPayInstanceIdstring

按量付费实例 ID。

postpay-sas-**
PostPayModuleSwitchstring

按量付费模块开关。取值:

  • VUL:漏洞修复模块
{"VUL":1}
PostPayStatusinteger

按量付费实例状态。取值:

  • 1:正常
  • 2:欠费停机
1
PostPayOpenTimelong

按量付费开通时间。

1698915219000
SdkCapacitylong

恶意文件检测 SDK 授权数。

10
AntiRansomwareServiceinteger

防勒索管家服务。取值:

  • 0:未开通
  • 1:已开通
1

实际调用时,除上述表格中的返回参数外,还会返回以下参数。

  • AvdsFlag
  • FLag
  • CreateTime
  • IsSasOpening
  • Log
  • AgentlessCapacity
说明 上述列表中的参数已废弃,您无需关注。

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400NoPermissionno permission无此服务的访问权限。
403NoPermissioncaller has no permission当前操作未被授权,请联系主账号在RAM控制台进行授权后再执行操作。
500ServerErrorServerError服务故障,请稍后重试!

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-04-17OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2024-02-27OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2023-11-28OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2023-11-06OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2023-07-07OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
  • 本页导读 (1)
文档反馈