getMonthlyUsage аргаар сарын хэрэглээг авах

Энэ арга нь компанийн сонгосон сарын хэрэглээг харуулна. Зөвхөн үндсэн бүтээгдэхүүний төрөл болох Endpoint Security-тэй endpoint-уудын хэрэглээг буцаана. Бусад бүтээгдэхүүний төрлийн хэрэглээ хэрэгтэй бол getMonthlyUsagePerProductType аргыг үзнэ үү.

Параметрууд

• targetMonth — төрөл: String; заавал: Тийм. Хэрэглээг буцаах сар. Дараах хэлбэртэй байна: mm/yyyy. Үндсэн утга нь одоогийн сар.
• usageCoverageType — төрөл: Integer; заавал биш. Зөвхөн тодорхой хугацааны завсарт үүсгэсэн компаниудын сарын хэрэглээг буцаана. Хайх хугацааг companyRegistrationStartDate болон companyRegistrationEndDate параметрээр заана. Боломжит утга: 3.

- Тэмдэглэл: Энэ параметрийг зөвхөн хүсэлтэд companyRegistrationStartDate болон companyRegistrationEndDate байгаа тохиолдолд ашиглана.

• companyRegistrationStartDate — төрөл: String; заавал биш. Зөвхөн энэ огнооноос хойш үүсгэсэн компаниудын сарын хэрэглээг буцаана.

- Тэмдэглэл: Хүсэлтэд ашигласан цагийг UTC гэж тооцно.

• companyRegistrationEndDate — төрөл: String; заавал биш. Зөвхөн энэ огнооноос өмнө үүсгэсэн компаниудын сарын хэрэглээг буцаана.

- Тэмдэглэл: Хүсэлтэд ашигласан цагийг UTC гэж тооцно.

• productType — төрөл: Integer; заавал биш. Тодорхой бүтээгдэхүүний төрлийн сарын хэрэглээг буцаана. Боломжит утга:

- 0 — Endpoint Security
- 3 — Bitdefender EDR
- 5 — Bitdefender PHASR

Буцаах утга

Энэ арга нь заасан сард худалдан авсан үйлчилгээ тус бүрээр ашигласан лицензийн эрхийн тоог агуулсан Object буцаана. Хэрэв хайсан компанид сарын лиценз байхгүй бол 0 буцаана:

• endpointMonthlyUsage — локал engine-ээр шалгагдсан бүх endpoint-ын сарын хэрэглээ.

• aLaCarteMonthlyUsage — A-la-carte хамгаалалтын загвар ашигладаг компаниудын локал engine-ээр шалгагдсан endpoint-уудын сарын хэрэглээ.

• mspSecureEssentialsMonthlyUsage — Secure Essentials хамгаалалтын загвар ашигладаг компаниудын локал engine-ээр шалгагдсан endpoint-уудын сарын хэрэглээ.

• mspSecureMonthlyUsage — Secure хамгаалалтын загвар ашигладаг компаниудын локал engine-ээр шалгагдсан endpoint-уудын сарын хэрэглээ.

• mspSecurePlusMonthlyUsage — Secure Plus хамгаалалтын загвар ашигладаг компаниудын локал engine-ээр шалгагдсан endpoint-уудын сарын хэрэглээ.

• mspSecureExtraMonthlyUsage — Secure Extra хамгаалалтын загвар ашигладаг компаниудын локал engine-ээр шалгагдсан endpoint-уудын сарын хэрэглээ.

• emailSecurityMonthlyUsage — Email Security mailbox-уудын сарын хэрэглээ.

• mobileSecurityMonthlyUsage — Mobile Security төхөөрөмжүүдийн сарын хэрэглээ.

• exchangeMonthlyUsage — Exchange mailbox-уудын сарын хэрэглээ.

• encryptionMonthlyUsage — шифрлэлтийн модулийн сарын хэрэглээ.

• atsMonthlyUsage — Sandbox Analyzer болон HyperDetect модулиудын сарын хэрэглээ.

• edrMonthlyUsage — EDR модулийн сарын хэрэглээ.

