Introduction
Ce document décrit les étapes requises pour ajouter des balises dans Cisco Intersight à la fois dans l'interface utilisateur et via l'API. Actuellement, le portail Web Intersight ne prend pas en charge le balisage de tous les objets (voir CSCvs33046), mais presque tous les objets peuvent également être balisés via l'API.
Conditions requises
- Accès au compte au niveau administrateur
- Accès aux points de terminaison API (si vous utilisez l'API) Exemple : iam.Account endpoint
Mise à jour des balises via l'interface utilisateur de Cisco Intersight
Prérequis
Authentifier
Vérifiez que vous êtes authentifié auprès du compte dans lequel vous souhaitez mettre à jour les objets. Vérifiez que vous êtes connecté en tant qu'administrateur de compte. Cliquez sur le nom en haut à droite pour afficher le nom actuel du compte, l'ID du compte, l'e-mail et le rôle.

Mise à jour des balises de compte
- Dans Intersight, sélectionnez Gear and Settings :

2. Dans le volet Paramètres, assurez-vous que l'onglet Détails du compte est sélectionné et appuyez sur le bouton Configurer :

3. Dans l'entrée Définir les balises, saisissez les balises souhaitées :

Note: Si la balise n'a pas été utilisée auparavant dans le compte, elle n'apparaîtra pas comme une prédiction, c'est ok, appuyez simplement sur Entrée après avoir saisi votre balise. La balise doit être entrée dans « key: valeur », par exemple ci-dessus, que nous avons entré :
AutoRMAEmail: kmccabe2@cisco.com,sttardy@cisco.com
Cela créera une balise avec une clé AutoRMAEmail et une valeur de kmccabe2@cisco.com,sttardy@cisco.com .
4. Après avoir appuyé sur Entrée, cliquez sur Enregistrer :

6. Les balises sont maintenant visibles sur le compte :

Mise à jour à partir de la vue de liste
De nombreux objets affichés dans une vue de liste dans Intersight peuvent être balisés. Par exemple, serveurs, clusters, interconnexions de fabric, châssis, etc.
Remarque : Si vous utilisez des balises pour la configuration de la fonctionnalité RMA proactive, aucun des éléments (serveur, interconnexions de fabric, etc.) qui prennent en charge le marquage dans l'interface utilisateur autre que les comptes (voir ci-dessus) ne sera honoré. N'utilisez pas les étapes ci-dessous pour configurer les balises RMA proactives.
1. Dans la vue de liste donnée, sélectionnez les entrées que vous souhaitez marquer :

2. Appuyez sur le bouton de balise (en regard des trois points) :

3. Entrez des balises dans la boîte de dialogue :

Note: Si la balise n'a pas été utilisée auparavant dans le compte, elle n'apparaîtra pas comme une prédiction, c'est ok, appuyez simplement sur Entrée après avoir saisi votre balise. La balise doit être entrée dans « key: valeur », par exemple ci-dessus, nous avons entré Lieu : RTP . Cela créera une balise avec une clé Location et une valeur RTP.
4. Après avoir appuyé sur Entrée, cliquez sur Enregistrer :

Mise à jour des balises via l'API
Prérequis
Authentifier
Les administrateurs qui souhaitent marquer le compte doivent être connectés à Intersight. Lorsque vous êtes connecté, le coin supérieur droit de l'écran doit afficher le nom de l'administrateur, comme indiqué dans l'image ci-dessous.

Les administrateurs qui ne sont pas connectés verront Se connecter au lieu de leur nom comme indiqué dans l'image ci-dessous.

En outre, les administrateurs doivent être authentifiés auprès du compte approprié qui contient les objets à baliser. Cliquez sur le nom en haut à droite pour afficher le nom actuel du compte, l'ID du compte, l'e-mail et le rôle.

Étiquetage d'une organisation
1. Ouvrir les documents API pour les organisations
Accédez à la page du document api pour les organisations.
Note: Si vous utilisez l'appliance virtuelle connectée, accédez à https://[FQDN de l'appliance]/apidocs/apirefs/organisation/organisations/modèle/ à la place.
2. Identifiez l'organisation que vous souhaitez mettre à jour.
Veuillez consulter le Guide de requête de l'API Intersight pour référence.
Les utilisateurs peuvent simplement utiliser le point de terminaison GET pour répertorier toutes les organisations sans paramètres. S'il y a trop d'organisations dans votre compte pour afficher facilement dans une sortie, les utilisateurs peuvent utiliser un paramètre de requête $select pour limiter les champs affichés, mais s'assurer d'inclure des balises dans l'instruction $select par exemple :

À partir de la sortie de l'API, le champ dont nous avons besoin est le champ Moid, il s'agit d'un identificateur unique pour cette organisation en intervision et sera utilisé dans l'étape suivante, nous devons également obtenir les balises qui sont là pour l'étape suivante.
4. Mettre à jour les balises de l'organisation
Nous allons tirer parti du point de terminaison de l'API PATCH de l'organisation. À partir de là, nous allons utiliser le MOID collecté précédemment dans le champ d'entrée du modèle, et les balises collectées précédemment dans le champ de corps.
Important : assurez-vous que vous n'utilisez pas l'API DELETE, car cela supprimera votre organisation.

Corps de l'exemple d'appel PATCH ci-dessus :
{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}
Toutes les balises existantes qui sont sur l'enregistrement peuvent être ajoutées dans le tableau de balises.
Remarque : si vous suivez cette procédure pour configurer le RMA proactif, les adresses e-mail dans cette section doivent être corrélées à un compte CCO.
Étiquetage d'un périphérique enregistré
1. Ouvrir les documents API pour les périphériques enregistrés
Accédez à la page de documentation API pour les périphériques enregistrés
Note: Si vous utilisez l'appliance virtuelle connectée, accédez à https://[FQDN de l'appliance]/apidocs/apirefs/asset/DeviceRegistration/model/ à la place.
2. Identifier le périphérique enregistré qui doit être mis à jour
Veuillez consulter le Guide de requête de l'API Intersight pour référence
L'une des méthodes les plus simples pour effectuer une requête est par nom d'hôte. Pour ce faire, une requête peut être conçue comme suit :
DeviceHostname eq 'F340-21-22-UCS4'
En tirant parti de $filter et $select, vous obtenez une sortie plus facile à gérer :

3. Utiliser l'API PATCH pour mettre à jour les balises
Extrayez toutes les balises qui sont déjà présentes sur le périphérique enregistré ainsi que le moid du périphérique. Accéder au terminal PATCH, coller dans le Moid dans l'entrée du moid supérieur Par exemple :

Corps de l'exemple d'appel PATCH ci-dessus :
{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}
Toutes les balises existantes qui sont sur l'enregistrement peuvent être ajoutées dans le tableau de balises.
Remarque : si vous suivez cette procédure pour configurer le RMA proactif, les adresses e-mail dans cette section doivent être corrélées à un compte CCO.