检索 Control Room 许可证详细信息 API
检索 Control Room 许可证的详细信息,包括许可证类型、到期日期、故障保护状态和许可证服务器同步状态。
过程
-
使用 GET 方法和端点 URL:
<your_control_room_url>/v2/license/details
。 -
发送请求。
响应正文:在成功请求中,此端点返回以下数据:
failSafeStatus
:代表 Cloud Control Room 的故障保护状态的数值。值:0 表示 Control Room 已连接,1 表示 Control Room 处于故障保护模式,2 表示故障保护状态已过期。如果 Control Room 配置了文件许可证,则返回的值始终为 0。
controlRoomLicenseServerSyncStatus
:一个布尔值,用于确定 Control Room 中的许可证分配是否与许可证服务器同步。licenseMode
:Control Room 许可证是通过文件还是通过与许可证服务器的连接进行配置。../dashboards/cloud-administration-licenses.html#cloud-administration-licenses__entitlement-models
在此第一个示例响应中,licenseMode
确认 Control Room 位于基于文件的许可证上,因此failSafeStatus
为 0,且不会为installedCrId
返回任何值。{ "type": "PURCHASED", "installationDate": "2020-09-09T15:06:05.211Z", "expirationDate": "2021-06-30T18:29:59.999Z", "failSafeStatus": 0, "controlRoomLicenseServerSyncStatus": true, "installedCrId": "", "licenseMode": "FileLicense" }
在第二个示例响应中,licenseMode
确认 Control Room 位于基于云的许可证上,failSafeStatus
返回了 1,这意味着到其他 Control Room API 的请求将失败,直到与许可证服务器重新建立连接,并且ControlRoomLicenseServerSyncStatus
返回 false。{ "type": "PURCHASED", "installationDate": "2020-09-14T18:30:00Z", "expirationDate": "2021-04-27T18:30:00Z", "failSafeStatus": 1, "controlRoomLicenseServerSyncStatus": false, "installedCrId": "b96edac7-b7e3-57bf-b857-ad14ac754674", "licenseMode": "CloudLicense" }
REST API 用 HTTP 响应代码响应每个请求。有关响应代码的详细信息,请参阅 API 响应代码。
后续步骤
controlRoomLicenseServerSyncStatus
参数返回 False
,请使用同步端点从许可证服务器更新许可证分配和到期日期。