--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Gestion des alarmes Ouvrir l'API # Gestion des alarmes Ouvrir l'API {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 28 minutes de lecture L'API ouverte de gestion des alarmes fournit des points de terminaison pour créer, mettre à jour et récupérer des données à partir des tables d'événements \[em_event\] et d'alerte \[em_alert\]. L'API ouverte de gestion des alarmes de télécommunications (sn_ind_tmf642) est une ServiceNow® implémentation de la spécification de l'API ouverte TM Forum. Cette API est basée sur la [spécification REST de l'API TMF642 Alarm Management REST Specification Version 20](https://www.tmforum.org/resources/specification/tmf642-alarm-management-api-user-guide-v4-0/), avril 2020. L'utilisateur appelant doit avoir accès au point de terminaison `sn_ind_tmf642.alarm_mgmt_integration` . Cette API est fournie dans l'espace de noms `sn_ind_tmf642` . La spécification de l'API ouverte TM Forum exige une réponse synchrone pour chaque demande entrante qu'elle reçoit. Appliquez la corrélation et la déduplication dans le système de support opérationnel (OSS) source avant de transmettre les charges utiles au système. Cette API peut être étendue pour effectuer des personnalisations autour des paramètres requis, de la validation du corps de la demande, des opérations REST supplémentaires et des mappages de champs. Pour plus d'informations, voir le [Guide du développeur de l'API ouverte de gestion des alarmes](https://servicenow-prod.fluidtopics.net/ExdecXGRo2U1ZnhULrquXA#alarm-mgmt_dev-guide "Utilisez l’API ouverte de gestion des alarmes pour créer et mettre à jour des données dans la table Événements [em_event]."). L'API ouverte de gestion des alarmes est certifiée conforme par TM Forum. ## Gestion des alarmes API ouverte -- GET /sn_ind_tmf642/alarm_mgmt/alarm {#ariaid-title2} Récupère une liste de tous les enregistrements d'alarme à partir des tables Événements \[em_event\] et Alerte \[em_alert\]. ### Format d'URL URL par défaut : /api/sn_ind_tmf642/alarm_mgmt/alarm ### Paramètres de demande pris en charge {#alarm-GET-alarm__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 1. Paramètres de chemin d'accès] {#alarm-GET-alarm__table_qcn_fkm_qtb__entry__2} | Nom | Description | |-|-| | alarmRaisedTime | Date à laquelle l'alarme a été déclenchée. Seules les alarmes dont la date correspond à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne | | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Champs valides : * alarmedObject * alarmRaisedTime * Type d'alarme * informationsSeuils croisés * ID d'alarme externe * id * perceivedSeverity * Cause probable * source * sourceSystemId (en anglais seulement) * État * type {#alarm-GET-alarm__ul_n1h_htz_54b} Par défaut : Tous les champs Type de données : chaîne | | id | ID d'alarme. Seules les alarmes avec un ID correspondant à la valeur de ce paramètre sont renvoyées dans la réponse. Situé dans le champ Clé du message de la table Événements \[em_event\]. Type de données : chaîne | | limite | Nombre maximal d'enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d'enregistrements, utilisez le paramètre pour paginer la récupération de l'enregistrement offset . Par défaut : 1 000 Maximum : 2000 Type de données : nombre | | décalage | Index de départ auquel commencer à récupérer des enregistrements. Utilisez cette valeur pour paginer la récupération des enregistrements. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit le nombre d'enregistrements, par petits blocs gérables. Par défaut : 0 Type de données : nombre | | Cause probable | Cause probable de l'alarme. Seules les alarmes dont la cause probable correspond à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne | | État | État de l'alarme. Seules les alarmes dont l'état correspond à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne | | sourceSystemId (en anglais seulement) | ID du système source de l'alarme. Seules les alarmes avec un ID système source correspondant à la valeur de ce paramètre sont renvoyées dans la réponse. Type de données : chaîne | [Tableau 2. Paramètres de requête] {#alarm-GET-alarm__table_qcn_fkm_qtb} {#alarm-GET-alarm__entry__24} | Nom | Description | |-|-| | Aucun | | [Tableau 3. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-GET-alarm__table_rgh_drm_qtb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 4. En-têtes de demandes] {#alarm-GET-alarm__table_rgh_drm_qtb} {#alarm-GET-alarm__table_c2r_4gm_lsb__entry__2}{#alarm-GET-alarm__content-range-row}{#alarm-GET-alarm__content-type-row}{#alarm-GET-alarm__links-pagination-row}{#alarm-GET-alarm__x-total-count-descr} | En-tête | Description | |-|-| | Plage de contenu | Spécifie la plage de contenu renvoyée dans un appel paginé. Par exemple, si `offset=2` et `limit=3`, la valeur de l'en-tête Content-Range est `les éléments 3 à 5`. | | Type de contenu | Format de données du corps de la réponse. Ne prend en charge application/jsonque les fichiers . | | Lien | Contient les liens suivants pour parcourir les résultats de la requête. * premier * dernier * suivant * previous {#alarm-GET-alarm__ul_zzk_sdm_lsb} | | X-Total-Count | Pour les requêtes paginées, cet en-tête indique le nombre total d'enregistrements disponibles sur le serveur. | [Tableau 5. En-têtes de réponses] {#alarm-GET-alarm__table_c2r_4gm_lsb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-GET-alarm__table_qbg_4cm_lsb__entry__2}{#alarm-GET-alarm__tmf-get-status-200-p}{#alarm-GET-alarm__tmf-get-status-206-entry}{#alarm-GET-alarm__tmf-get-status-400-entry}{#alarm-GET-alarm__tmf-get-status-404-entry} | Code d'état | Description | |-|-| | 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Raisons possibles : * Paramètre de chemin d'accès non valide * URI non valide {#alarm-GET-alarm__ul_rys_1gy_fsb} | | 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n'a été trouvé dans la table. | [Tableau 6. Codes d'état] {#alarm-GET-alarm__table_qbg_4cm_lsb} ### Paramètres de corps de réponse (JSON) {#alarm-GET-alarm__table_zjc_fbg_qtb__entry__2}{#alarm-GET-alarm__alm-mgmt-affectedService-entry}{#alarm-GET-alarm__alm-mgmt-affectedServiceHREF-entry}{#alarm-GET-alarm__alm-mgmt-create-alarmobj-href-entry}{#alarm-GET-alarm__alm-mgmt-specificProb-ph} | Nom | Description | |-|-| | service affecté | Liste des objets identifiant un ou plusieurs services affectés par l'alarme. Type de données : tableau "affectedService":[ { "href": "String", "id": "String" }, ] | | serviceaffecté.href | Référence d'URL fournissant des détails sur le service affecté. Type de données : chaîne | | affectedService.id | Identificateur du service affecté par l'alarme. Cette valeur est mappée à l'élément de configuration (CI) affecté sur l'alerte. Type de données : chaîne | | alarmDetails (en anglais seulement) | Détails supplémentaires sur l'alarme. Type de données : chaîne | | alarmedObject | Détails de l'objet d'alarme. "alarmedObject": { "href": "String", "id": "String" } Type de données : objet | | alarmedObject.id | Identificateur unique de l'objet d'alarme. Cette valeur est mappée à un CI dans le système. Type de données : chaîne | | alarmedObject.href | Référence URL pour obtenir les détails de l'objet d'alarme. Type de données : chaîne | | alarmdObjectType | Type ou classe d'objet associé à l'événement. Type de données : chaîne | | alarmRaisedTime | Date et heure auxquelles l'alarme se produit à sa source. Type de données : chaîne | | alarmReportingTime | Date et heure auxquelles l'OSS signale son alarme. Cette valeur peut différer de la alarmRaisedTime valeur. Par exemple, si un système de gestion des éléments (EMS) tient à jour la liste d'alarmes : * Il alarmRaisedTime s'agit de l'heure de détection de l'alarme par l'élément de réseau (NE). * Il alarmReportingTime s'agit de la durée de stockage du rapport d'alarme dans la liste d'alarmes EMS. {#alarm-GET-alarm__ul_mbt_1rf_ynb} Type de données : chaîne | | Type d'alarme | Catégorie d'alarme. Type de données : chaîne | | informationsSeuils croisés | Détails sur le seuil franchi. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Type de données : objet | | informationssSeuils croisés.direction | Direction du franchissement du seuil. Valeurs possibles : * En haut * En bas {#alarm-GET-alarm__ul_fsb_jlg_ynb} Type de données : chaîne | | informationThresholdInformation.granularité croisée | Granularité à laquelle l'indicateur est évalué pour le franchissement de seuil. Par exemple, `5MINUTES.` Type de données : chaîne | | crossedThresholdInformation.indicatorName | Nom de l'indicateur qui franchit le seuil d'alarme. Type de données : chaîne | | CrossedThresholdInformation.indicatorUnit | Unité de mesure de l'indicateur correspondant au seuil franchi. Type de données : chaîne | | informationThresholdInformation.observedValue | Numéro identifiant l'indicateur dépassant le seuil. Type de données : chaîne | | informationThresholdInformation.thresholdCrossingDescription | Plus de détails sur le seuil de l'alarme de franchissement de seuil. Type de données : chaîne | | CrossedThresholdInformation.thresholdId | Identificateur unique du seuil qui a provoqué l'alarme. Type de données : chaîne | | informationThresholdInformation.thresholdRef croisée | URL de l'objet de seuil. Type de données : chaîne | | ID d'alarme externe | Identificateur unique de l'alarme provenant du système source qui publie l'alarme. Type de données : chaîne | | href | URL de la ressource. Type de données : chaîne | | id | Identificateur unique permettant au système d'identifier et de traiter la charge utile de l'alarme en tant qu'événement. Type de données : chaîne | | perceivedSeverity | Gravité de l'alarme. Valeurs possibles : * CLAIR * CRITIQUE * MAJEUR * MINEUR * AVERTISSEMENT {#alarm-GET-alarm__ul_vcp_c4f_ynb} Type de données : chaîne | | plannedOutageIndication | Indique que l'objet géré pour cette alarme est dans un état de panne planifiée. Par exemple, maintenance planifiée ou hors service. Type de données : chaîne | | Cause probable | Situation la plus probable pour déclencher l'alarme. Utilisez avec pour alarmType qualifier l'alarme. Type de données : chaîne | | Actions de réparation proposées | Si disponible, fournit une action de réparation pour résoudre le problème qui déclenche l'alarme. Type de données : chaîne | | serviceAffectant | Marqueur indiquant si l'alarme affecte le service. Valeurs valides : * true : l'alarme affecte la performance ou la disponibilité du service. * faux : l'alarme n'affecte pas le service. {#alarm-GET-alarm__ul_omz_dnf_ynb} Valeur par défaut : false Type de données : booléennes | | sourceSystemId (en anglais seulement) | ID d'instance de la source d'alarme. Type de données : chaîne | | Problème spécifique | Problème spécifique qui déclenche l'alarme. Utilisez avec pour probableCause qualifier l'alarme. Type de données : chaîne | | État | État de l'alarme. Valeurs valides : * Prêt * Traité * Ignoré * \<\< Erreur \>\> {#alarm-GET-alarm__ul_ilh_3jt_xnb}Si une valeur non valide est fournie, l'état est défini sur `Prêt`. Si l'état est `Prêt`, une alerte est créée dans la table Alerte \[em_alert\] et l'état devient alors `Traité`. Si l'état est `Traité`, `Ignoré` ou `Erreur` , aucune alerte n'est créée. Valeur par défaut : prêt Type de données : chaîne | [ ] {#alarm-GET-alarm__table_zjc_fbg_qtb} ### Demande cURL Cet exemple récupère toutes les alarmes. curl "https://instance.servicenow.com/api/sn_ind_tmf642/alarm_mgmt/alarm" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' Corps de réponse. [ { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "sdfgds", "indicatorUnit": "asdfdsaf", "observedValue": "adsfds", "thresholdId": "12fasdfasdfasd", "thresholdCrossingDescription": "S23rtring", "thresholdRef": "asdfasf" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331", "id": "001a0ca629078d10f87759e2f69e4c64_2212331" }, { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "sdfgds", "indicatorUnit": "asdfdsaf", "observedValue": "adsfds", "thresholdId": "12fasdfasdfasd", "thresholdCrossingDescription": "S23rtring", "thresholdRef": "asdfasf" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001c84aa29078d10f87759e2f69e4cfa_2212331", "id": "001c84aa29078d10f87759e2f69e4cfa_2212331" } ] ## Gestion des alarmes API ouverte -- GET /sn_ind_tmf642/alarm_mgmt/alarm/{id} {#ariaid-title3} Récupère un enregistrement d'alarme spécifié à partir de la table Événements \[em_event\] ou Alerte \[em_alert\]. ### Format d'URL URL par défaut : /api/sn_ind_tmf642/alarm_mgmt/alarm/{id} ### Paramètres de demande pris en charge {#alarm-GET-alarm-id__entry__2} | Nom | Description | |-|-| | id | Identificateur unique de l'enregistrement à récupérer. Situé dans le champ Clé du message de la table Événements \[em_event\]. Type de données : chaîne | [Tableau 7. Paramètres de chemin d'accès] {#alarm-GET-alarm-id__entry__6} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Champs valides : * alarmedObject * alarmRaisedTime * Type d'alarme * informationsSeuils croisés * ID d'alarme externe * id * perceivedSeverity * Cause probable * source * sourceSystemId (en anglais seulement) * État * type {#alarm-GET-alarm-id__ul_n1h_htz_54b} Valeur par défaut : Tous les champs Type de données : chaîne | [Tableau 8. Paramètres de requête] {#alarm-GET-alarm-id__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 9. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-GET-alarm-id__entry__14}{#alarm-GET-alarm-id__accept-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | [Tableau 10. En-têtes de demandes] {#alarm-GET-alarm-id__entry__18} | En-tête | Description | |-|-| | Aucun | | [Tableau 11. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-GET-alarm-id__entry__22}{#alarm-GET-alarm-id__entry-200-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Paramètre de chemin d'accès non valide. * URI non valide. {#alarm-GET-alarm-id__ul_rjf_fqw_rpb} | | 404 | Enregistrement introuvable. Un enregistrement associé à l'ID spécifié n'a pas été trouvé dans la table Événement \[em_event\] ou Alerte \[em_alert\]. | [Tableau 12. Codes d'état] ### Paramètres de corps de réponse (JSON) {#alarm-GET-alarm-id__table_gtd_dbg_qtb__entry__2}{#alarm-GET-alarm-id__alm-mgmt-affectedService-entry}{#alarm-GET-alarm-id__alm-mgmt-affectedServiceHREF-entry}{#alarm-GET-alarm-id__alm-mgmt-create-alarmobj-href-entry}{#alarm-GET-alarm-id__alm-mgmt-specificProb-ph} | Nom | Description | |-|-| | service affecté | Liste des objets identifiant un ou plusieurs services affectés par l'alarme. Type de données : tableau "affectedService":[ { "href": "String", "id": "String" }, ] | | serviceaffecté.href | Référence d'URL fournissant des détails sur le service affecté. Type de données : chaîne | | affectedService.id | Identificateur du service affecté par l'alarme. Cette valeur est mappée à l'élément de configuration (CI) affecté sur l'alerte. Type de données : chaîne | | alarmDetails (en anglais seulement) | Détails supplémentaires sur l'alarme. Type de données : chaîne | | alarmedObject | Détails de l'objet d'alarme. Type de données : objet "alarmedObject": { "href": "String", "id": "String" } | | alarmedObject.id | Identificateur unique de l'objet d'alarme. Cette valeur est mappée à un CI dans le système. Type de données : chaîne | | alarmedObject.href | Référence URL pour obtenir les détails de l'objet d'alarme. Type de données : chaîne | | alarmdObjectType | Type ou classe d'objet associé à l'événement. Type de données : chaîne | | alarmRaisedTime | Date et heure auxquelles l'alarme se produit à sa source. Type de données : chaîne | | alarmReportingTime | Date et heure auxquelles l'OSS signale son alarme. Cette valeur peut différer de la alarmRaisedTime valeur. Par exemple, si un système de gestion des éléments (EMS) tient à jour la liste d'alarmes : * Il alarmRaisedTime s'agit de l'heure de détection de l'alarme par l'élément de réseau (NE). * Il alarmReportingTime s'agit de la durée de stockage du rapport d'alarme dans la liste d'alarmes EMS. {#alarm-GET-alarm-id__ul_mbt_1rf_ynb} Type de données : chaîne | | Type d'alarme | Catégorie d'alarme. Type de données : chaîne | | informationsSeuils croisés | Détails sur le seuil franchi. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Type de données : objet | | informationssSeuils croisés.direction | Direction du franchissement du seuil. Valeurs possibles : * En haut * En bas {#alarm-GET-alarm-id__ul_fsb_jlg_ynb} Type de données : chaîne | | informationThresholdInformation.granularité croisée | Granularité à laquelle l'indicateur est évalué pour le franchissement de seuil. Par exemple, `5MINUTES.` Type de données : chaîne | | crossedThresholdInformation.indicatorName | Nom de l'indicateur qui franchit le seuil d'alarme. Type de données : chaîne | | CrossedThresholdInformation.indicatorUnit | Unité de mesure de l'indicateur correspondant au seuil franchi. Type de données : chaîne | | informationThresholdInformation.observedValue | Numéro identifiant l'indicateur dépassant le seuil. Type de données : chaîne | | informationThresholdInformation.thresholdCrossingDescription | Plus de détails sur le seuil de l'alarme de franchissement de seuil. Type de données : chaîne | | CrossedThresholdInformation.thresholdId | Identificateur unique du seuil qui a provoqué l'alarme. Type de données : chaîne | | informationThresholdInformation.thresholdRef croisée | URL de l'objet de seuil. Type de données : chaîne | | ID d'alarme externe | Identificateur unique de l'alarme provenant du système source qui publie l'alarme. Type de données : chaîne | | href | URL de la ressource. Type de données : chaîne | | id | Identificateur unique permettant au système d'identifier et de traiter la charge utile de l'alarme en tant qu'événement. Type de données : chaîne | | perceivedSeverity | Gravité de l'alarme. Valeurs possibles : * CLAIR * CRITIQUE * MAJEUR * MINEUR * AVERTISSEMENT {#alarm-GET-alarm-id__ul_vcp_c4f_ynb} Type de données : chaîne | | plannedOutageIndication | Indique que l'objet géré pour cette alarme est dans un état de panne planifiée. Par exemple, maintenance planifiée ou hors service. Type de données : chaîne | | Cause probable | Situation la plus probable pour déclencher l'alarme. Utilisez avec pour alarmType qualifier l'alarme. Type de données : chaîne | | Actions de réparation proposées | Si disponible, fournit une action de réparation pour résoudre le problème qui déclenche l'alarme. Type de données : chaîne | | serviceAffectant | Marqueur indiquant si l'alarme affecte le service. Valeurs valides : * true : l'alarme affecte la performance ou la disponibilité du service. * faux : l'alarme n'affecte pas le service. {#alarm-GET-alarm-id__ul_omz_dnf_ynb} Valeur par défaut : false Type de données : booléennes | | sourceSystemId (en anglais seulement) | ID d'instance de la source d'alarme. Type de données : chaîne | | Problème spécifique | Problème spécifique qui déclenche l'alarme. Utilisez avec pour probableCause qualifier l'alarme. Type de données : chaîne | | État | État de l'alarme. Valeurs valides : * Prêt * Traité * Ignoré * \<\< Erreur \>\> {#alarm-GET-alarm-id__ul_ilh_3jt_xnb}Si une valeur non valide est fournie, l'état est défini sur `Prêt`. Si l'état est `Prêt`, une alerte est créée dans la table Alerte \[em_alert\] et l'état devient alors `Traité`. Si l'état est `Traité`, `Ignoré` ou `Erreur` , aucune alerte n'est créée. Valeur par défaut : prêt Type de données : chaîne | [ ] {#alarm-GET-alarm-id__table_gtd_dbg_qtb} ### Demande cURL Cet exemple récupère une alarme. curl "https://instance.servicenow.com/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' Corps de réponse. { "externalAlarmId": "2212331", "alarmType": "QualityOfServiceAlarm23", "perceivedSeverity": "MAJOR", "probableCause": "ProbB", "sourceSystemId": "checkSB", "alarmedObject": { "id": "vManage_000000", "href": " http://api/alarmedobject/000000" }, "crossedThresholdInformation": { "direction": "111", "granularity": "1234", "indicatorName": "ind_name", "indicatorUnit": "ind_unit", "observedValue": "232", "thresholdId": "200", "thresholdCrossingDescription": "sample_description", "thresholdRef": "sample_ref" }, "type": "QualityOfServiceAlarm", "ackState": "acknowledged", "specificProblem": "Inbound Traffic threshold crossed", "alarmedObjectType": "ROUTER", "alarmDetails": "Software Failure on SD-WAN Controller vManage_000000", "state": "processed", "alarmChangedTime": "2017-08-15T07:04:15.666Z", "proposedRepairActions": "Switch in standby equipment", "alarmReportingTime": "2017-06-15T07:04:15.666Z", "alarmRaisedTime": "2020-09-15T14:04:15.000Z", "plannedOutageIndication": "IN_SERVICE", "serviceAffecting": true, "affectedService": [ { "id": "SD WAN Enterprise Solutions", "href": "http://api/service/vlan_dot0_dot0" }, { "id": "Santa Clara SD WAN Application Service", "href": "http://api/service/vlan_dot0_dot0" } ], "source": "Alarm Management Open API", "href": "/api/sn_ind_tmf642/alarm_mgmt/alarm/001a0ca629078d10f87759e2f69e4c64_2212331", "id": "001a0ca629078d10f87759e2f69e4c64_2212331" } ## API ouverte de gestion des alarmes -- PATCH /sn_ind_tmf642/alarm_mgmt/alarm/{id} {#ariaid-title4} Met à jour une alarme spécifiée et toute alerte associée. Ce point de terminaison écrit le corps de la réponse dans le champ Informations supplémentaires de l'enregistrement d'événement dans la table Événements \[em_event\]. ### Format d'URL URL par défaut : /api/sn_ind_tmf642/alarm_mgmt/alarm/{id} ### Paramètres de demande pris en charge {#alarm-PATCH__entry__2} | Nom | Description | |-|-| | id | Identificateur unique de l'enregistrement à mettre à jour. Situé dans le champ Clé du message de la table Événements \[em_event\]. Type de données : chaîne | [Tableau 13. Paramètres de chemin d'accès] {#alarm-PATCH__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 14. Paramètres de requête] {#alarm-PATCH__table_kmr_mjs_xnb__entry__2}{#alarm-PATCH__alm-mgmt-affectedService-entry}{#alarm-PATCH__alm-mgmt-affectedServiceHREF-entry}{#alarm-PATCH__alm-mgmt-perceivedSeverity-desc}{#alarm-PATCH__alm-mgmt-specificProb-ph} | Nom | Description | |-|-| | service affecté | Liste des objets identifiant un ou plusieurs services affectés par l'alarme. Type de données : tableau "affectedService":[ { "href": "String", "id": "String" }, ] | | serviceaffecté.href | Référence d'URL fournissant des détails sur le service affecté. Type de données : chaîne | | affectedService.id | Requis. Identificateur du service affecté par l'alarme. Cette valeur est mappée à l'élément de configuration (CI) affecté sur l'alerte. Type de données : chaîne | | alarmChangedTime | Indique la date et l'heure du dernier changement de l'alarme sur le système propriétaire de l'alarme. Toute modification de l'alarme met à jour cette valeur, qu'elle provienne de la ressource alarmée ou qu'elle soit déclenchée par un changement du client. Type de données : chaîne | | alarmDetails (en anglais seulement) | Détails supplémentaires sur l'alarme. Type de données : chaîne | | alarmEscalation | Marqueur indiquant une escalade de la gravité de l'alarme. Valeurs valides : * true : il y a une escalade de la gravité de l'alarme. * faux : la gravité de l'alarme est identique ou inférieure. {#alarm-PATCH__ul_kkj_4jh_ynb} Valeur par défaut : false Type de données : booléennes | | informationsSeuils croisés | Détails sur le seuil franchi. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Type de données : objet | | informationssSeuils croisés.direction | Direction du franchissement du seuil. Valeurs possibles : * En haut * En bas {#alarm-PATCH__ul_fsb_jlg_ynb} Type de données : chaîne | | informationThresholdInformation.granularité croisée | Granularité à laquelle l'indicateur est évalué pour le franchissement de seuil. Par exemple, `5MINUTES.` Type de données : chaîne | | crossedThresholdInformation.indicatorName | Nom de l'indicateur qui franchit le seuil d'alarme. Type de données : chaîne | | CrossedThresholdInformation.indicatorUnit | Unité de mesure de l'indicateur correspondant au seuil franchi. Type de données : chaîne | | informationThresholdInformation.observedValue | Numéro identifiant l'indicateur dépassant le seuil. Type de données : chaîne | | informationThresholdInformation.thresholdCrossingDescription | Plus de détails sur le seuil de l'alarme de franchissement de seuil. Type de données : chaîne | | CrossedThresholdInformation.thresholdId | Requis. Identificateur unique du seuil qui a provoqué l'alarme. Type de données : chaîne | | informationThresholdInformation.thresholdRef croisée | URL de l'objet de seuil. Type de données : chaîne | | href | Référence de l'URL à l'alarme. Type de données : chaîne | | perceivedSeverity | Requis. Gravité de l'alarme. Valeurs possibles : * CLAIR * CRITIQUE * MAJEUR * MINEUR * AVERTISSEMENT {#alarm-PATCH__ul_vcp_c4f_ynb} Type de données : chaîne | | plannedOutageIndication | Indique que l'objet géré pour cette alarme est dans un état de panne planifiée. Par exemple, maintenance planifiée ou hors service. Type de données : chaîne | | Cause probable | Requis. Situation la plus probable pour déclencher l'alarme. Utilisez avec pour alarmType qualifier l'alarme. Type de données : chaîne | | Actions de réparation proposées | Si disponible, fournit une action de réparation pour résoudre le problème qui déclenche l'alarme. Type de données : chaîne | | serviceAffectant | Marqueur indiquant si l'alarme affecte le service. Valeurs valides : * true : l'alarme affecte la performance ou la disponibilité du service. * faux : l'alarme n'affecte pas le service. {#alarm-PATCH__ul_omz_dnf_ynb} Valeur par défaut : false Type de données : booléennes | | Problème spécifique | Problème spécifique qui déclenche l'alarme. Utilisez avec pour probableCause qualifier l'alarme. Type de données : chaîne | [Tableau 15. Paramètres du corps de la demande (JSON)] {#alarm-PATCH__table_kmr_mjs_xnb} ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-PATCH__entry__56}{#alarm-PATCH__accept-JSON-only-entry-RESTAPI}{#alarm-PATCH__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 16. En-têtes de demandes] {#alarm-PATCH__table_jwc_bxs_xnb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 17. En-têtes de réponses] {#alarm-PATCH__table_jwc_bxs_xnb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-PATCH__table_ifj_lyb_ynb__entry__2} | Code d'état | Description | |-|-| | 201 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Raisons possibles : * Charge utile non valide. ID d'alarme requis manquant. * Charge utile non valide. Champ obligatoire manquant :\. * Charge utile non valide. Objet requis manquant. * Événement non créé, échec. * Impossible d'effacer l'événement. * Impossible de mettre à jour l'événement. * L'événement n'existe pas. {#alarm-PATCH__ul_f4x_sdb_ynb} | [Tableau 18. Codes d'état] {#alarm-PATCH__table_ifj_lyb_ynb} ### Paramètres de corps de réponse (JSON) {#alarm-PATCH__entry__72} | Nom | Description | |-|-| | alarmChangedTime | Date et heure auxquelles l'alarme a changé en GMT sur le système propriétaire de l'alarme. Cette valeur est au format GlideDateTime et se trouve dans le Time of event champ d'un enregistrement dans la table Événements \[em_events\]. Cette valeur est mise à jour lorsque des changements apportés à l'alarme à partir de la ressource alarmée se produisent ou qu'un changement à partir d'une mise à jour du client déclenche l'alarme. Cette valeur est requise dans la réponse. Type de données : chaîne | | href | Référence de l'URL à l'alarme. Type de données : chaîne | | id | Identificateur unique de l'alarme. Valeur déterminée par le système propriétaire de l'alarme. Type de données : chaîne | [ ] ### Demande cURL Dans cet exemple, la sévérité est réduite à MINEURE. curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm/6e116bb8db09201087b9a8394b961950_" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"href\":\"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00\", \"externalAlarmId\":\"\", \"alarmType\":\"QualityOfServiceAlarm\", \"type\":\"QualityOfServiceAlarm\", \"ackState\":\"acknowledged\", \"perceivedSeverity\":\"MINOR\", \"probableCause\":\"Threshold crossed\", \"specificProblem\":\"Inbound Traffic threshold crossed\", \"alarmedObjectType\":\"ROUTER\", \"alarmedObject\":{ \"id\":\"vManage_000000\", \"href\":\" http://api/alarmedobject/000000\" }, \"sourceSystemId\":\"SOURCE_SYSTEM_vManage_00000_000_00\", \"alarmDetails\":\"Software Failure on SD-WAN Controller vManage_000000\", \"alarmEscalation\": false, \"state\":\"RAISED\", \"alarmChangedTime\":\"2017-08-15T07:04:15.666Z\", \"proposedRepairActions\":\"Switch in standby equipment\", \"alarmReportingTime\":\"2017-06-15T07:04:15.666Z\", \"alarmRaisedTime\":\"2020-09-15T07:04:15.666Z\", \"plannedOutageIndication\":\"IN_SERVICE\", \"serviceAffecting\":true, \"affectedService\":[ { \"id\":\"SD WAN Enterprise Solutions\", \"href\":\"http://api/service/vlan_dot0_dot0\" }, { \"id\":\"Santa Clara SD WAN Application Service\", \"href\":\"http://api/service/vlan_dot0_dot0\" } ] }" \ --user 'user:'password' Corps de réponse. { "result": { "alarmChangedTime": "2017-08-15T07:04:15.666Z", "id": "6e116bb8db09201087b9a8394b961950_" } } ## Gestion des alarmes API ouverte -- POST /sn_ind_tmf642/alarm_mgmt/alarm {#ariaid-title5} Crée un enregistrement d'alarme dans la table Événements \[em_event\]. Lorsque l'enregistrement d'alarme est créé, un ID pour l'alarme est ajouté dans le Message key champ. Un enregistrement d'alerte peut également être créé en fonction [des règles de gestion des alertes](https://www.servicenow.com/docs/access?context=alert-management-rule&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US). Ce point de terminaison écrit le corps de la réponse dans le champ Informations supplémentaires de l'enregistrement d'événement dans la table Événements \[em_event\]. ### Format d'URL URL par défaut : /api/sn_ind_tmf642/alarm_mgmt/alarm ### Paramètres de demande pris en charge {#alarm-POST-create__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 19. Paramètres de chemin d'accès] {#alarm-POST-create__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 20. Paramètres de requête] {#alarm-POST-create__entry__10}{#alarm-POST-create__alm-mgmt-affectedService-entry}{#alarm-POST-create__alm-mgmt-affectedServiceHREF-entry}{#alarm-POST-create__alm-mgmt-create-alarmobj-href-entry}{#alarm-POST-create__alm-mgmt-create-alarmtype}{#alarm-POST-create__alm-mgmt-perceivedSeverity-desc}{#alarm-POST-create__alm-mgmt-specificProb-ph} | Nom | Description | |-|-| | service affecté | Liste des objets identifiant un ou plusieurs services affectés par l'alarme. Type de données : tableau "affectedService":[ { "href": "String", "id": "String" }, ] | | serviceaffecté.href | Référence d'URL fournissant des détails sur le service affecté. Type de données : chaîne | | affectedService.id | Requis. Identificateur du service affecté par l'alarme. Cette valeur est mappée à l'élément de configuration (CI) affecté sur l'alerte. Type de données : chaîne | | alarmDetails (en anglais seulement) | Détails supplémentaires sur l'alarme. Type de données : chaîne | | alarmedObject | Requis. Détails de l'objet d'alarme. "alarmedObject": { "href": "String", "id": "String" } Type de données : objet | | alarmedObject.id | Requis. Identificateur unique de l'objet d'alarme. Cette valeur est mappée à un CI dans le système. Type de données : chaîne | | alarmedObject.href | Référence URL pour obtenir les détails de l'objet d'alarme. Type de données : chaîne | | alarmdObjectType | Type ou classe d'objet associé à l'événement. Type de données : chaîne | | alarmRaisedTime | Date et heure auxquelles l'alarme se produit à sa source. Type de données : chaîne | | alarmReportingTime | Date et heure auxquelles l'OSS signale son alarme. Cette valeur peut différer de la alarmRaisedTime valeur. Par exemple, si un système de gestion des éléments (EMS) tient à jour la liste d'alarmes : * Il alarmRaisedTime s'agit de l'heure de détection de l'alarme par l'élément de réseau (NE). * Il alarmReportingTime s'agit de la durée de stockage du rapport d'alarme dans la liste d'alarmes EMS. {#alarm-POST-create__ul_mbt_1rf_ynb} Type de données : chaîne | | Type d'alarme | Requis. Catégorie d'alarme. Type de données : chaîne | | informationsSeuils croisés | Détails sur le seuil franchi. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Type de données : objet | | informationssSeuils croisés.direction | Direction du franchissement du seuil. Valeurs possibles : * En haut * En bas {#alarm-POST-create__ul_fsb_jlg_ynb} Type de données : chaîne | | informationThresholdInformation.granularité croisée | Granularité à laquelle l'indicateur est évalué pour le franchissement de seuil. Par exemple, `5MINUTES.` Type de données : chaîne | | crossedThresholdInformation.indicatorName | Nom de l'indicateur qui franchit le seuil d'alarme. Type de données : chaîne | | CrossedThresholdInformation.indicatorUnit | Unité de mesure de l'indicateur correspondant au seuil franchi. Type de données : chaîne | | informationThresholdInformation.observedValue | Numéro identifiant l'indicateur dépassant le seuil. Type de données : chaîne | | informationThresholdInformation.thresholdCrossingDescription | Plus de détails sur le seuil de l'alarme de franchissement de seuil. Type de données : chaîne | | CrossedThresholdInformation.thresholdId | Requis. Identificateur unique du seuil qui a provoqué l'alarme. Type de données : chaîne | | informationThresholdInformation.thresholdRef croisée | URL de l'objet de seuil. Type de données : chaîne | | ID d'alarme externe | Requis. Identificateur unique de l'alarme provenant du système source qui publie l'alarme. Type de données : chaîne | | id | Identificateur unique permettant au système d'identifier et de traiter la charge utile de l'alarme en tant qu'événement. Cette valeur doit être vide si elle est utilisée dans la charge utile. Le système génère cet ID unique pour l'événement et l'envoie dans le cadre de la charge utile de réponse. Type de données : chaîne | | perceivedSeverity | Requis. Gravité de l'alarme. Valeurs possibles : * CLAIR * CRITIQUE * MAJEUR * MINEUR * AVERTISSEMENT {#alarm-POST-create__ul_vcp_c4f_ynb} Type de données : chaîne | | plannedOutageIndication | Indique que l'objet géré pour cette alarme est dans un état de panne planifiée. Par exemple, maintenance planifiée ou hors service. Type de données : chaîne | | Cause probable | Requis. Situation la plus probable pour déclencher l'alarme. Utilisez avec pour alarmType qualifier l'alarme. Type de données : chaîne | | Actions de réparation proposées | Si disponible, fournit une action de réparation pour résoudre le problème qui déclenche l'alarme. Type de données : chaîne | | serviceAffectant | Marqueur indiquant si l'alarme affecte le service. Valeurs valides : * true : l'alarme affecte la performance ou la disponibilité du service. * faux : l'alarme n'affecte pas le service. {#alarm-POST-create__ul_omz_dnf_ynb} Valeur par défaut : false Type de données : booléennes | | sourceSystemId (en anglais seulement) | Requis. ID d'instance de la source d'alarme. Type de données : chaîne | | Problème spécifique | Problème spécifique qui déclenche l'alarme. Utilisez avec pour probableCause qualifier l'alarme. Type de données : chaîne | | État | État de l'alarme. Valeurs valides : * Prêt * Traité * Ignoré * \<\< Erreur \>\> {#alarm-POST-create__ul_ilh_3jt_xnb}Si une valeur non valide est fournie, l'état est défini sur `Prêt`. Si l'état est `Prêt`, une alerte est créée dans la table Alerte \[em_alert\] et l'état devient alors `Traité`. Si l'état est `Traité`, `Ignoré` ou `Erreur` , aucune alerte n'est créée. Valeur par défaut : prêt Type de données : chaîne | [Tableau 21. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-POST-create__entry__72}{#alarm-POST-create__accept-JSON-only-entry-RESTAPI}{#alarm-POST-create__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 22. En-têtes de demandes] {#alarm-POST-create__table_vrm_1xs_xnb__entry__2} | En-tête | Description | |-|-| | Aucun | | [Tableau 23. En-têtes de réponses] {#alarm-POST-create__table_vrm_1xs_xnb} ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-POST-create__table_bly_lyb_ynb__entry__2} | Code d'état | Description | |-|-| | 201 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Raisons possibles : * Charge utile non valide. ID d'alarme requis manquant. * Charge utile non valide. Champ obligatoire manquant :\. * Charge utile non valide. Objet requis manquant. * Événement non créé, échec. * Impossible d'effacer l'événement. * Impossible de mettre à jour l'événement. * L'événement n'existe pas. {#alarm-POST-create__ul_f4x_sdb_ynb} | [Tableau 24. Codes d'état] {#alarm-POST-create__table_bly_lyb_ynb} ### Paramètres de corps de réponse (JSON) {#alarm-POST-create__entry__88}{#alarm-POST-create__d3018e79}{#alarm-POST-create__d3018e92}{#alarm-POST-create__d3018e410}{#alarm-POST-create__d3018e349} | Nom | Description | |-|-| | service affecté | Liste des objets identifiant un ou plusieurs services affectés par l'alarme. Type de données : tableau "affectedService":[ { "href": "String", "id": "String" }, ] | | serviceaffecté.href | Référence d'URL fournissant des détails sur le service affecté. Type de données : chaîne | | affectedService.id | Identificateur du service affecté par l'alarme. Cette valeur est mappée à l'élément de configuration (CI) affecté sur l'alerte. Type de données : chaîne | | alarmDetails (en anglais seulement) | Détails supplémentaires sur l'alarme. Type de données : chaîne | | alarmedObject | Détails de l'objet d'alarme. "alarmedObject": { "href": "String", "id": "String" } Type de données : objet | | alarmedObject.id | Identificateur unique de l'objet d'alarme. Cette valeur est mappée à un CI dans le système. Type de données : chaîne | | alarmedObject.href | Référence URL pour obtenir les détails de l'objet d'alarme. Type de données : chaîne | | alarmdObjectType | Type ou classe d'objet associé à l'événement. Type de données : chaîne | | alarmRaisedTime | Date et heure auxquelles l'alarme se produit à sa source. Type de données : chaîne | | alarmReportingTime | Date et heure auxquelles l'OSS signale son alarme. Cette valeur peut différer de la alarmRaisedTime valeur. Par exemple, si un système de gestion des éléments (EMS) tient à jour la liste d'alarmes : * Il alarmRaisedTime s'agit de l'heure de détection de l'alarme par l'élément de réseau (NE). * Il alarmReportingTime s'agit de la durée de stockage du rapport d'alarme dans la liste d'alarmes EMS. {#alarm-POST-create__d3018e466} Type de données : chaîne | | Type d'alarme | Catégorie d'alarme. Type de données : chaîne | | informationsSeuils croisés | Détails sur le seuil franchi. "crossedThresholdInformation": { "direction": "String", "granularity": "String", "indicatorName": "String", "indicatorUnit": "String", "observedValue": "String", "thresholdCrossingDescription": "String", "thresholdId": "String", "thresholdRef": "String" } Type de données : objet | | informationssSeuils croisés.direction | Direction du franchissement du seuil. Valeurs possibles : * En haut * En bas {#alarm-POST-create__d3018e147} Type de données : chaîne | | informationThresholdInformation.granularité croisée | Granularité à laquelle l'indicateur est évalué pour le franchissement de seuil. Par exemple, `5MINUTES.` Type de données : chaîne | | crossedThresholdInformation.indicatorName | Nom de l'indicateur qui franchit le seuil d'alarme. Type de données : chaîne | | CrossedThresholdInformation.indicatorUnit | Unité de mesure de l'indicateur correspondant au seuil franchi. Type de données : chaîne | | informationThresholdInformation.observedValue | Numéro identifiant l'indicateur dépassant le seuil. Type de données : chaîne | | informationThresholdInformation.thresholdCrossingDescription | Plus de détails sur le seuil de l'alarme de franchissement de seuil. Type de données : chaîne | | CrossedThresholdInformation.thresholdId | Identificateur unique du seuil qui a provoqué l'alarme. Type de données : chaîne | | informationThresholdInformation.thresholdRef croisée | URL de l'objet de seuil. Type de données : chaîne | | ID d'alarme externe | Identificateur unique de l'alarme provenant du système source qui publie l'alarme. Type de données : chaîne | | href | URL de la ressource. Type de données : chaîne | | id | Identificateur unique permettant au système d'identifier et de traiter la charge utile de l'alarme en tant qu'événement. Type de données : chaîne | | perceivedSeverity | Gravité de l'alarme. Valeurs possibles : * CLAIR * CRITIQUE * MAJEUR * MINEUR * AVERTISSEMENT {#alarm-POST-create__d3018e255} Type de données : chaîne | | plannedOutageIndication | Indique que l'objet géré pour cette alarme est dans un état de panne planifiée. Par exemple, maintenance planifiée ou hors service. Type de données : chaîne | | Cause probable | Situation la plus probable pour déclencher l'alarme. Utilisez avec pour alarmType qualifier l'alarme. Type de données : chaîne | | Actions de réparation proposées | Si disponible, fournit une action de réparation pour résoudre le problème qui déclenche l'alarme. Type de données : chaîne | | serviceAffectant | Marqueur indiquant si l'alarme affecte le service. Valeurs valides : * true : l'alarme affecte la performance ou la disponibilité du service. * faux : l'alarme n'affecte pas le service. {#alarm-POST-create__d3018e329} Valeur par défaut : false Type de données : booléennes | | sourceSystemId (en anglais seulement) | ID d'instance de la source d'alarme. Type de données : chaîne | | Problème spécifique | Problème spécifique qui déclenche l'alarme. Utilisez avec pour probableCause qualifier l'alarme. Type de données : chaîne | | État | État de l'alarme. Valeurs valides : * Prêt * Traité * Ignoré * \<\< Erreur \>\> {#alarm-POST-create__d3018e557}Si une valeur non valide est fournie, l'état est défini sur `Prêt`. Si l'état est `Prêt`, une alerte est créée dans la table Alerte \[em_alert\] et l'état devient alors `Traité`. Si l'état est `Traité`, `Ignoré` ou `Erreur` , aucune alerte n'est créée. Valeur par défaut : prêt Type de données : chaîne | [ ] ### Demande cURL Cet exemple crée une alarme. curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "href":"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00", "externalAlarmId":"", "alarmType":"QualityOfServiceAlarm", "type":"QualityOfServiceAlarm", "ackState":"acknowledged", "perceivedSeverity":"CRITICAL", "probableCause":"Threshold crossed", "specificProblem":"Inbound Traffic threshold crossed", "alarmedObjectType":"ROUTER", "alarmedObject":{ "id":"vManage_000000", "href":" http://api/alarmedobject/000000" }, "sourceSystemId":"SOURCE_SYSTEM_vManage_00000_000_00", "alarmDetails":"Software Failure on SD-WAN Controller vManage_000000", "state":"RAISED", "alarmChangedTime":"2017-08-15T07:04:15.666Z", "proposedRepairActions":"Switch in standby equipment", "alarmReportingTime":"2017-06-15T07:04:15.666Z", "alarmRaisedTime":"2020-09-15T07:04:15.666Z", "plannedOutageIndication":"IN_SERVICE", "serviceAffecting":true, "affectedService":[ { "id":"SD WAN Enterprise Solutions", "href":"http://api/service/vlan_dot0_dot0" }, { "id":"Santa Clara SD WAN Application Service", "href":"http://api/service/vlan_dot0_dot0" } ] }" \ --user 'user':'password' Corps de réponse. { "href":"http://api/alarm/ROUTER_IF@Cisco-0000-0-0-0-0-00-00-0-- Xz0/00@00", "externalAlarmId":"", "alarmType":"QualityOfServiceAlarm", "type":"QualityOfServiceAlarm", "ackState":"acknowledged", "perceivedSeverity":"CRITICAL", "probableCause":"Threshold crossed", "specificProblem":"Inbound Traffic threshold crossed", "alarmedObjectType":"ROUTER", "alarmedObject":{ "id":"vManage_000000", "href":" http://api/alarmedobject/000000" }, "sourceSystemId":"SOURCE_SYSTEM_vManage_00000_000_00", "alarmDetails":"Software Failure on SD-WAN Controller vManage_000000", "state":"RAISED", "alarmChangedTime":"2017-08-15T07:04:15.666Z", "proposedRepairActions":"Switch in standby equipment", "alarmReportingTime":"2017-06-15T07:04:15.666Z", "alarmRaisedTime":"2020-09-15T07:04:15.666Z", "plannedOutageIndication":"IN_SERVICE", "serviceAffecting":true, "affectedService":[ { "id":"SD WAN Enterprise Solutions", "href":"http://api/service/vlan_dot0_dot0" }, { "id":"Santa Clara SD WAN Application Service", "href":"http://api/service/vlan_dot0_dot0" } ] } ## API ouverte de gestion des alarmes : POST /sn_ind_tmf642/alarm_mgmt/alarm/{id}/clear {#ariaid-title6} Efface une alarme spécifiée et ferme toute alerte associée. ### Format d'URL URL par défaut : /api/sn_ind_tmf642/alarm_mgmt/alarm/{id}/clear ### Paramètres de demande pris en charge {#alarm-POST-clear__entry__2} | Nom | Description | |-|-| | id | Identificateur unique de l'alarme à effacer. Situé dans le champ Clé du message de la table Événements \[em_events\]. Type de données : chaîne | [Tableau 25. Paramètres de chemin d'accès] {#alarm-POST-clear__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 26. Paramètres de requête] {#alarm-POST-clear__entry__10} | Nom | Description | |-|-| | alarmClearedTime | Date et heure auxquelles l'alarme s'efface à la source. Cette valeur se trouve dans le champ de l'enregistrement Time of event dans la table Événements \[em_events\]. Type de données : chaîne | | clearSystemId (en anglais seulement) | Requis. Nom de l'instance à partir de laquelle l'opération alarmCleared a été invoquée. Type de données : chaîne | | clearUserId (en anglais seulement) | Requis. ID unique de l'utilisateur qui a invoqué l'opération alarmCleared . Cette valeur se trouve dans le champ de l'enregistrement Source dans la table Événements \[em_events\]. Type de données : chaîne | [Tableau 27. Paramètres du corps de la demande (JSON)] ### En-têtes Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l'API REST, consultez [En-têtes d'API REST pris en charge](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-POST-clear__entry__18}{#alarm-POST-clear__accept-JSON-only-entry-RESTAPI}{#alarm-POST-clear__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 28. En-têtes de demandes] {#alarm-POST-clear__entry__24} | Nom | Description | |-|-| | Aucun | | [Tableau 29. En-têtes de réponses] ### Codes d'état Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d'état possibles utilisés dans l'API REST, consultez [Codes de réponse HTTP de l'API REST](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#alarm-POST-clear__entry__28} | Code d'état | Description | |-|-| | 201 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Raisons possibles : * Charge utile non valide. ID d'alarme requis manquant. * Charge utile non valide. Champ obligatoire manquant :\. * Charge utile non valide. Objet requis manquant. * Événement non créé, échec. * Impossible d'effacer l'événement. * Impossible de mettre à jour l'événement. * L'événement n'existe pas. {#alarm-POST-clear__ul_f4x_sdb_ynb} | [Tableau 30. Codes d'état] ### Paramètres de corps de réponse (JSON) {#alarm-POST-clear__entry__34} | Nom | Description | |-|-| | alarmClearedTime | Date et heure auxquelles l'alarme s'efface à la source. Cette valeur se trouve dans le champ de l'enregistrement Time of event dans la table Événements \[em_events\]. Type de données : chaîne | | clearSystemId (en anglais seulement) | Nom de l'instance à partir de laquelle l'opération alarmCleared a été invoquée. Type de données : chaîne | | clearUserId (en anglais seulement) | ID unique de l'utilisateur qui a invoqué l'opération alarmCleared . Cette valeur se trouve dans le champ de l'enregistrement Source dans la table Événements \[em_events\]. Type de données : chaîne | | href | URL de l'alarme. Type de données : chaîne | | id | ID unique dans le Message key champ d'un enregistrement dans la table Événements \[em_events\]. Type de données : chaîne | [ ] ### Demande cURL Cet exemple efface une alarme. curl "https://.service-now.com/api/sn_ind_tmf642/alarm_mgmt/alarm/6e116bb8db09201087b9a8394b961950_/clear" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"alarmClearedTime\": \"2017-08-15 06:04:15\", \"clearSystemId\": \"\", \"clearUserId\": \"SOURCE_SYSTEM_vManage_00000_000_00\" }" \ --user 'user':'password' Corps de réponse. { "result": { "alarmClearedTime": "2017-08-15 06:04:15", "clearSystemId": "", "clearUserId": "SOURCE_SYSTEM_vManage_00000_000_00", "id": "6e116bb8db09201087b9a8394b961950_" } }