• edrStorage90DaysUsage — үйл явдлыг 90 хоног хадгалдаг EDR ашигладаг endpoint-ын тоо.

• edrStorage180DaysUsage — үйл явдлыг 180 хоног хадгалдаг EDR ашигладаг endpoint-ын тоо.

• edrStorage1YearUsage — үйл явдлыг 1 жил хадгалдаг EDR ашигладаг endpoint-ын тоо.

• phasrMonthlyUsage — PHASR ашигладаг endpoint-уудын нийт тоо.

• easmMonthlyUsage — EASM ашигладаг endpoint-уудын нийт тоо.

Энэ параметр нь productType-ыг 0 (Endpoint Security) эсвэл 5 (Bitdefender PHASR) гэж тохируулсан үед боломжтой.

• complianceMonthlyUsage — Compliance Manager add-on ашигладаг endpoint-уудын нийт тоо.

Энэ параметр нь productType-ыг 0 (Endpoint Security) эсвэл 5 (Bitdefender PHASR) гэж тохируулсан үед боломжтой.

• aiSpmMonthlyUsage — AI Visibility and Control add-on ашигладаг endpoint-уудын нийт тоо.

Энэ параметр нь productType-ыг 0 (Endpoint Security) гэж тохируулсан үед боломжтой.

• mdrFoundationsMonthlyUsage — MDR Foundations үйлчилгээний сарын хэрэглээ.

• patchManagementMonthlyUsage — patch management модулийн сарын хэрэглээ.

Энэ параметр нь productType-ыг 0 (Endpoint Security) эсвэл 5 (Bitdefender PHASR) гэж тохируулсан үед боломжтой.

• containerProtectionMonthlyUsage — container protection модулийн сарын хэрэглээ.

• integrityMonitoringUsage — Integrity Monitoring ашигладаг endpoint-уудын нийт тоо.

• integrityMonitoring90DaysUsage — үйл явдлыг 90 хоног хадгалдаг Integrity Monitoring ашигладаг endpoint-ын тоо.

• integrityMonitoring180DaysUsage — үйл явдлыг 180 хоног хадгалдаг Integrity Monitoring ашигладаг endpoint-ын тоо.

• integrityMonitoring1YearUsage — үйл явдлыг 1 жил хадгалдаг Integrity Monitoring ашигладаг endpoint-ын тоо.

• xdrIdentitySensorsMonthlyUsage — Sensors Management доторх Azure AD болон Active Directory интеграцийн сарын хэрэглээ.

• xdrProductivitySensorsMonthlyUsage — Sensors Management доторх Office 365 интеграцийн сарын хэрэглээ.

• xdrNetworkSensorsMonthlyUsage — Sensors Management доторх Network Sensor интеграцийн сарын хэрэглээ.

• xdrCloudSensorsMonthlyUsage — Sensors Management доторх AWS интеграцийн сарын хэрэглээ.

• sveVsMonthlyUsage — Security Server-ээр шалгагдсан виртуал серверүүдийн сарын хэрэглээ.

• sveVdiMonthlyUsage — Security Server-ээр шалгагдсан виртуал ширээний компьютеруудын сарын үйлчилгээний хэрэглээ (цагаар).

• minimumUsage — лицензийн төрлүүд болон компани сар бүр ашиглахаар хууль эрх зүйн гэрээгээр амласан эрхийн хамгийн бага тоог агуулсан Object:

- endpointMonthlyUsage — үндсэн лицензээс үйлчлүүлэгч ашиглахаар тохирсон endpoint-уудын хамгийн бага тоо.

Жишээ

Хүсэлт

Endpoint Security бүтээгдэхүүний төрлийг ашигладаг компани.

{
    "params": {
        ,
        "targetMonth": "11/2023",
        "usageCoverageType": 3,
        "companyRegistrationStartDate": "2023-09-01T10:03:34",
        "companyRegistrationEndDate": "2023-10-01T12:06:33",
        "productType": 0
    },
    "jsonrpc": "2.0",
    "method": "getMonthlyUsage",
    "id": "5087eab8-b74f-4a3e-85b3-4271e85890d4"
 }

