Suppression d'un locataire
14 décembre 2023
ID 259255
Permet de réaliser les opérations suivantes selon le type de locataires et les paramètres spécifiés :
- Pour un locataire de type « complet » :
- Supprimer informations relatives au locataire et à ses machines virtuelles de la base de données du Serveur d'intégration.
- Supprimer la structure de protection du locataire dans Kaspersky Security Center (Serveur d'administration virtuel, compte de connexion à celui-ci, structure des dossiers et des groupes d'administration, stratégies, tâches et paquets d'installation). S'il n'y a pas d'autres locataires, le dossier Multitenancy KSV LA est également supprimé.
- Supprimer les informations sur le Serveur d'administration virtuel du locataire de la base de données du Serveur d'intégration.
L'invocation de la méthode de suppression du locataire ne désactive pas la protection sur les machines virtuelles du locataire. Pour désactiver la protection, vous devez effectuer toutes les étapes de la procédure de suppression du locataire, y compris la suppression de Light Agent for Windows, Light Agent for Linux et de l'Agent d'administration Kaspersky Security Center sur les machines virtuelles. Si vous souhaitez suspendre la protection des machines virtuelles du locataire de type « complet », vous pouvez utiliser la méthode de désactivation du locataire.
- Pour un locataire de type « simplifié » : supprimer le locataire de la base de données du Serveur d'intégration.
Méthode :
DELETE /api/2.0/virtualization/tenants/{identifiant du locataire}?removeTenantArtifacts={true|false}
où :
{identifiant du locataire}: identifiant du locataire dans la base de données du Serveur d'intégration (paramètre obligatoire).removeTenantArtifacts={true|false}: paramètre facultatif qui détermine la nécessité de supprimer la structure de protection du locataire lors de la suppression du locataire de la base de données du Serveur d'intégration. Valeurs possibles :true: lors de la suppression d'un locataire, les actions suivantes sont également effectuées :- suppression du Serveur d'administration virtuel du locataire ;
- suppression du compte administrateur du Serveur d'administration virtuel du locataire ;
- suppression du dossier Multitenancy KSV LA → <Nom du client> et de son contenu ;
- suppression du dossier Multitenancy KSV LA en l'absence d'autres locataires.
false: seul le locataire est supprimé de la base de données du Serveur d'intégration, la structure de protection du locataire n'est pas supprimée.
La demande est exécutée de manière asynchrone, l'API REST renvoie un identificateur de tâche de type DeleteTenant. La tâche permet de surveiller la progression de la procédure de suppression du locataire. Une fois la tâche terminée, le champ result contient des informations sur le locataire supprimé ou des informations sur l'erreur.
En cas d'erreur à l'une des étapes de la procédure, toutes les modifications apportées sont restaurées.
Codes de retour :
202 (Accepted): la demande est acceptée. La réponse renvoie l'identifiant de la tâche de type DeleteTenant.403 (Forbidden): l'accès à la ressource est refusé.
Codes d'erreur dans la tâche :
VIRMT_TenantWithSpecifiedIdNotFound: le locataire portant l'identifiant spécifié est introuvable dans la base de données du Serveur d'intégration.KSC_ServiceNotConfigured: les paramètres de connexion à Kaspersky Security Center ne sont pas spécifiés.