視呼叫 REST API 方法時指定的租戶類型,可以執行下列操作:
啟用和停用防護的政策僅適用於已在租戶虛擬基礎架構中安裝 Kaspersky Security for Virtualization 5.1 Light Agent 的情況。
方法:
POST /api/2.0/virtualization/tenants
在要求主體中必須指定以下參數:
</tenant>
<name>{name
}</name>
<description>{description
}</description>
<userData><![CDATA[{其他資訊
}]]></userData>
<preferredViisAddress>{IP address
}</preferredViisAddress>
<type>{tenant type
}</type>
<!-- vKsc 區域中的資料僅可對完全租用户類型指定 -->
<vKsc>
<user>
<name>{administrator name
}</name>
<password>{administrator password
}</password>
</user>
</vKsc>
</tenant>
其中:
{
name
}
– 租戶名稱(必要參數)。{
description
}
– 租戶描述(可選參數)。{
additional information
}
– 關於租戶的其他資訊(可選參數)。{
IP address
}
– Integration Server 的 IP 位址,安裝在租戶虛擬機上的 Light Agents 將會連線到該位址(可選參數)。建立 Light Agent 政策時,預設會使用指定位址。若未指定參數,政策將使用來自對 REST API 請求的 Integration Server IP 位址。{
tenant type
}
– 租戶類型: Complete
或 Simple
(可選參數)。{
administrator name
}
– 用於連線到租戶虛擬管理伺服器的管理員帳戶名稱(建立完全租戶類型時需要)。帳戶將在程序中自動建立。{
administrator password
}
– 以 Base64 法編碼的管理員帳戶密碼(建立完全租戶類型時需要)。請求以非同步方式執行,REST API 將返回 CreateTenant 工作的識別碼。您可以使用工作監控租戶建立程序的進度。工作執行完成後,結果欄位會顯示有關租戶的資訊(包括已建立的租戶識別碼)或錯誤訊息。如果程序中任何一步發生錯誤,將會回溯所有變更。
返回代碼:
202 (Accepted)
– 已接受執行請求。回應返回 CreateTenant 工作的識別碼。400 (Bad request) VIRMT_MandatoryParameterIsNotSpecified
– 有一個必要參數未在要求主體中指定,例如租戶名稱。400 (Bad request) VIRMT_InvalidTenantType
– 在請求正文中指定了無效的租戶類型,指定的租戶類型不存在。400 (Bad request) VIRMT_VKscCredentialsNotSpecified
– 未指定卡巴斯基安全管理中心虛擬伺服器的管理員帳戶名稱或密碼(建立完全租戶類型時)。400 (Bad request) VIRMT_InvalidViisAddressFormat
– Integration Server IP 位址的格式無效。403 (Forbidden)
– 存取資源遭拒。工作中的可能錯誤代碼:
KSC_ServiceNotConfigured
– 未指定卡巴斯基安全管理中心連線設定。VIRMT_TenantGroupAlreadyExists
– 具有與指定租戶名稱相對應名稱的資料夾,已存在卡巴斯基安全管理中心中。VIRMT_TenantWithSpecifiedNameAlreadyExists
– 具有指定名稱的租戶已存在 Integration Server 資料庫中。VIRMT_PasswordNotComplyPolicy
– 無法建立卡巴斯基安全管理中心虛擬管理伺服器的管理員帳戶:指定的密碼不符合卡巴斯基安全管理中心密碼要求。VIRMT_UserWithSpecifiedNameAlreadyExists
– 無法建立卡巴斯基安全管理中心虛擬管理伺服器的管理帳戶:卡巴斯基安全管理中心中已存在具有指定名稱的使用者。