建立新租戶

視呼叫 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 的情況。如需更多資訊，請參閱 Kaspersky Security for Virtualization 5.1 Light Agent 說明。

  • 將租戶虛擬管理伺服器資訊新增至 Integration Server 資料庫。
• 對於單純租戶類型：將租戶資料新增至 Integration Server 資料庫。

方法：

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 – 無法建立卡巴斯基安全管理中心虛擬管理伺服器的管理帳戶：卡巴斯基安全管理中心中已存在具有指定名稱的使用者。