创建新租户

取决于调用 REST API 方法时指定的租户类型，可以执行下列操作：

• 对于完全租户类型：
  • 将租户数据添加至 Integration Server 数据库。
  • 在 Kaspersky Security Center 中创建租户保护基础架构（虚拟管理服务器、连接用的账户、文件夹和管理组结构）。
  • 在 Multitenancy KSV LA → <租户名称> 文件夹中，创建用于为已安装 Kaspersky Security for Virtualization 5.1 Light Agent 的虚拟机启用和禁用保护机制的策略。

    仅在租户虚拟基础架构中安装了 Kaspersky Security for Virtualization 5.1 Light Agent 的情况下，才会应用保护机制启用和禁用策略。

  • 将租户虚拟管理服务器信息添加至 Integration Server 数据库。
• 对于单纯租户类型：将租户数据添加至 Integration Server 数据库。

方法：

POST /api/2.0/virtualization/tenants

请求正文中必须指定以下参数：

<tenant>

<name>{名称}</name>

<description>{描述}</description>

<userData><![CDATA[{其他信息}]]></userData>

<preferredViisAddress>{IP 地址}</preferredViisAddress>

<type>{租户类型}</type>

<!-- vKsc 区域中的数据仅可对完全租户类型指定 -->

<vKsc>

<user>

<name>{管理员名称}</name>

<password>{管理员密码}</password>

</user>

</vKsc>

</tenant>

其中：

• {名称} – 租户名称（必需参数）。
• {描述} – 租户描述（可选参数）。
• {其他信息} – 有关租户的其他信息（可选参数）。
• {IP 地址} – 安装在租户虚拟机上的 Light Agent 将连接到的 Integration Server 的 IP 地址（可选参数）。指定地址在创建 Light Agent 策略时得到默认使用。如果未指定参数，策略将使用来自 REST API 请求的 Integration Server IP 地址。
• {租户类型} – 租户类型：Complete 或 Simple（可选参数）。
• {管理员名称} – 用于连接到租户虚拟管理服务器的管理员账户的名称（创建完全租户类型时必需）。账户将在过程中自动创建。
• {管理员密码} – 用 Base64 方法编码的管理员账户密码（创建完全租户类型时必需）。

请求异步执行，REST API 返回“创建租户”任务的识别符。您可以使用“任务”监控租户创建过程的进度。任务执行完成后，“结果”字段会显示包括已创建的租户的识别符在内的信息，或错误消息。如果过程的任何一步发生错误，所有更改将被回滚。

返回代码：

• 202 (Accepted) – 请求被接受进行执行。响应返回“已创建租户”任务的识别符。
• 400 (Bad request) VIRMT_MandatoryParameterIsNotSpecified – 所需参数之一，比如租户名称，没有在请求正文中进行指定。
• 400 (Bad request) VIRMT_InvalidTenantType – 请求正文中指定的租户类型无效，指定的租户类型不存在。
• 400 (Bad request) VIRMT_VKscCredentialsNotSpecified – Kaspersky Security Center 虚拟管理服务器管理员账户的名称或密码未指定（创建完全租户类型时）。
• 400 (Bad request) VIRMT_InvalidViisAddressFormat – Integration Server IP 地址的格式无效。
• 403 (Forbidden) – 资源访问被拒绝。

任务中可能的错误代码：

• KSC_ServiceNotConfigured – Kaspersky Security Center 连接设置未指定。
• VIRMT_TenantGroupAlreadyExists – 名称对应于指定租户名称的文件夹已存在于 Kaspersky Security Center 中。
• VIRMT_TenantWithSpecifiedNameAlreadyExists – 具有指定名称的租户已存在于 Integration Server 数据库中。
• VIRMT_PasswordNotComplyPolicy – 未能为 Kaspersky Security Center 虚拟管理服务器创建管理员账户：指定密码不符合 Kaspersky Security Center 密码要求。
• VIRMT_UserWithSpecifiedNameAlreadyExists – 未能为 Kaspersky Security Center 虚拟管理服务器创建管理员账户：一个具有指定名称的用户已存在于 Kaspersky Security Center 中。