Importation d'annotations
Suggérer des modifications
PDF
Data Infrastructure Insights inclut une API pour importer des annotations ou des applications à partir d'un fichier CSV et les attribuer aux objets que vous spécifiez.
|
L'API Data Infrastructure Insights est disponible dans Data Infrastructure Insights Premium Edition. |
Importation
Les liens Admin > API Access contiennent "documentation" pour l'API Assets/Import. Cette documentation contient des informations sur le format de fichier .CSV.
Format de fichier .CSV
Le format général du fichier CSV est le suivant : La première ligne du fichier définit les champs d'importation et spécifie l'ordre des champs. Cette opération est suivie de lignes distinctes pour chaque annotation ou application. Il n'est pas nécessaire de définir chaque champ. Toutefois, les lignes d'annotation suivantes doivent suivre le même ordre que la ligne de définition.
[Object Type] , [Object Name or ID] , Annotation Type [, Annotation Type, ...] [, Application] [, Tenant] [, Line_Of_Business] [, Business_Unit] [, Project] Reportez-vous à la documentation API pour des exemples de fichiers .CSV.
Vous pouvez importer et attribuer des annotations à partir d'un fichier .CSV à partir de l'outil de swagger de l'API lui-même. Il vous suffit de choisir le fichier à utiliser et de cliquer sur le bouton Execute :
Comportement d'importation
Lors de l'importation, des données sont ajoutées, fusionnées ou remplacées, en fonction des objets et des types d'objets en cours d'importation. Lors de l'importation, gardez à l'esprit les comportements suivants.
-
Ajoute une annotation ou une application si aucune n'existe avec le même nom dans le système cible.
-
Fusionne une annotation si le type d'annotation est une liste et qu'une annotation avec le même nom existe dans le système cible.
-
Remplace une annotation si le type d'annotation est autre qu'une liste et qu'une annotation du même nom existe dans le système cible.
Remarque : si une annotation portant le même nom mais avec un type différent existe dans le système cible, l'importation échoue. Si les objets dépendent de l'annotation qui a échoué, ces objets peuvent afficher des informations incorrectes ou indésirables. Vous devez vérifier toutes les dépendances des annotations une fois l'opération d'importation terminée.
-
Si une valeur d'annotation est vide, cette annotation est supprimée de l'objet. Les annotations héritées ne sont pas affectées.
-
Les valeurs d'annotation de type de date doivent être transmises en millisecondes sous forme d'heure unix.
-
Lors de l'annotation des volumes ou des volumes internes, le nom de l'objet combine le nom du stockage et le nom du volume en utilisant le séparateur «-> ». Par exemple : <Nom du stockage>-><Nom du volume>
-
Si un nom d'objet contient une virgule, le nom entier doit être entre guillemets. Par exemple : « NetApp1,NetApp2 »-> 023F
-
Lorsque vous fixez des annotations aux stockages, commutateurs et ports, la colonne « application » est ignorée.
-
Locataire, secteur_d'activité, entité_commerciale et/ou projet fait une entité commerciale. Comme pour toutes les entités métier, toutes les valeurs peuvent être vides.
Les types d'objet suivants peuvent être annotés.
TYPE D'OBJET |
NOM OU TOUCHE |
Hôte |
id-><ID> ou <Nom> ou <IP> |
VM |
id-><ID> ou <Nom> |
Poolde stockage |
id-><ID> ou <Nom du stockage>-><Nom du pool de stockage> |
Volume interne |
id-><ID> ou <Nom du stockage>-><Nom du volume interne> |
Volumétrie |
id-><ID> ou <Nom du stockage>-><Nom du volume> |
Stockage |
id-><ID> ou <Nom> ou <IP> |
Commutateur |
id-><ID> ou <Nom> ou <IP> |
Port |
id-><ID> ou <WWN> |
Qtree |
id-><ID> ou <Nom du stockage>-><Nom du volume interne>-><Nom du qtree> |
Partagez |
id-><ID> ou <Nom du stockage>-><Nom du volume interne>-><Nom du partage>-><Protocole>[-><Nom du qtree (facultatif en cas de qtree par défaut)>] |