Bitdefender PHASR бүтээгдэхүүний төрлийг ашигладаг компани.

{
    "params": {
        "companyId": "5493dcd2b1a43df00b7b23c6",
        "targetMonth": "04/2026",
        "productType": 5
    },
    "jsonrpc": "2.0",
    "method": "getMonthlyUsage",
    "id": "c3d4e5f6-3333-4444-5555-666677778888"
}

Хариу

Endpoint Security бүтээгдэхүүний төрөл болон A la carte хамгаалалтын загвар ашигладаг компани.

{
    "id": "5087eab8-b74f-4a3e-85b3-4271e85890",
    "jsonrpc": "2.0",
    "result": {
        "endpointMonthlyUsage": 1,
        "encryptionMonthlyUsage": 0,
        "extendedEmailSecurityMonthlyUsage": 0,
        "mobileSecurityMonthlyUsage": 0,
        "exchangeMonthlyUsage": 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,
        "containerProtectionMonthlyUsage": 0,
        "xdrIdentitySensorsMonthlyUsage": 0,
        "xdrProductivitySensorsMonthlyUsage": 0,
        "xdrNetworkSensorsMonthlyUsage": 0,
        "xdrCloudSensorsMonthlyUsage": 0,
        "phasrMonthlyUsage": 0,
        "easmMonthlyUsage": 0,
        "complianceMonthlyUsage": 2,
        "aLaCarteMonthlyUsage": 1,
        "mspSecureEssentialsMonthlyUsage": 3,
        "mspSecureMonthlyUsage": 0,
        "mspSecurePlusMonthlyUsage": 0,
        "mspSecureExtraMonthlyUsage": 0,
        "endpointMonthlyUsage": 2
      },
      "jsonrpc": "2.0",
      "id": "5986",
      "error": null
}

Endpoint Security бүтээгдэхүүний төрөл болон Secure хамгаалалтын загвар ашигладаг компани.

{
      "id": "5087eab8-b74f-4a3e-85b3-4271e85890",
      "jsonrpc": "2.0",
      "result": {
        "endpointMonthlyUsage": 1,
        "encryptionMonthlyUsage": 0,
        "extendedEmailSecurityMonthlyUsage": 0,
        "aiSpmMonthlyUsage": 1,
        "mobileSecurityMonthlyUsage": 0,
        "exchangeMonthlyUsage": 0,
        "atsMonthlyUsage": 0,
        "edrMonthlyUsage": 0,
        "edrStorage90DaysUsage": 0,
        "edrStorage180DaysUsage": 0,
        "edrStorage1YearUsage": 0,
        "mdrFoundationsMonthlyUsage": 0,
        "patchManagementMonthlyUsage": 0,
        "integrityMonitoringUsage": 0,
        "integrityMonitoring90DaysUsage": 0,
        "integrityMonitoring180DaysUsage": 0,
        "integrityMonitoring1YearUsage": 0,
        "xdrIdentitySensorsMonthlyUsage": 0,
        "xdrProductivitySensorsMonthlyUsage": 0,
        "xdrNetworkSensorsMonthlyUsage": 0,
        "xdrCloudSensorsMonthlyUsage": 0,
        "phasrMonthlyUsage": 2,
        "easmMonthlyUsage": 1,
        "complianceMonthlyUsage": 2,
        "aLaCarteMonthlyUsage": 1,
        "mspSecureEssentialsMonthlyUsage": 3,
        "mspSecureMonthlyUsage": 0,
        "mspSecurePlusMonthlyUsage": 0,
        "mspSecureExtraMonthlyUsage": 0
      },
      "jsonrpc": "2.0",
      "id": "5986",
      "error": null
}

Bitdefender PHASR бүтээгдэхүүний төрлийг ашигладаг компани.

{
    "id": "5087eab8-b74f-4a3e-85b3-4271e85890",
    "jsonrpc": "2.0",
    "result": {
        "endpointMonthlyUsage": 101,
        "complianceMonthlyUsage": 101,
        "patchManagementMonthlyUsage": 101,
        "easmMonthlyUsage": 101,
        "minimumUsage": {
        "endpointMonthlyUsage": 25
    }
}