getMonthlyUsagePerProductType
该方法展示目标月份内某公司的月度使用情况。返回所有可用产品类型的使用量统计。
参数
|
参数 |
类型 |
可选 |
说明 |
|---|---|---|---|
|
|
字符串 |
是 |
公司ID。默认值为生成API密钥的用户关联的公司ID。 |
|
|
字符串 |
是 |
返回使用量的月份。格式应为：
|
返回值
本方法返回包含以下内容的对象：
-
使用量- 对象数组，包含指定月份内每个已购买服务和产品类型的许可证席位使用数量。端点安全产品对应的对象包含以下成员：
-
产品类型，表示产品类型。 -
端点月使用量，表示通过本地引擎扫描的端点月使用量。 -
按需月使用量- 表示采用 按需 防护模式的企业所属端点（通过本地引擎扫描）的月使用量。 -
安全版月使用量- 表示采用 安全 防护模式的企业所属端点（通过本地引擎扫描）的月使用量。 -
安全增强版月使用量- 表示采用 安全增强 防护模式的企业所属端点（通过本地引擎扫描）的月使用量。 -
安全高级版月使用量- 表示采用 安全高级 防护模式的企业所属端点（通过本地引擎扫描）的月使用量。 -
mdrFoundationsMonthlyUsage，MDR基础服务（MdrFoundations）的月度使用量。 -
emailSecurityMonthlyUsage，电子邮件安全（邮箱）的月度使用量（邮箱数）。 -
mobileSecurityMonthlyUsage，移动安全（设备）的月度使用量。 -
exchangeMonthlyUsage，Exchange保护的月度使用量（邮箱数）。 -
encryptionMonthlyUsage，全盘加密的月度使用量。 -
atsMonthlyUsage，沙箱分析器和HyperDetect的月度使用量。 -
edrMonthlyUsage，端点检测与响应（EDR）的月度使用量。 -
edrStorage90DaysUsage，使用EDR且事件保留期为90天的端点数量。 -
edrStorage180DaysUsage，使用EDR且事件保留期为180天的端点数量。 -
edrStorage1YearUsage，使用EDR且事件保留期为1年的端点数量。 -
containerProtectionMonthlyUsage，容器保护的月度使用量。 -
integrityMonitoringUsage，使用完整性监控的端点总数。 -
integrityMonitoring90DaysUsage，使用完整性监控且事件保留期为90天的端点数量。 -
integrityMonitoring180DaysUsage，使用完整性监控且事件保留期为180天的端点数量。 -
integrityMonitoring1YearUsage，使用完整性监控且事件保留期为1年的端点数量。 -
xdrIdentitySensorsMonthlyUsage，传感器管理中Azure AD和Active Directory集成的月度使用量。 -
xdrProductivitySensorsMonthlyUsage，传感器管理中Office 365集成的月度使用量。 -
xdrNetworkSensorsMonthlyUsage，传感器管理中网络传感器集成的月度使用量。 -
xdrCloudSensorsMonthlyUsage，传感器管理中AWS集成的月度使用量。 -
patchManagementMonthlyUsage，补丁管理的月度使用量。 -
sveVsMonthlyUsage，使用安全服务器扫描的虚拟服务器的月度使用量。 -
sveVdiMonthlyUsage，使用安全服务器扫描的虚拟桌面的月度服务使用量（以小时计）。 -
phasrMonthlyUsage，使用PHASR的端点总数。 -
easmMonthlyUsage，使用EASM的端点总数。 -
complianceMonthlyUsage，使用合规管理器插件的端点总数。
对于Bitdefender EDR，该对象包含以下成员：
-
productType，产品类型。 -
endpointMonthlyUsage，使用本地引擎扫描的端点的月度使用量。 -
mdrFoundationsMonthlyUsage，MDR基础服务（MdrFoundations）的月度使用量。
-
-
minimumUsage- 包含许可证类型及公司通过法律协议承诺每月使用的最小槽位数的对象：-
endpointMonthlyUsage，客户同意从主许可证中使用的最低端点数量。
如果查询的公司没有月度许可证或订阅，该方法返回0。
-
示例
请求 :
{
"params": {
"targetMonth": "03/2015","companyId": "55115935b1a43dcc4a7b23c6"},
"jsonrpc": "2.0",
"method": "getMonthlyUsagePerProductType",
"id": "5087eab8-b74f-4a3e-85b3-4271e85890d4"
}
响应 :
{
"result": {
"usages": [
{
"endpointMonthlyUsage": 3,
"encryptionMonthlyUsage": 0,
"atsMonthlyUsage": 0,
"edrMonthlyUsage": 0,
"edrStorage90DaysUsage": 0,
"edrStorage180DaysUsage": 0,
"edrStorage1YearUsage": 0,
"mdrFoundationsMonthlyUsage": 0,
"patchManagementMonthlyUsage": 0,
"integrityMonitoringUsage": 0,
"integrityMonitoring90DaysUsage": 0,
"integrityMonitoring180DaysUsage": 0,
"integrityMonitoring1YearUsage": 0,
"sveVsMonthlyUsage": 0,
"sveVdiMonthlyUsage": 0,
"emailSecurityMonthlyUsage": 0,
"mobileSecurityMonthlyUsage": 0,
"exchangeMonthlyUsage": 0,
"containerProtectionMonthlyUsage": 0,
"xdrIdentitySensorsMonthlyUsage": 0,
"xdrProductivitySensorsMonthlyUsage": 0,
"xdrNetworkSensorsMonthlyUsage": 0,
"xdrCloudSensorsMonthlyUsage": 0,
"phasrMonthlyUsage": 3,
"easmMonthlyUsage": 2,
"complianceMonthlyUsage": 2,
"productType": 0,
"aLaCarteMonthlyUsage": 0,
"mspSecureMonthlyUsage": 3,
"mspSecurePlusMonthlyUsage": 0,
"mspSecureExtraMonthlyUsage": 0
},
{
"endpointMonthlyUsage": 0,
"mdrFoundationsMonthlyUsage": 0,
"productType": 3
}
]
},
"jsonrpc": "2.0",
"id": "2821",
"error": null
}