取决于调用 REST API 方法时指定的租户类型,可以执行下列操作:
仅在租户虚拟基础架构中安装了 Kaspersky Security for Virtualization 5.1 Light Agent 的情况下,才会应用保护机制启用和禁用策略。
方法:
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 中。