Skip to main content
Cloud Insights
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Importation d'annotations

Contributeurs

Cloud Insights comprend une API permettant d'importer des annotations ou des applications à partir d'un fichier CSV et de les attribuer aux objets que vous spécifiez.

Remarque L'API Cloud Insights est disponible dans Cloud Insights Édition Premium.

Importation

Les liens Admin > API Access contiennent "documentation" Pour l'API Assets/Import. Cette documentation contient des informations sur le format de fichier .CSV.

API d'importation

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 :

Importer et affecter

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)>]