API ouverte de Gestion des tests de service

Rversion finale: Yokohama

Mis à jour 30 janv. 2025

96 minutes de lecture

L’API ouverte Gestion des tests de service fournit des points de terminaison pour créer et récupérer des définitions de test de service et des tests de service.

Utilisez cette API pour gérer les informations de gestion des problèmes de service entre les systèmes externes et le Now Platform. L’API ouverte Gestion des tests de service est une ServiceNow implémentation de la spécification REST de l’API Gestion des problèmes de service de TM Forum. Cette implémentation est basée sur https://www.tmforum.org/resources/specification/tmf653-service-test-management-api-user-guide-v4-1-0/.

Cette API REST est conçue pour gérer et exécuter des tests de service dans un environnement de télécommunications. Elle permet aux utilisateurs de définir, de déclencher et de surveiller les tests de service, en veillant à ce que les services répondent aux normes de qualité et de performance. L’API fournit des options pour la gestion des tests, notamment la création et la mise à jour des définitions de test, l’exécution de tests, la récupération des résultats des tests et la gestion des calendriers de test.

L’API ouverte Gestion des tests de service nécessite le module d’extension Gestion des problèmes du service clientèle (com.sn_sprb_mgmt) et le rôle sn_sprb_mgmt.test_integrator. Cette API appartient à l’espace de noms sn_sprb_mgmt. Pour plus d’informations sur la Gestion des problèmes de service. Consultez la rubrique Customer Service Problem Management pour plus d’informations sur cette application.

L’API ouverte Gestion des tests de service crée ou met à jour des données dans les tables suivantes :

Exécution du test [sn_st_mgmt_test]
Définition de test de service [sn_st_mgmt_test_definition]
Caractéristique de la définition de test [sn_st_mgmt_test_definition_characteristic]
Caractéristique du test [sn_st_mgmt_test_characteristic]
Relation de spécification à définition de test [sn_st_mgmt_test_definition_m2m]
Relation de définition de test [sn_st_mgmt_test_definition_rel]
Mesure de test [sn_st_mgmt_test_measure]
Mesurer la conséquence [sn_st_mgmt_measure_consequence]
Définition de la mesure de test [sn_st_mgmt_test_measure_definition]
Conséquence appliquée [sn_st_mgmt_applied_consequence]
Règle de seuil [sn_st_mgmt_threshold_rule]
Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]

API ouverte de Gestion des tests de service : GET /sn_sprb_mgmt/servicetestmanagement/serviceTest

Récupère une liste de tous les tests de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest

Paramètres de demande pris en charge

Tableau 1. Paramètres de chemin d'accès
Nom	Description
Aucun

Tableau 2. Paramètres de requête
Nom	Description
champs	Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n’est pas utilisé, tous les champs sont renvoyés. Situé dans la table Test de service [sn_st_mgmt_test]. Champs valides : characteristic description endDateTime id Mode relatedService (en anglais) startDateTime État testMeasure testSpecification valide pour 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 offset récupération de l’enregistrement. Type de données : nombre Valeur maximale : 100 Par défaut : 20
décalage	Index de début auquel commencer à récupérer les enregistrements. Utilisez ce paramètre pour paginer les résultats en petits blocs gérables. Le premier enregistrement est indexé à 0. Type de données : nombre Par défaut : 0
État	Filtrez les définitions de test par l’état actuel du test. Seules les définitions de test dans l’état spécifié sont renvoyées dans la réponse. Valeurs valides : confirmé annulé terminé échoué inProgress En attente rejeté Type de données : chaîne

Tableau 3. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Néant

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.

Tableau 4. En-têtes de demandes
En-tête	Description
Néant

Tableau 5. En-têtes de réponses
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. Prend uniquement en charge application/json.
un lien	Contient les liens suivants pour parcourir les résultats de la requête. premier dernier suivant previous
X-Total-Count	Pour les requêtes paginées, cet en-tête spécifie le nombre total d’enregistrements disponibles sur le serveur.

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.

Tableau 6. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
206	Ressource partielle retournée en réponse (avec pagination).
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
404	Introuvable. L’élément demandé est introuvable.

Tableau 7. Paramètres du corps de réponse (XML ou JSON)
Nom	Description
characteristic	Liste décrivant les caractéristiques du test de service associé. Pour plus d’informations sur les caractéristiques des définitions de test, voir Type de données : tableau d’objets `"characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ]`
characteristic.id	Sys_id ou external_id de caractéristiques. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne Tableau : Caractéristiques [sn_prd_pm_characteristic]
characteristic.name	Nom de la caractéristique. Type de données : chaîne
caractéristique.valeur	Options de caractéristiques associées au test de service. Les caractéristiques varient en fonction de l’instance client. Type de données : chaîne
characteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
description	Description du test de service. Type de données : chaîne
endDateTime	Date et heure de fin du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
href	Référence de lien hypertexte vers le test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
Mode	Mode dans lequel le test de service s’exécute. Valeurs valides : ONDEMAND : déclenche manuellement le test de service. PROACTIF : déclenche automatiquement le test de service. Type de données : chaîne Valeur par défaut : ONDEMAND
nom	Requis. Nom du test de service. Type de données : chaîne
relatedService (en anglais)	Requis. Définition de test associée au test de service. Type de données : objet `"relatedService": { "href": "String", "id": "String", "name": "String" }`
relatedService.id	Sys_id ou external_id de l’inventaire des produits. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Inventaire des produits [sn_prd_invt_product_inventory].
relatedService.name	Nom de l’inventaire de produits. Type de données : chaîne
startDateTime	Date et heure de début du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
État	État dans lequel se trouve le test de service. Valeurs valides : confirmé annulé terminé échoué inProgress En attente rejeté Type de données : chaîne
testMeasure	Mesure d’un aspect spécifique d’un test de produit, de service ou de ressource, tel que la perte de paquets ou l’état de connectivité. Type de données : tableau d’objets `"testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ]`
testMeasure.accuracy	Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40
testMeasure.captureDateTime	Date et heure auxquelles la mesure a été capturée. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasure.id	Sys_id ou external_id des mesures de test. Type de données : chaîne Table : dans les champs sys_id ou external_id de la table des mesures de test [sn_st_mgmt_test_measure].
testMesure.Mesure.Méthode de capture	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasure.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasure.metricName	Nom de la mesure de test. Type de données : chaîne
testMeasure.ruleViolation	Objet permettant de définir une règle dans la définition de règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d’objets `"ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ]`
testMeasure.ruleViolation.tolerancePeriod.amount	Nombre de périodes avant l’application de la conséquence. Type de données : nombre
testMeasure.ruleViolation.appliedConsequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Type de données : tableau d’objets `"appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ]`
testMeasure.ruleViolation.appliedConsequence.appliedAction	Action à entreprendre lorsqu’une règle de seuil n’est pas respectée. Par exemple, l’envoi d’un avertissement ou la génération d’un rapport. Les actions appliquées peuvent varier d’une instance à l’autre. Type de données : chaîne
testMesure.RègleViolation.appliquéeConconséquence.description	Description de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.id	Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.name	Nom de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence lorsqu’une deuxième violation se produit. Valeurs valides : vrai : répétez l’action. faux : ne répétez pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComporatorExact	Marqueur indiquant si une valeur est identique. Valeurs valides : true : la valeur est identique. false : la valeur n’est pas identique. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComporatorLower	Opérateur permettant de vérifier si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasure.ruleViolation.conformanceComporatorUpper	Opérateur pour vérifier si une valeur est au-dessus du seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasure.ruleViolation.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.description	Description de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.id	Sys_id ou external_id de la violation de la règle de seuil. Type de données : chaîne Table : Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]
testMeasure.ruleViolation.name	Nom de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasure.ruleViolation.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasure.ruleViolation.tolerancePeriod	Intervalle de temps spécifié pendant lequel les occurrences de croisement sont activées sans déclencher de conséquences ou d’actions immédiates. Type de date : objet `"tolerancePeriod": { "amount": Number, "units": "String" }`
testMeasure.ruleViolation.tolerancePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMesure.unitéDeMesure	Unité de mesure des valeurs cibles de conformité de la mesure d’essai. Type de données : chaîne
testMesure.valeur	Valeur de la mesure de test. Type de données : objet `"value": { "id": "String", "name": "String", "valueType": "String", "value": "String }`
testMeasure.value.id	ID de la valeur de la mesure de test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de la mesure de test. Type de données : chaîne
testMesure.valeur.valeur	Valeur de la mesure de test. Type de données : chaîne
testMesure.valeur.valeurType	Type de valeur de mesure de test, par exemple numérique, texte, etc. Type de données : chaîne
testSpecification	Requis. Définition de test associée à ce test. Type de données : objet `"testSpecification": { "href": "String", "id": "String" }`
testSpecification.href	Référence de lien hypertexte vers la définition du test de service. Type de données : chaîne
testSpecification.id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Définition du test de service [sn_st_mgmt_test_definition].
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime ": "String", "startDateTime": "String" }`
validFor.endDateTime	Date de fin de validité du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date de début de validité du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

L’exemple suivant récupère des informations sur les deux tests de service dans l’instance.

curl --location --request GET “https://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest” \
--user 'username’: ‘password'

Corps de la réponse.

[
  {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/09d1f42e3be28210d140068aa4e45ae2",
    "id": "09d1f42e3be28210d140068aa4e45ae2",
    "description": "Service test",
    "endDateTime": "2025-01-31 15:05:43",
    "mode": "proactive",
    "name": "Speed Test TR0001002",
    "startDateTime": "2024-06-05 09:07:10",
    "validFor": {
      "startDateTime": "",
      "endDateTime": ""
    },
    "relatedService": {
      "id": "fa6d13f45b5620102dff5e92dc81c77f",
      "name": "Internet_VPLS_PI0000011"
    },
    "testSpecification": {
      "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8",
      "id": "7d3854864316c6500e51203d5fb8f2d8"
    },
    "characteristic": [],
    "testMeasure": [
      {
        "id": "61d1382e3be28210d140068aa4e45a2e",
        "accuracy": "0.0001",
        "captureDateTime": "",
        "captureMethod": "automatic",
        "metricDescription": "",
        "metricName": "Flow speed",
        "unitOfMeasure": "A second",
        "value": "3000",
        "ruleViolation": [
          {
            "id": "61d1382e3be28210d140068aa4e45a2f",
            "description": "This speed is greater than the target",
            "name": "tooMuchTraffic",
            "numberOfAllowedCrossing": "0",
            "thresholdRuleSeverity": "high",
            "tolerancePeriod": "",
            "conformanceTargetLower": "2500",
            "conformanceComparatorLower": "greater than",
            "appliedConsequence": [
              {
                "id": "65d1382e3be28210d140068aa4e45a31",
                "appliedAction": "sendWarning",
                "description": "send a warning to the system",
                "name": "sendWarning",
                "repeatAction": "0"
              }
            ]
          }
        ]
      }
    ]
  },
  {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/18682a2a3b2682107222bf9985e45a55",
    "id": "18682a2a3b2682107222bf9985e45a55",
    "description": "Service test",
    "endDateTime": "2025-01-31 15:05:43",
    "mode": "proactive",
    "name": "Speed Test TR0001012",
    "startDateTime": "2024-06-05 17:45:07",
    "validFor": {
      "startDateTime": "",
      "endDateTime": ""
    },
    "relatedService": {
      "id": "fa6d13f45b5620102dff5e92dc81c77f",
      "name": "Internet_VPLS_PI0000011"
    },
    "testSpecification": {
      "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8",
      "id": "7d3854864316c6500e51203d5fb8f2d8"
    },
    "characteristic": [
      {
        "id": "5c682a2a3b2682107222bf9985e45a5a",
        "name": "url",
        "valueType": "single_line_text",
        "value": "http://abc.com"
      }
    ],
    "testMeasure": [
      {
        "id": "7c686a2a3b2682107222bf9985e45a4d",
        "accuracy": "0.0001",
        "captureDateTime": "",
        "captureMethod": "automatic",
        "metricDescription": "",
        "metricName": "Flow speed",
        "unitOfMeasure": "A second",
        "value": "3000",
        "ruleViolation": [
          {
            "id": "38686a2a3b2682107222bf9985e45a4e",
            "description": "This speed is greater than the target",
            "name": "tooMuchTraffic",
            "numberOfAllowedCrossing": "0",
            "thresholdRuleSeverity": "high",
            "tolerancePeriod": "",
            "conformanceTargetLower": "2500",
            "conformanceComparatorLower": "greater than",
            "appliedConsequence": [
              {
                "id": "34686a2a3b2682107222bf9985e45a50",
                "appliedAction": "sendWarning",
                "description": "send a warning to the system",
                "name": "sendWarning",
                "repeatAction": "0"
              }
            ]
          }
        ]
      }
    ]
  }
]

API ouverte de Gestion des tests de service – GET /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id}

Récupère une entité de test de service en fonction de l’ID donné d’un test de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{id}

Paramètres de demande pris en charge

Tableau 8. Paramètres de chemin d'accès
Nom	Description
id	Sys_id ou external_id du test de service à récupérer. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]

Tableau 9. Paramètres de requête
Nom	Description
champs	Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n’est pas utilisé, tous les champs sont renvoyés. Situé dans la table Test de service [sn_st_mgmt_test]. Champs valides : characteristic description endDateTime id Mode relatedService (en anglais) startDateTime État testMeasure testSpecification valide pour Type de données : chaîne

Tableau 10. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Néant

En-têtes

Tableau 11. En-têtes de demandes
En-tête	Description
Néant

Tableau 12. En-têtes de réponses
En-tête	Description
Type de contenu	Format de données du corps de la réponse. Prend uniquement en charge application/json.

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.

Tableau 13. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
404	Introuvable. L’élément demandé est introuvable.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
characteristic	Liste décrivant les caractéristiques du test de service associé. Type de données : tableau d’objets `"characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ]`
characteristic.id	Sys_id ou external_id de caractéristiques. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne Tableau : Caractéristiques [sn_prd_pm_characteristic]
characteristic.name	Nom de la caractéristique. Type de données : chaîne
caractéristique.valeur	Options de caractéristiques associées au test de service. Les caractéristiques varient en fonction de l’instance client. Type de données : chaîne
characteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
description	Description du test de service. Type de données : chaîne
endDateTime	Date et heure de fin du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
href	Référence de lien hypertexte vers le test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
Mode	Mode dans lequel le test de service s’exécute. Valeurs valides : ONDEMAND : déclenche manuellement le test de service. PROACTIF : déclenche automatiquement le test de service. Type de données : chaîne Valeur par défaut : ONDEMAND
nom	Nom du test de service. Type de données : chaîne
relatedService (en anglais)	Définition de test associée à ce test. Type de données : objet `"relatedService": { "href": "String", "id": "String", "name": "String" }`
relatedService.id	Sys_id ou external_id de l’inventaire des produits. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Inventaire des produits [sn_prd_invt_product_inventory].
relatedService.name	Nom de l’élément d’inventaire des produits. Type de données : chaîne
startDateTime	Date et heure de début du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
État	État du test de service. Valeurs valides : confirmé annulé terminé échoué inProgress En attente rejeté Type de données : chaîne
testMeasure	Mesure d’un aspect spécifique d’un test de produit, de service ou de ressource, tel que la perte de paquets ou l’état de connectivité. Type de données : tableau d’objets `"testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ]`
testMeasure.accuracy	Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40
testMeasure.captureDateTime	Date et heure auxquelles la mesure a été capturée. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasure.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasure.id	Sys_id ou external_id de la mesure de test. Type de données : chaîne Tableau : Mesures d’essai [sn_st_mgmt_test_measure]
testMeasure.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasure.metricName	Nom d’une mesure dans la mesure de test. Type de données : chaîne
testMeasure.ruleViolation	Objet pour définir une règle dans la définition de règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d’objets `"RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ]`
testMeasure.ruleViolation.appliedConsequence	Action (action prescrite ou notification) à entreprendre lorsqu’une règle de seuil n’est pas respectée. Type de données : tableau d’objets `"appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ]`
testMeasure.ruleViolation.appliedConsequence.appliedAction	Action à entreprendre lorsqu’une règle de seuil n’est pas respectée. Par exemple, l’envoi d’un avertissement ou la génération d’un rapport. Les actions appliquées peuvent varier d’une instance à l’autre. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction	Marqueur indiquant s’il faut répéter ou non l’action appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMesure.RègleViolation.appliquéeConconséquence.description	Description de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.id	Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.name	Nom de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : true : la valeur est identique. false : la valeur n’est pas identique. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à est Type de données : chaîne
testMeasure.ruleViolation.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : est inférieur à Type de données : chaîne
testMeasure.ruleViolation.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.description	Description de la violation de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.id	Sys_id ou external_id de la violation de la règle de seuil. Type de données : chaîne Table : Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]
testMeasure.ruleViolation.name	Nom de la violation de la règle de seuil. Type de date : chaîne
testMeasure.ruleViolation.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Maximum : 40
testMeasure.ruleViolation.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé faible moyen Type de données : chaîne
testMeasure.ruleViolation.tolerancePeriod	Durée ou intervalle de temps pendant lequel les croisements autorisés peuvent se produire avant le déclenchement d’une conséquence. Type de date : objet `"tolerancePeriod": { "amount": Number, "units": "String" }`
testMeasure.ruleViolation.tolerancePeriod.amount	Montant de la période, en nombre. Type de données : nombre
testMeasure.ruleViolation.tolerancePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMesure.unitéDeMesure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMesure.valeur	Valeur de la mesure dans le test. Type de données : objet `"value": { "id": "String", "name": "String", "valueType": "String", "value": "String" }`
testMeasure.value.id	ID de la valeur de mesure dans le test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de mesure dans le test. Type de données : chaîne
testMesure.valeur.valeur	Valeur de la mesure dans le test. Type de données : chaîne
testMesure.valeur.valeurType	Type de valeur de mesure de test, par exemple numérique, texte, etc. Type de données : chaîne
testSpecification	Définition de test associée pour ce test. Type de données : objet `"testSpecification": { "href": "String", "id": "String" }`
testSpecification.href	Référence de lien hypertexte vers la définition du test de service. Type de données : chaîne
testSpecification.id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
validFor.endDateTime	Date de fin et horodatage du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date de début et horodatage du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

L’exemple suivant récupère les détails sur l’entité de test de service associée à l’ID donné, 44b7a8ea3b6a42107222bf9985e45a45.

curl --location --request GET “https://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/44b7a8ea3b6a42107222bf9985e45a45 \
--user 'username’: ‘password'

Corps de la réponse.

{
  "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/44b7a8ea3b6a42107222bf9985e45a45",
  "id": "44b7a8ea3b6a42107222bf9985e45a45",
  "description": "Service test",
  "endDateTime": "2025-01-31 15:05:43",
  "mode": "proactive",
  "name": "Speed Test TR0001001",
  "startDateTime": "2024-06-05 08:22:52",
  "validFor": {
    "startDateTime": "",
    "endDateTime": ""
  },
  "relatedService": {
    "id": "fa6d13f45b5620102dff5e92dc81c77f",
    "name": "Internet_VPLS_PI0000011"
  },
  "testSpecification": {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8",
    "id": "7d3854864316c6500e51203d5fb8f2d8"
  },
  "characteristic": [
        { 
        "id": "5c682a2a3b2682107222bf9985e45a5a", 
        "name": "url", 
        "valueType": "single_line_text", 
        "value": "test" 
         }
],
  "testMeasure": [
    {
      "id": "62ade42a3ba28210d140068aa4e45a71",
      "accuracy": "0.0001",
      "captureDateTime": "",
      "captureMethod": "automatic",
      "metricDescription": "",
      "metricName": "Downstream Speed",
      "unitOfMeasure": "",
      "value": "16",
      "ruleViolation": [
        {
          "id": "b9bee4ae3ba28210d140068aa4e45a3a",
          "description": "This speed is less than the target upper",
          "name": "tooMuchTraffic",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "",
          "conformanceTargetUpper": "75",
          "conformanceComparatorUpper": "less than",
          "appliedConsequence": [
            {
              "id": "489074aa3be28210d140068aa4e45a42",
              "appliedAction": "generateReport",
              "description": "",
              "name": "generateReport",
              "repeatAction": "0"
            },
            {
              "id": "785f2ce23be28210d140068aa4e45a75",
              "appliedAction": "sendWarning",
              "description": "",
              "name": "sendWarning",
              "repeatAction": "0"
            }
          ]
        }
      ]
    }
  ]
}

Gestion des tests de service API ouverte : GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification

Récupère une liste de toutes les définitions de test de service.

Format d'URL

URL par défaut : GET /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification

Paramètres de demande pris en charge

Tableau 14. Paramètres de chemin d'accès
Nom	Description
Aucun

Tableau 15. Paramètres de requête
Nom	Description
champs	Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n’est pas utilisé, tous les champs sont renvoyés. Situé dans la table Définition du test de service [sn_st_mgmt_test_definition]. Valeurs valides : description id nom relatedServiceSpecification serviceTestSpecRelationship specCaractéristique testMeasureDefinition valide pour 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 offset récupération de l’enregistrement. Type de données : nombre Valeur maximale : 100 Par défaut : 20
décalage	Index de début auquel commencer à récupérer les enregistrements. Utilisez ce paramètre pour paginer les résultats en petits blocs gérables. Le premier enregistrement est indexé à 0. Type de données : nombre Par défaut : 0
État	Filtrez les définitions de test par l’état actuel du test. Seules les définitions de test dans l’état spécifié sont renvoyées dans la réponse. Valeurs valides : archivé brouillon publié retraité Type de données : chaîne

Tableau 16. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Néant

En-têtes

Tableau 17. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json

Tableau 18. En-têtes de réponses
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. Prend uniquement en charge application/json.
un lien	Contient les liens suivants pour parcourir les résultats de la requête : premier dernier suivant previous
X-Total-Count	Pour les requêtes paginées, cet en-tête spécifie le nombre total d’enregistrements disponibles sur le serveur.

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.

Tableau 19. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
206	Ressource partielle retournée en réponse (avec pagination).
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
404	Introuvable. L’élément demandé est introuvable.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
description	Description de la définition du test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]
nom	Requis. Nom de la définition de test de service. Type de données : chaîne
relatedServiceSpecification	Requis. Spécifications de service de la définition de test. Type de données : tableau d’objets `"relatedServiceSpecification": [ { "id": "String", "name": "String" } ]`
relatedServiceSpecification.id	Sys_id ou external_id de la spécification de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Spécification [sn_prd_pm_specification].
relatedServiceSpecification.name	Nom de la spécification de service. Type de données : chaîne
serviceTestSpecRelationship	Définition de test de service connexe. Type de données : tableau d’objets `"serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ]`
serviceTestSpecRelationship.id	Sys_id ou external_id de la définition de test de service connexe. Type de données : chaîne Table : Définition de test [sn_st_mgmt_test_definition]
serviceTestSpecRelationship.name	Nom de la définition de test connexe. Type de données : chaîne
serviceTestSpecRelationship.relationshipType	Type de relation. Valeurs acceptées : dépendance exclusivité substitution Type de données : chaîne
specCaractéristique	Caractéristiques de la définition de test. Type de données : tableau d’objets `"specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ]`
specCharacteristic.characteristicValueSpecification	Valeurs possibles de la caractéristique. Type de données : tableau d’objets `"characteristicValueSpecification": [ { "value": "String" } ]`
specCharacteristic.characteristicValueSpecification.value	Valeur de la caractéristique. Type de données : chaîne
specCharacteristic.description	Description de la caractéristique. Type de données : chaîne
specCharacteristic.name	Nom de la caractéristique. Type de données : chaîne
specCharacteristic.validFor	Plage de dates pour laquelle la caractéristique est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
specCharacteristic.validFor.endDateTime	Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.validFor.startDateTime	Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
testMeasureDefinition	Définitions de mesure de test de test pour cette définition de test de service. Pour plus d'informations, consultez Define test measure definitions for a service test. Type de données : tableau d’objets `"testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ]`
testMeasureDefinition.captureFrequency	Fréquence à laquelle capturer la mesure. Valeurs valides : quotidien mensuel Aucun une fois hebdomadaire Type de données : chaîne
testMeasureDefinition.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasureDefinition.capturePeriod	Période ou durée de la capture des mesures. Type de données : objet `"capturePeriod": { "amount": Number, "units": "String" }`
testMeasureDefinition.capturePeriod.amount	Nombre de périodes de capture. Type de données : nombre
testMeasureDefinition.capturePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMeasureDefinition.id	Sys_id ou external_id des définitions des mesures de test. Type de données : chaîne Table : Table de définition de la mesure de test [sn_st_mgmt_test_measure_definition]
testMeasureDefinition.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasureDefinition.metricName	Nom défini par l’utilisateur d’une mesure dans la mesure de test. Type de données : chaîne
testMeasureDefinition.name	Nom de la définition de la mesure de test. Type de données : chaîne
testMeasureDefinition.thresholdRule	Règle qui définit les conditions à atteindre avant d’appliquer des conséquences lorsqu’un seuil est franchi (ou non franchi) dans la définition de la mesure de test. Pour plus d'informations, consultez Define threshold rules for a test measure definition. Type de données : tableau d’objets `{ "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } }`
testMeasureDefinition.thresholdRule.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : true : la valeur est identique à la valeur de conformanceTargetExact. false : la valeur n’est pas identique conformanceTargetExact. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Type de données : nombre
testMeasureDefinition.thresholdRule.consequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Pour plus d'informations, consultez Define measure consequences for the threshold rules. Type de données : tableau d’objets `"consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ]`
testMeasureDefinition.thresholdRule.consequence.description	Description de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.id	Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.name	Nom de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.prescribeAction	Action définie par l’utilisateur à prendre en cas de dépassement de seuil. Les actions varient d’une instance à l’autre. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.consequence.validFor	Plage de dates pour laquelle la conséquence est valide. Type de données : objet `"validFor": { "startDateTime": "String", "endDateTime ": "String" }`
testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime	Date de fin de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime	Date de début de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.description	Description de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.id	Sys_id ou external_id des règles de seuil. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Règles de seuil [sn_st_mgmt_threshold_rule].
testMeasureDefinition.thresholdRule.name	Nom de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasureDefinition.thresholdRule.thresholdRuleSeverity	Niveau de gravité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasureDefinition.unitOfMeasure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMeasureDefinition.validFor	Plage de dates à laquelle la définition de la mesure de test est valide. Type de données : chaîne `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
testMeasureDefinition.validFor.endDateTime	Date de fin de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.validFor.startDateTime	Date de début de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
valide pour	Plage de dates pour laquelle la définition de test est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
validFor.endDateTime	Date et heure de la définition de test auxquelles son état est mis hors service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date et heure de publication de la définition de test sur laquelle son état est défini. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

Cet exemple récupère les détails de toutes les définitions de test de service de test dans l’instance. Dans ce cas, deux définitions sont renvoyées.

curl --location --request GET 
“https://instance.servicenow.com//api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification” \
--user 'username’: ‘password'

Corps de la réponse.

[
  {
    "description": "Operation, Administration and Maintenance",
    "id": "76a3b160432a02104fefe4511fb8f2ad",
    "name": "OAM Test",
    "validFor": {
      "startDateTime": "",
      "endDateTime": ""
    },
    "testMeasureDefinition": [
      {
        "id": "77b9b964432a02104fefe4511fb8f26e",
        "captureFrequency": "once",
        "captureMethod": "automatic",
        "metricDescription": "This is the Rx signal level",
        "metricName": "Rx Optical Signal Level",
        "name": "Rx Optical Signal Level",
        "unitOfMeasure": "a minute",
        "valueType": "",
        "capturePeriod": "",
        "validFor": {
          "startDateTime": "",
          "endDateTime": ""
        },
        "thresholdRule": [
          {
            "id": "d3e97d64432a02104fefe4511fb8f281",
            "description": "",
            "name": "gponOntAniOpInfoRxOpticalSignalLevel",
            "numberOfAllowedCrossing": "",
            "thresholdRuleSeverity": "",
            "tolerancePeriod": "",
            "conformanceTargetUpper": "0",
            "conformanceComparatorUpper": "less than",
            "conformanceTargetLower": "-50",
            "conformanceComparatorLower": "greater than",
            "consequence": []
          }
        ]
      },
      {
        "id": "878afd64432a02104fefe4511fb8f28d",
        "captureFrequency": "once",
        "captureMethod": "automatic",
        "metricDescription": "This is the Tx signal level",
        "metricName": "TX Optical Signal Level",
        "name": "TX Optical Signal Level",
        "unitOfMeasure": "a minute",
        "valueType": "",
        "capturePeriod": "",
        "validFor": {
          "startDateTime": "",
          "endDateTime": ""
        },
        "thresholdRule": [
          {
            "id": "b3dab5a4432a02104fefe4511fb8f2d3",
            "description": "",
            "name": "gponOntAniOpInfoTxOpticalSignalLevel",
            "numberOfAllowedCrossing": "",
            "thresholdRuleSeverity": "",
            "tolerancePeriod": "",
            "conformanceTargetUpper": "65",
            "conformanceComparatorUpper": "less than",
            "conformanceTargetLower": "-65",
            "conformanceComparatorLower": "greater than",
            "consequence": []
          }
        ]
      }
    ],
    "specCharacteristic": [
      {
        "name": "AccessRequired",
        "description": "AccessRequired",
        "valueType": "yes_no",
        "validFor": {
          "startDatetime": "2024-05-30 09:09:57"
        },
        "characteristicValueSpecification": [
          {
            "value": "Yes",
            "validFor": {
              "startDateTime": "",
              "endDateTime": ""
            }
          },
          {
            "value": "No",
            "validFor": {
              "startDateTime": "",
              "endDateTime": ""
            }
          }
        ]
      }
    ],
    "serviceTestSpecRelationship": [],
    "relatedServiceSpecification": [
      {
        "id": "f559b564432a02104fefe4511fb8f2e0",
        "name": "OAM"
      }
    ]
  },
  {
    "description": "Upstream and Downstream speed ",
    "id": "89d2b920432a02104fefe4511fb8f22e",
    "name": "Speed Test",
    "validFor": {
      "startDateTime": "2024-05-31",
      "endDateTime": "2024-06-27"
    },
    "testMeasureDefinition": [
      {
        "id": "1a04f560432a02104fefe4511fb8f2ad",
        "captureFrequency": "once",
        "captureMethod": "automatic",
        "metricDescription": "This is the downstream speed in a service",
        "metricName": "Downstream Speed",
        "name": "Downstream Speed",
        "unitOfMeasure": "a second",
        "valueType": "",
        "capturePeriod": "30 Minutes",
        "validFor": {
          "startDateTime": "2024-05-30 08:49:26",
          "endDateTime": "2024-05-31 08:49:29"
        },
        "thresholdRule": [
          {
            "id": "a754f960432a02104fefe4511fb8f2d0",
            "description": "This speed is greater than the target upper",
            "name": "InternetSpeedValue",
            "numberOfAllowedCrossing": "0",
            "thresholdRuleSeverity": "high",
            "tolerancePeriod": "15 Minutes",
            "conformanceTargetLower": "75",
            "conformanceComparatorLower": "greater than",
            "consequence": [
              {
                "id": "15a4bd60432a02104fefe4511fb8f2b8",
                "prescribeAction": "null",
                "description": "generate a waring report",
                "name": "degradedQualityOfService",
                "repeatAction": "0",
                "validFor": {
                  "startDateTime": "2024-05-30 08:51:29",
                  "endDateTime": "2024-08-06 08:51:31"
                }
              },
              {
                "id": "e6847d60432a02104fefe4511fb8f2c3",
                "prescribeAction": "null",
                "description": "send a warning to the system",
                "name": "packetdrop",
                "repeatAction": "0",
                "validFor": {
                  "startDateTime": "2024-05-30 08:50:53",
                  "endDateTime": "2024-08-06 08:50:55"
                }
              }
            ]
          },
          {
            "id": "cb55b5a0432a02104fefe4511fb8f201",
            "description": "",
            "name": "InternetSpeedValue",
            "numberOfAllowedCrossing": "0",
            "thresholdRuleSeverity": "medium",
            "tolerancePeriod": "",
            "conformanceTargetUpper": "120",
            "conformanceComparatorUpper": "less than",
            "consequence": []
          }
        ]
      },
      {
        "id": "8f987524432a02104fefe4511fb8f2f0",
        "captureFrequency": "once",
        "captureMethod": "automatic",
        "metricDescription": "This is the upstream speed in the service",
        "metricName": "Upstream Speed",
        "name": "Upstream Speed",
        "unitOfMeasure": "a second",
        "valueType": "",
        "capturePeriod": "",
        "validFor": {
          "startDateTime": "",
          "endDateTime": ""
        },
        "thresholdRule": []
      }
    ],
    "specCharacteristic": [
      {
        "name": "restart",
        "description": "restart",
        "valueType": "yes_no",
        "validFor": {
          "startDatetime": "2024-05-30 08:45:49"
        },
        "characteristicValueSpecification": [
          {
            "value": "No",
            "validFor": {
              "startDateTime": "",
              "endDateTime": ""
            }
          },
          {
            "value": "Yes",
            "validFor": {
              "startDateTime": "",
              "endDateTime": ""
            }
          }
        ]
      }
    ],
    "serviceTestSpecRelationship": [
      {
        "id": "76a3b160432a02104fefe4511fb8f2ad",
        "name": "OAM Test",
        "relationshipType": ""
      }
    ],
    "relatedServiceSpecification": [
      {
        "id": "aeddcd1fb7d69910ff00f203ae11a990",
        "name": "Home Internet"
      }
    ]
  }
]

Gestion des tests de service API ouverte : GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id}

Récupère une entité de définition de test de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id}

Paramètres de demande pris en charge

Tableau 20. Paramètres de chemin d'accès
Nom	Description
id	Sys_id ou external_id de la définition du test de service à récupérer. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]

Tableau 21. Paramètres de requête
Nom	Description
champs	Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n’est pas utilisé, tous les champs sont renvoyés. Situé dans la table Définition du test de service [sn_st_mgmt_test_definition]. Valeurs valides : description id nom relatedServiceSpecification serviceTestSpecRelationship specCaractéristique testMeasureDefinition valide pour Type de données : chaîne
État	Filtrez les définitions de test par l’état actuel du test. Seules les définitions de test dans l’état spécifié sont renvoyées dans la réponse. Valeurs valides : archivé brouillon publié retraité Type de données : chaîne

Tableau 22. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Néant

En-têtes

Tableau 23. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json

Tableau 24. En-têtes de réponses
En-tête	Description
Content-Type	Format de données du corps de la demande. Prend uniquement en charge application/json.

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.

Tableau 25. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
404	Introuvable. L’élément demandé est introuvable.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
description	Description de la définition du test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]
nom	Requis. Nom de la définition de test de service. Type de données : chaîne
relatedServiceSpecification	Requis. Spécifications de service de la définition de test. Type de données : tableau d’objets `"relatedServiceSpecification": [ { "id": "String", "name": "String" } ]`
relatedServiceSpecification.id	Sys_id ou external_id de la spécification de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Spécification [sn_prd_pm_specification].
relatedServiceSpecification.name	Nom de la spécification de service. Type de données : chaîne
serviceTestSpecRelationship	Définition de test de service connexe. Type de données : tableau d’objets `"serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ]`
serviceTestSpecRelationship.id	Sys_id ou external_id de la définition de test de service connexe. Type de données : chaîne Table : Définition de test [sn_st_mgmt_test_definition]
serviceTestSpecRelationship.name	Nom de la définition de test connexe. Type de données : chaîne
serviceTestSpecRelationship.relationshipType	Type de relation. Valeurs acceptées : dépendance exclusivité substitution Type de données : chaîne
specCaractéristique	Caractéristiques de la définition de test. Type de données : tableau d’objets `"specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ]`
specCharacteristic.characteristicValueSpecification	Valeurs possibles de la caractéristique. Type de données : tableau d’objets `"characteristicValueSpecification": [ { "value": "String" } ]`
specCharacteristic.characteristicValueSpecification.value	Valeur de la caractéristique. Type de données : chaîne
specCharacteristic.description	Description de la caractéristique. Type de données : chaîne
specCharacteristic.name	Nom de la caractéristique. Type de données : chaîne
specCharacteristic.validFor	Plage de dates pour laquelle la caractéristique est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
specCharacteristic.validFor.endDateTime	Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.validFor.startDateTime	Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
testMeasureDefinition	Définitions de mesure de test de test pour cette définition de test de service. Pour plus d'informations, consultez Define test measure definitions for a service test. Type de données : tableau d’objets `"testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ]`
testMeasureDefinition.captureFrequency	Fréquence à laquelle capturer la mesure. Valeurs valides : quotidien mensuel Aucun une fois hebdomadaire Type de données : chaîne
testMeasureDefinition.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasureDefinition.capturePeriod	Période ou durée de la capture des mesures. Type de données : objet `"capturePeriod": { "amount": Number, "units": "String" }`
testMeasureDefinition.capturePeriod.amount	Nombre de périodes de capture. Type de données : nombre
testMeasureDefinition.capturePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMeasureDefinition.id	Sys_id ou external_id des définitions des mesures de test. Type de données : chaîne Table : Table de définition de la mesure de test [sn_st_mgmt_test_measure_definition]
testMeasureDefinition.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasureDefinition.metricName	Nom défini par l’utilisateur d’une mesure dans la mesure de test. Type de données : chaîne
testMeasureDefinition.name	Nom de la définition de la mesure de test. Type de données : chaîne
testMeasureDefinition.thresholdRule	Règle qui définit les conditions à atteindre avant d’appliquer des conséquences lorsqu’un seuil est franchi (ou non franchi) dans la définition de la mesure de test. Pour plus d'informations, consultez Define threshold rules for a test measure definition. Type de données : tableau d’objets `{ "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } }`
testMeasureDefinition.thresholdRule.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : true : la valeur est identique à la valeur de conformanceTargetExact. false : la valeur n’est pas identique conformanceTargetExact. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Type de données : nombre
testMeasureDefinition.thresholdRule.consequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Pour plus d'informations, consultez Define measure consequences for the threshold rules. Type de données : tableau d’objets `"consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ]`
testMeasureDefinition.thresholdRule.consequence.description	Description de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.id	Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.name	Nom de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.prescribeAction	Action définie par l’utilisateur à prendre en cas de dépassement de seuil. Les actions varient d’une instance à l’autre. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.consequence.validFor	Plage de dates pour laquelle la conséquence est valide. Type de données : objet `"validFor": { "startDateTime": "String", "endDateTime ": "String" }`
testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime	Date de fin de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime	Date de début de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.description	Description de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.id	Sys_id ou external_id des règles de seuil. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Règles de seuil [sn_st_mgmt_threshold_rule].
testMeasureDefinition.thresholdRule.name	Nom de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasureDefinition.thresholdRule.thresholdRuleSeverity	Niveau de gravité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasureDefinition.unitOfMeasure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMeasureDefinition.validFor	Plage de dates à laquelle la définition de la mesure de test est valide. Type de données : chaîne `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
testMeasureDefinition.validFor.endDateTime	Date de fin de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.validFor.startDateTime	Date de début de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
valide pour	Plage de dates pour laquelle la définition de test est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
validFor.endDateTime	Date et heure de la définition de test auxquelles son état est mis hors service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date et heure de publication de la définition de test sur laquelle son état est défini. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

Cet exemple récupère les détails d’une définition de test de service avec un ID donné.

curl --location --request GET "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/89d2b920432a02104fefe4511fb8f22e" \
--user 'username’: ‘password'

Corps de la réponse.

{
  "description": "Upstream and Downstream speed ",
  "id": "89d2b920432a02104fefe4511fb8f22e",
  "name": "Speed Test",
  "validFor": {
    "startDateTime": "2024-05-31",
    "endDateTime": "2024-06-27"
  },
  "testMeasureDefinition": [
    {
      "id": "1a04f560432a02104fefe4511fb8f2ad",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the downstream speed in a service",
      "metricName": "Downstream Speed",
      "name": "Downstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "30 Minutes",
      "validFor": {
        "startDateTime": "2024-05-30 08:49:26",
        "endDateTime": "2024-05-31 08:49:29"
      },
      "thresholdRule": [
        {
          "id": "a754f960432a02104fefe4511fb8f2d0",
          "description": "This speed is greater than the target upper",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "15 Minutes",
          "conformanceTargetLower": "75",
          "conformanceComparatorLower": "greater than",
          "consequence": [
            {
              "id": "15a4bd60432a02104fefe4511fb8f2b8",
              "prescribeAction": "null",
              "description": "generate a waring report",
              "name": "degradedQualityOfService",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:51:29",
                "endDateTime": "2024-08-06 08:51:31"
              }
            },
            {
              "id": "e6847d60432a02104fefe4511fb8f2c3",
              "prescribeAction": "null",
              "description": "send a warning to the system",
              "name": "packetdrop",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:50:53",
                "endDateTime": "2024-08-06 08:50:55"
              }
            }
          ]
        },
        {
          "id": "cb55b5a0432a02104fefe4511fb8f201",
          "description": "",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "medium",
          "tolerancePeriod": "",
          "conformanceTargetUpper": "120",
          "conformanceComparatorUpper": "less than",
          "consequence": []
        }
      ]
    }
  ],
  "specCharacteristic": [
    {
      "name": "restart",
      "description": "restart",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2024-05-30 08:45:49"
      },
      "characteristicValueSpecification": [
        {
          "value": "No",
          "validFor": {
            "startDateTime": "",
            "endDateTime": ""
          }
        },
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": "",
            "endDateTime": ""
          }
        }
      ]
    }
  ],
  "serviceTestSpecRelationship": [
    {
      "id": "76a3b160432a02104fefe4511fb8f2ad",
      "name": "OAM Test",
      "relationshipType": ""
    }
  ],
  "relatedServiceSpecification": [
    {
      "id": "aeddcd1fb7d69910ff00f203ae11a990",
      "name": "Home Internet"
    }
  ]
}

Gestion des tests de service API ouverte : PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id}

Met à jour une entité de test de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{id}

Paramètres de demande pris en charge

Tableau 26. Paramètres de chemin d'accès
Nom	Description
id	Sys_id ou external_id du test de service à récupérer. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]

Tableau 27. Paramètres de requête
Nom	Description
Néant

Tableau 28. Paramètres de corps de demande (XML ou JSON)
Nom	Description
characteristic	Liste décrivant les caractéristiques du test de service associé. Pour plus d’informations sur les caractéristiques des définitions de test, voir Type de données : tableau d’objets `"characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ]`
characteristic.id	Sys_id ou external_id de caractéristiques. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne Tableau : Caractéristiques [sn_prd_pm_characteristic]
characteristic.name	Nom de la caractéristique. Type de données : chaîne
caractéristique.valeur	Options de caractéristiques associées au test de service. Les caractéristiques varient en fonction de l’instance client. Type de données : chaîne
characteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
description	Description du test de service. Type de données : chaîne
endDateTime	Date et heure de fin du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
Mode	Mode dans lequel le test de service s’exécute. Valeurs valides : ONDEMAND : déclenche manuellement le test de service. PROACTIF : déclenche automatiquement le test de service. Type de données : chaîne Valeur par défaut : ONDEMAND
nom	Requis. Nom du test de service. Type de données : chaîne
relatedService (en anglais)	Requis. Définition de test associée au test de service. Type de données : objet `"relatedService": { "href": "String", "id": "String", "name": "String" }`
relatedService.href	Référence de lien hypertexte vers le service connexe. Type de données : chaîne
relatedService.id	Sys_id ou external_id de l’inventaire des produits. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Inventaire des produits [sn_prd_invt_product_inventory].
startDateTime	Date et heure de début du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
État	État dans lequel se trouve le test de service. Valeurs valides : confirmé annulé terminé échoué inProgress En attente rejeté Type de données : chaîne
testMeasure	Mesure d’un aspect spécifique d’un test de produit, de service ou de ressource, tel que la perte de paquets ou l’état de connectivité. Type de données : tableau d’objets `"testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ]`
testMeasure.accuracy	Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40
testMeasure.captureDateTime	Date et heure auxquelles la mesure a été capturée. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasure.id	Sys_id ou external_id des mesures de test. Type de données : chaîne Table : dans les champs sys_id ou external_id de la table des mesures de test [sn_st_mgmt_test_measure].
testMesure.Mesure.Méthode de capture	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasure.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasure.metricName	Nom de la mesure de test. Type de données : chaîne
testMeasure.ruleViolation	Objet permettant de définir une règle dans la définition de règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d’objets `"ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ]`
testMeasure.ruleViolation.tolerancePeriod.amount	Nombre de périodes avant l’application de la conséquence. Type de données : nombre
testMeasure.ruleViolation.appliedConsequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Type de données : tableau d’objets `"appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ]`
testMeasure.ruleViolation.appliedConsequence.appliedAction	Action à entreprendre lorsqu’une règle de seuil n’est pas respectée. Par exemple, l’envoi d’un avertissement ou la génération d’un rapport. Les actions appliquées peuvent varier d’une instance à l’autre. Type de données : chaîne
testMesure.RègleViolation.appliquéeConconséquence.description	Description de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.id	Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.name	Nom de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence lorsqu’une deuxième violation se produit. Valeurs valides : vrai : répétez l’action. faux : ne répétez pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComporatorExact	Marqueur indiquant si une valeur est identique. Valeurs valides : true : la valeur est identique. false : la valeur n’est pas identique. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComporatorLower	Opérateur permettant de vérifier si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasure.ruleViolation.conformanceComporatorUpper	Opérateur pour vérifier si une valeur est au-dessus du seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasure.ruleViolation.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.description	Description de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.id	Sys_id ou external_id de la violation de la règle de seuil. Type de données : chaîne Table : Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]
testMeasure.ruleViolation.name	Nom de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasure.ruleViolation.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasure.ruleViolation.tolerancePeriod	Intervalle de temps spécifié pendant lequel les occurrences de croisement sont activées sans déclencher de conséquences ou d’actions immédiates. Type de date : objet `"tolerancePeriod": { "amount": Number, "units": "String" }`
testMeasure.ruleViolation.tolerancePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMesure.unitéDeMesure	Unité de mesure des valeurs cibles de conformité de la mesure d’essai. Type de données : chaîne
testMesure.valeur	Valeur de la mesure de test. Type de données : objet `"value": { "id": "String", "name": "String", "valueType": "String", "value": "String }`
testMeasure.value.id	ID de la valeur de la mesure de test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de la mesure de test. Type de données : chaîne
testMesure.valeur.valeur	Valeur de la mesure de test. Type de données : chaîne
testMesure.valeur.valeurType	Type de valeur de mesure de test, par exemple numérique, texte, etc. Type de données : chaîne
testSpecification	Requis. Définition de test associée à ce test. Type de données : objet `"testSpecification": { "href": "String", "id": "String" }`
testSpecification.href	Référence de lien hypertexte vers la définition du test de service. Type de données : chaîne
testSpecification.id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Définition du test de service [sn_st_mgmt_test_definition].
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime ": "String", "startDateTime": "String" }`
validFor.endDateTime	Date de fin de validité du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date de début de validité du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

En-têtes

Tableau 29. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json

Tableau 30. En-têtes de réponses
En-tête	Description
Aucun

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.

Tableau 31. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
404	Introuvable. L’élément demandé est introuvable.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
characteristic	Liste décrivant les caractéristiques du test de service associé. Type de données : tableau d’objets `"characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ]`
characteristic.id	Sys_id ou external_id de caractéristiques. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne Tableau : Caractéristiques [sn_prd_pm_characteristic]
characteristic.name	Nom de la caractéristique. Type de données : chaîne
caractéristique.valeur	Options de caractéristiques associées au test de service. Les caractéristiques varient en fonction de l’instance client. Type de données : chaîne
characteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
description	Description du test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
nom	Nom du test de service. Type de données : chaîne
relatedService (en anglais)	Définition de test associée pour ce test. Type de données : objet `"relatedService": { "href": "string", "id": "String", "name": "String" }`
relatedService.id	Sys_id ou external_id de l’inventaire des produits. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory]
relatedService.name	Nom de l’inventaire de produits. Type de données : chaîne
testMeasure	Mesure d’un aspect spécifique d’un test de produit, de service ou de ressource, tel que la perte de paquets ou l’état de connectivité. Type de données : tableau d’objets `"testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ]`
testMeasure.accuracy	Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40
testMeasure.captureDateTime	Date et heure auxquelles la mesure a été capturée. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasure.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasure.id	Sys_id ou external_id de la mesure de test. Type de données : chaîne Tableau : Mesures d’essai [sn_st_mgmt_test_measure]
testMeasure.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasure.metricName	Nom d’une mesure dans la mesure de test. Type de données : chaîne
testMeasure.ruleViolation	Objet pour définir une règle dans la définition de règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d’objets `"RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ]`
testMeasure.ruleViolation.appliedConsequence	Action (action prescrite ou notification) à entreprendre lorsqu’une règle de seuil n’est pas respectée. Type de données : tableau d’objets `"appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ]`
testMeasure.ruleViolation.appliedConsequence.appliedAction	Action à entreprendre lorsqu’une règle de seuil n’est pas respectée. Par exemple, l’envoi d’un avertissement ou la génération d’un rapport. Les actions appliquées peuvent varier d’une instance à l’autre. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction	Marqueur indiquant s’il faut répéter ou non l’action appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMesure.RègleViolation.appliquéeConconséquence.description	Description de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.id	Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.name	Nom de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : true : la valeur est identique. false : la valeur n’est pas identique. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à est Type de données : chaîne
testMeasure.ruleViolation.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : est inférieur à Type de données : chaîne
testMeasure.ruleViolation.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.description	Description de la violation de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.id	Sys_id ou external_id de la violation de la règle de seuil. Type de données : chaîne Table : Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]
testMeasure.ruleViolation.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Maximum : 40
testMeasure.ruleViolation.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé faible moyen Type de données : chaîne
testMeasure.ruleViolation.tolerancePeriod	Durée ou intervalle de temps pendant lequel les croisements autorisés peuvent se produire avant le déclenchement d’une conséquence. Type de date : objet `"tolerancePeriod": { "amount": Number, "units": "String" }`
testMeasure.ruleViolation.tolerancePeriod.amount	Montant de la période, en nombre. Type de données : nombre
testMeasure.ruleViolation.tolerancePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMesure.unitéDeMesure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMesure.valeur	Valeur de la mesure dans le test. Type de données : objet `"value": { "id": "String", "name": "String", "valueType": "String", "value": "String" }`
testMeasure.value.id	ID de la valeur de mesure dans le test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de mesure dans le test. Type de données : chaîne
testMesure.valeur.valeur	Valeur de la mesure dans le test. Type de données : chaîne
testMesure.valeur.valeurType	Type de valeur de mesure de test, par exemple numérique, texte, etc. Type de données : chaîne
testSpecification	Définition de test associée pour ce test. Type de données : objet `"testSpecification": { "href": "String", "id": "String" }`
testSpecification.href	Référence de lien hypertexte vers la définition du test de service. Type de données : chaîne
testSpecification.id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
validFor.endDateTime	Date de fin et horodatage du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date de début et horodatage du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

L’exemple suivant met à jour l’entité de test de service donnée en fonction des détails fournis dans le corps de la demande.

curl "http://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/2b406ec043b202104fefe4511fb8f211" \ 
--request PATCH \
--header "Accept:application/json" \
--user 'username':'password'
--data {
  "description": "Service test description",
  "endDateTime": "2025-01-31 15:05:43",
  "mode": "proactive",
  "name": "Speed Test TR0001002",
  "startDateTime": "2024-06-05 09:07:10",
  "validFor": {
    "startDateTime": "",
    "endDateTime": ""
  },
  "relatedService": {
    "id": "fa6d13f45b5620102dff5e92dc81c77f",
    "name": "Internet_VPLS_PI0000011"
  },
  "testSpecification": {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad",
    "id": "76a3b160432a02104fefe4511fb8f2ad"
  },
  "characteristic": [
    {
      "id": "e7ef960443f202104fefe4511fb8f224",
      "name": "AccessRequired",
      "valueType": "yes_no",
      "value": "No"
    }
  ],
  "testMeasure": [
    {
      "id": "61d1382e3be28210d140068aa4e45a2e",
      "accuracy": "0.0001",
      "captureDateTime": "",
      "captureMethod": "automatic",
      "metricDescription": "",
      "metricName": "Flow speed",
      "unitOfMeasure": "A second",
      "value": "3000",
      "ruleViolation": [
        {
          "id": "61d1382e3be28210d140068aa4e45a2f",
          "description": "This speed is greater than the target",
          "name": "tooMuchTraffic",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "",
          "conformanceTargetLower": "2500",
          "conformanceComparatorLower": "greater than",
          "appliedConsequence": [
            {
              "id": "65d1382e3be28210d140068aa4e45a31",
              "appliedAction": "sendWarning",
              "description": "send a warning to the system",
              "name": "sendWarning",
              "repeatAction": "0"
            }
          ]
        }
      ]
    }
  ]
}

La réponse indique une mise à jour réussie en renvoyant les informations modifiées dans le service de test donné.

{
  "description": "Service test description",
  "endDateTime": "2025-01-31 15:05:43",
  "mode": "proactive",
  "name": "Speed Test TR0001002",
  "startDateTime": "2024-06-05 09:07:10",
  "validFor": {
    "startDateTime": "",
    "endDateTime": ""
  },
  "relatedService": {
    "id": "fa6d13f45b5620102dff5e92dc81c77f",
    "name": "Internet_VPLS_PI0000011"
  },
  "testSpecification": {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad",
    "id": "76a3b160432a02104fefe4511fb8f2ad"
  },
  "characteristic": [
    {
      "id": "e7ef960443f202104fefe4511fb8f224",
      "name": "AccessRequired",
      "valueType": "yes_no",
      "value": "yes"
    }
  ],
  "testMeasure": [
    {
      "id": "61d1382e3be28210d140068aa4e45a2e",
      "accuracy": "0.0001",
      "captureDateTime": "",
      "captureMethod": "automatic",
      "metricDescription": "",
      "metricName": "Flow speed",
      "unitOfMeasure": "A second",
      "value": "3000",
      "ruleViolation": [
        {
          "id": "61d1382e3be28210d140068aa4e45a2f",
          "description": "This speed is greater than the target",
          "name": "tooMuchTraffic",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "",
          "conformanceTargetLower": "2500",
          "conformanceComparatorLower": "greater than",
          "appliedConsequence": [
            {
              "id": "65d1382e3be28210d140068aa4e45a31",
              "appliedAction": "sendWarning",
              "description": "send a warning to the system",
              "name": "sendWarning",
              "repeatAction": "0"
            }
          ]
        }
      ]
    }
  ]
}

Gestion des tests de service API ouverte : PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id}

Autorise les mises à jour partielles d’une entité de définition de test de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id}

Paramètres de demande pris en charge

Tableau 32. Paramètres de chemin d'accès
Nom	Description
id	Sys_id ou external_id de la définition du test de service à récupérer. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]

Tableau 33. Paramètres de requête
Nom	Description
Néant

Tableau 34. Paramètres de corps de demande (XML ou JSON)
Nom	Description
description	Description de la définition du test de service. Type de données : chaîne
nom	Requis. Nom de la définition de test de service. Type de données : chaîne
relatedServiceSpecification	Requis. Spécifications de service de la définition de test. Type de données : tableau d’objets `"relatedServiceSpecification": [ { "id": "String", "name": "String" } ]`
relatedServiceSpecification.id	Sys_id ou external_id de la spécification de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Spécification [sn_prd_pm_specification].
relatedServiceSpecification.name	Nom de la spécification de service. Type de données : chaîne
serviceTestSpecRelationship	Définition de test de service connexe. Type de données : tableau d’objets `"serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ]`
serviceTestSpecRelationship.id	Sys_id ou external_id de la définition de test de service connexe. Type de données : chaîne Table : Définition de test [sn_st_mgmt_test_definition]
serviceTestSpecRelationship.name	Nom de la définition de test connexe. Type de données : chaîne
serviceTestSpecRelationship.relationshipType	Type de relation. Valeurs acceptées : dépendance exclusivité substitution Type de données : chaîne
specCaractéristique	Caractéristiques de la définition de test. Type de données : tableau d’objets `"specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ]`
specCharacteristic.characteristicValueSpecification	Valeurs possibles de la caractéristique. Type de données : tableau d’objets `"characteristicValueSpecification": [ { "value": "String" } ]`
specCharacteristic.characteristicValueSpecification.value	Valeur de la caractéristique. Type de données : chaîne
specCharacteristic.description	Description de la caractéristique. Type de données : chaîne
specCharacteristic.name	Nom de la caractéristique. Type de données : chaîne
specCharacteristic.validFor	Plage de dates pour laquelle la caractéristique est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
specCharacteristic.validFor.endDateTime	Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.validFor.startDateTime	Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
testMeasureDefinition	Définitions de mesure de test de test pour cette définition de test de service. Pour plus d'informations, consultez Define test measure definitions for a service test. Type de données : tableau d’objets `"testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ]`
testMeasureDefinition.captureFrequency	Fréquence à laquelle capturer la mesure. Valeurs valides : quotidien mensuel Aucun une fois hebdomadaire Type de données : chaîne
testMeasureDefinition.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasureDefinition.capturePeriod	Période ou durée de la capture des mesures. Type de données : objet `"capturePeriod": { "amount": Number, "units": "String" }`
testMeasureDefinition.capturePeriod.amount	Nombre de périodes de capture. Type de données : nombre
testMeasureDefinition.capturePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMeasureDefinition.id	Sys_id ou external_id des définitions des mesures de test. Type de données : chaîne Table : Table de définition de la mesure de test [sn_st_mgmt_test_measure_definition]
testMeasureDefinition.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasureDefinition.metricName	Nom défini par l’utilisateur d’une mesure dans la mesure de test. Type de données : chaîne
testMeasureDefinition.name	Nom de la définition de la mesure de test. Type de données : chaîne
testMeasureDefinition.thresholdRule	Règle qui définit les conditions à atteindre avant d’appliquer des conséquences lorsqu’un seuil est franchi (ou non franchi) dans la définition de la mesure de test. Pour plus d'informations, consultez Define threshold rules for a test measure definition. Type de données : tableau d’objets `{ "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } }`
testMeasureDefinition.thresholdRule.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : true : la valeur est identique à la valeur de conformanceTargetExact. false : la valeur n’est pas identique conformanceTargetExact. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Type de données : nombre
testMeasureDefinition.thresholdRule.consequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Pour plus d'informations, consultez Define measure consequences for the threshold rules. Type de données : tableau d’objets `"consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ]`
testMeasureDefinition.thresholdRule.consequence.description	Description de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.id	Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.name	Nom de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.prescribeAction	Action définie par l’utilisateur à prendre en cas de dépassement de seuil. Les actions varient d’une instance à l’autre. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.consequence.validFor	Plage de dates pour laquelle la conséquence est valide. Type de données : objet `"validFor": { "startDateTime": "String", "endDateTime ": "String" }`
testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime	Date de fin de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime	Date de début de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.description	Description de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.id	Sys_id ou external_id des règles de seuil. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Règles de seuil [sn_st_mgmt_threshold_rule].
testMeasureDefinition.thresholdRule.name	Nom de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasureDefinition.thresholdRule.thresholdRuleSeverity	Niveau de gravité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasureDefinition.unitOfMeasure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMeasureDefinition.validFor	Plage de dates à laquelle la définition de la mesure de test est valide. Type de données : chaîne `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
testMeasureDefinition.validFor.endDateTime	Date de fin de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.validFor.startDateTime	Date de début de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

En-têtes

Tableau 35. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json
Content-Type	Format de données du corps de la demande. Prend uniquement en charge application/json.

Tableau 36. En-têtes de réponses
En-tête	Description
Type de contenu	Format de données du corps de la réponse. Prend uniquement en charge application/json.

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.

Tableau 37. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
404	Introuvable. L’élément demandé est introuvable.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
description	Description de la définition du test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
nom	Nom de la définition de test de service. Type de données : chaîne
relatedServiceSpecification	Spécifications de service pour les définitions de test. Type de données : tableau d’objets `"relatedServiceSpecification": [ { "id": "String", "name": "String" } ]`
relatedServiceSpecification.id	Sys_id ou external_id de la spécification de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Spécification [sn_prd_pm_specification].
relatedServiceSpecification.name	Nom de la spécification de service. Type de données : chaîne
serviceTestSpecRelationship	Définition de test de service connexe. Type de données : tableau d’objets `"serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ]`
serviceTestSpecRelationship.id	Sys_id ou external_id de la définition de test de service connexe. Type de données : chaîne Table : Définition de test [sn_st_mgmt_test_definition]
serviceTestSpecRelationship.name	Nom de la définition de test connexe. Type de données : chaîne
serviceTestSpecRelationship.relationshipType	Type de relation. Valeurs acceptées : dépendance exclusivité substitution Type de données : chaîne
specCaractéristique	Caractéristiques des définitions de tests. Type de données : tableau d’objets `"specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ]`
specCharacteristic.characteristicValueSpecification	Valeurs possibles de la caractéristique. Type de données : tableau d’objets `"characteristicValueSpecification": [ { "value": "String" } ]`
specCharacteristic.characteristicValueSpecification.value	Valeur de la caractéristique. Type de données : chaîne
specCharacteristic.description	Description de la caractéristique. Type de données : chaîne
specCharacteristic.name	Nom de la caractéristique. Type de données : chaîne
specCharacteristic.validFor	Plage de dates pour laquelle la caractéristique est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
specCharacteristic.validFor.endDateTime	Date de fin de la caractéristique. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
specCharacteristic.validFor.startDateTime	Date de début de la caractéristique. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
specCharacteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
testMeasureDefinition	Définitions de mesure de test de test pour cette définition de test de service. Pour plus d'informations, consultez Define test measure definitions for a service test. Type de données : tableau d’objets `"testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ]`
testMeasureDefinition.captureFrequency	Fréquence de capture de la mesure. Valeurs valides : quotidien mensuel Aucun une fois hebdomadaire Type de données : chaîne
testMeasureDefinition.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasureDefinition.capturePeriod	Durée ou période de la capture. Type de données : objet `"capturePeriod": { "amount": Number, "units": "String" }`
testMeasureDefinition.capturePeriod.amount	Nombre de périodes de capture. Type de données : nombre
testMeasureDefinition.capturePeriod.units	Unités de la période. Valeurs acceptées : jours Heures minutes secondes Type de données : chaîne
testMeasureDefinition.id	Sys_id ou external_id des définitions de mesure de test. Type de données : chaîne Table : Définition de la mesure de test [sn_st_mgmt_test_measure_definition]
testMeasureDefinition.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasureDefinition.metricName	Nom défini par l’utilisateur d’une mesure dans la mesure de test. Type de données : chaîne
testMeasureDefinition.name	Nom de la définition de la mesure de test. Type de données : chaîne
testMeasureDefinition.thresholdRule	Règle qui définit la condition (augmenter ou effacer) à atteindre pour appliquer des conséquences lorsqu’un seuil est franchi ou cesse de l’être pour une définition de mesure de test particulière. Type de données : tableau d’objets `{ "thresholdRule": { "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } }`
testMeasureDefinition.thresholdRule.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : true : la valeur est identique à la valeur de conformanceTargetExact. false : la valeur n’est pas identique conformanceTargetExact. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à est Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : inférieur à est Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Type de données : nombre
testMeasureDefinition.thresholdRule.consequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Type de données : tableau d’objets `"consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ]`
testMeasureDefinition.thresholdRule.consequence.description	Description de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.id	Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.name	Nom de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.prescribeAction	Action définie par l’utilisateur à prendre en cas de dépassement de seuil. Les actions varient d’une instance à l’autre. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.repeatAction	Marqueur indiquant s’il faut répéter ou non l’action appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.consequence.validFor	Plage de dates pour laquelle la conséquence est valide. Type de données : objet `"validFor": { "startDateTime": "String", "endDateTime ": "String" }`
testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime	Date de fin de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime	Date de début de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.description	Description de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.id	Sys_id ou external_id des règles de seuil. Type de données : chaîne Table : Règles de seuil [sn_st_mgmt_threshold_rule]
testMeasureDefinition.thresholdRule.name	Nom de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasureDefinition.thresholdRule.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé faible moyen Type de données : chaîne
testMeasureDefinition.unitOfMeasure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMeasureDefinition.validFor	Plage de dates pour laquelle la définition de la mesure de test est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
testMeasureDefinition.validFor.endDateTime	Date de fin de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.validFor.startDateTime	Date de début de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

L’exemple suivant met à jour partiellement l’ID de définition de test de service donné en fonction des modifications fournies dans le corps de la demande.

curl "http://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/89d2b920432a02104fefe4511fb8f22e " 
--request PATCH
--header "Accept:application/json" 
--user 'username':'password'
--data {
  "description": "Upstream and Downstream speed ",
  "name": "This is my new Speed Test",
  "testMeasureDefinition": [
    {
      "id": "1a04f560432a02104fefe4511fb8f2ad",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the downstream speed in a service",
      "metricName": "Downstream Speed",
      "name": "Downstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "30 Minutes",
      "validFor": {
        "startDateTime": "2024-05-30 08:49:26",
        "endDateTime": "2024-05-31 08:49:29"
      },
      "thresholdRule": [
        {
          "id": "a754f960432a02104fefe4511fb8f2d0",
          "description": "This speed is greater than the target upper",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "15 Minutes",
          "conformanceTargetLower": "75",
          "conformanceComparatorLower": "greater than",
          "consequence": [
            {
              "id": "15a4bd60432a02104fefe4511fb8f2b8",
              "prescribeAction": "null",
              "description": "generate a waring report",
              "name": "degradedQualityOfService",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:51:29",
                "endDateTime": "2024-08-06 08:51:31"
              }
            },
            {
              "id": "e6847d60432a02104fefe4511fb8f2c3",
              "prescribeAction": "null",
              "description": "send a warning to the system",
              "name": "packetdrop",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:50:53",
                "endDateTime": "2024-08-06 08:50:55"
              }
            }
          ]
        },
        {
          "id": "cb55b5a0432a02104fefe4511fb8f201",
          "description": "",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "medium",
          "tolerancePeriod": "",
          "conformanceTargetUpper": "120",
          "conformanceComparatorUpper": "less than",
          "consequence": []
        }
      ]
    },
    {
      "id": "8f987524432a02104fefe4511fb8f2f0",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the upstream speed in the service",
      "metricName": "Upstream Speed",
      "name": "Upstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "",
      "validFor": {
        "startDateTime": "",
        "endDateTime": ""
      },
      "thresholdRule": []
    }
  ],
  "specCharacteristic": [
    {
      "name": "restart",
      "description": "restart",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2024-05-30 08:45:49"
      }
    }
  ],
  "serviceTestSpecRelationship": [
    {
      "id": "76a3b160432a02104fefe4511fb8f2ad",
      "name": "OAM Test",
      "relationshipType": ""
    }
  ],
  "relatedServiceSpecification": [
    {
      "id": "aeddcd1fb7d69910ff00f203ae11a990",
      "name": "Home Internet"
    }
  ]
}

Le corps de la réponse renvoie la partie mise à jour de la spécification du test de service :

{
  "description": "Upstream and Downstream speed ",
  "name": "This is my new Speed Test",
  "testMeasureDefinition": [
    {
      "id": "1a04f560432a02104fefe4511fb8f2ad",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the downstream speed in a service",
      "metricName": "Downstream Speed",
      "name": "Downstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "30 Minutes",
      "validFor": {
        "startDateTime": "2024-05-30 08:49:26",
        "endDateTime": "2024-05-31 08:49:29"
      },
      "thresholdRule": [
        {
          "id": "a754f960432a02104fefe4511fb8f2d0",
          "description": "This speed is greater than the target upper",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "15 Minutes",
          "conformanceTargetLower": "75",
          "conformanceComparatorLower": "greater than",
          "consequence": [
            {
              "id": "15a4bd60432a02104fefe4511fb8f2b8",
              "prescribeAction": "null",
              "description": "generate a waring report",
              "name": "degradedQualityOfService",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:51:29",
                "endDateTime": "2024-08-06 08:51:31"
              }
            },
            {
              "id": "e6847d60432a02104fefe4511fb8f2c3",
              "prescribeAction": "null",
              "description": "send a warning to the system",
              "name": "packetdrop",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:50:53",
                "endDateTime": "2024-08-06 08:50:55"
              }
            }
          ]
        },
        {
          "id": "cb55b5a0432a02104fefe4511fb8f201",
          "description": "",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "medium",
          "tolerancePeriod": "",
          "conformanceTargetUpper": "120",
          "conformanceComparatorUpper": "less than",
          "consequence": []
        }
      ]
    },
    {
      "id": "8f987524432a02104fefe4511fb8f2f0",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the upstream speed in the service",
      "metricName": "Upstream Speed",
      "name": "Upstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "",
      "validFor": {
        "startDateTime": "",
        "endDateTime": ""
      },
      "thresholdRule": []
    }
  ],
  "specCharacteristic": [
    {
      "name": "restart",
      "description": "restart",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2024-05-30 08:45:49"
      }
    }
  ],
  "serviceTestSpecRelationship": [
    {
      "id": "76a3b160432a02104fefe4511fb8f2ad",
      "name": "OAM Test",
      "relationshipType": ""
    }
  ],
  "relatedServiceSpecification": [
    {
      "id": "aeddcd1fb7d69910ff00f203ae11a990",
      "name": "Home Internet"
    }
  ]
}

Gestion des tests de service API ouverte : POST /sn_sprb_mgmt/servicetestmanagement/serviceTest

Crée un test de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest

Paramètres de demande pris en charge

Tableau 38. Paramètres de chemin d'accès
Nom	Description
Aucun

Tableau 39. Paramètres de requête
Nom	Description
Néant

Tableau 40. Paramètres de corps de demande (XML ou JSON)
Nom	Description
characteristic	Liste décrivant les caractéristiques du test de service associé. Pour plus d’informations sur les caractéristiques des définitions de test, voir Type de données : tableau d’objets `"characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ]`
characteristic.id	Sys_id ou external_id de caractéristiques. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne Tableau : Caractéristiques [sn_prd_pm_characteristic]
characteristic.name	Nom de la caractéristique. Type de données : chaîne
caractéristique.valeur	Options de caractéristiques associées au test de service. Les caractéristiques varient en fonction de l’instance client. Type de données : chaîne
characteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
description	Description du test de service. Type de données : chaîne
endDateTime	Date et heure de fin du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
id	Sys_id ou external_id du test de service. Cet ID crée un test de service et est utilisé comme external_id. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
Mode	Mode dans lequel le test de service s’exécute. Valeurs valides : ONDEMAND : déclenche manuellement le test de service. PROACTIF : déclenche automatiquement le test de service. Type de données : chaîne Valeur par défaut : ONDEMAND
nom	Requis. Nom du test de service. Type de données : chaîne
relatedService (en anglais)	Requis. Définition de test associée au test de service. Type de données : objet `"relatedService": { "href": "String", "id": "String", "name": "String" }`
relatedService.href	Référence de lien hypertexte vers le service connexe. Type de données : chaîne
relatedService.id	Sys_id ou external_id de l’inventaire des produits. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Inventaire des produits [sn_prd_invt_product_inventory].
relatedService.name	Nom de l’élément d’inventaire des produits. Type de données : chaîne
startDateTime	Date et heure de début du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
État	État dans lequel se trouve le test de service. Valeurs valides : confirmé annulé terminé échoué inProgress En attente rejeté Type de données : chaîne
testMeasure	Mesure d’un aspect spécifique d’un test de produit, de service ou de ressource, tel que la perte de paquets ou l’état de connectivité. Type de données : tableau d’objets `"testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ]`
testMeasure.accuracy	Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40
testMeasure.captureDateTime	Date et heure auxquelles la mesure a été capturée. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasure.id	Sys_id ou external_id des mesures de test. Type de données : chaîne Table : dans les champs sys_id ou external_id de la table des mesures de test [sn_st_mgmt_test_measure].
testMesure.Mesure.Méthode de capture	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasure.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasure.metricName	Nom de la mesure de test. Type de données : chaîne
testMeasure.ruleViolation	Objet permettant de définir une règle dans la définition de règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d’objets `"ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ]`
testMeasure.ruleViolation.appliedConsequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Type de données : tableau d’objets `"appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ]`
testMeasure.ruleViolation.appliedConsequence.appliedAction	Action à entreprendre lorsqu’une règle de seuil n’est pas respectée. Par exemple, l’envoi d’un avertissement ou la génération d’un rapport. Les actions appliquées peuvent varier d’une instance à l’autre. Type de données : chaîne
testMesure.RègleViolation.appliquéeConconséquence.description	Description de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.id	Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.name	Nom de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence lorsqu’une deuxième violation se produit. Valeurs valides : vrai : répétez l’action. faux : ne répétez pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComporatorExact	Marqueur indiquant si une valeur est identique. Valeurs valides : true : la valeur est identique. false : la valeur n’est pas identique. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComporatorLower	Opérateur permettant de vérifier si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasure.ruleViolation.conformanceComporatorUpper	Opérateur pour vérifier si une valeur est au-dessus du seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasure.ruleViolation.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.description	Description de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.id	Sys_id ou external_id de la violation de la règle de seuil. Type de données : chaîne Table : Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]
testMeasure.ruleViolation.name	Nom de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasure.ruleViolation.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasure.ruleViolation.tolerancePeriod	Intervalle de temps spécifié pendant lequel les occurrences de croisement sont activées sans déclencher de conséquences ou d’actions immédiates. Type de date : objet `"tolerancePeriod": { "amount": Number, "units": "String" }`
testMeasure.ruleViolation.tolerancePeriod.amount	Nombre de périodes avant l’application de la conséquence. Type de données : nombre
testMeasure.ruleViolation.tolerancePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMesure.unitéDeMesure	Unité de mesure des valeurs cibles de conformité de la mesure d’essai. Type de données : chaîne
testMesure.valeur	Valeur de la mesure de test. Type de données : objet `"value": { "id": "String", "name": "String", "valueType": "String", "value": "String }`
testMeasure.value.id	ID de la valeur de la mesure de test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de la mesure de test. Type de données : chaîne
testMesure.valeur.valeur	Valeur de la mesure de test. Type de données : chaîne
testMesure.valeur.valeurType	Type de valeur de mesure de test, par exemple numérique, texte, etc. Type de données : chaîne
testSpecification	Requis. Définition de test associée à ce test. Type de données : objet `"testSpecification": { "href": "String", "id": "String" }`
testSpecification.href	Référence de lien hypertexte vers la définition du test de service. Type de données : chaîne
testSpecification.id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Définition du test de service [sn_st_mgmt_test_definition].
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime ": "String", "startDateTime": "String" }`
validFor.endDateTime	Date de fin de validité du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date de début de validité du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

En-têtes

Tableau 41. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml. Valeur par défaut : application/json

Tableau 42. En-têtes de réponses
En-tête	Description
Aucun

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.

Tableau 43. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
characteristic	Liste décrivant les caractéristiques du test de service associé. Type de données : tableau d’objets `"characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ]`
characteristic.id	Sys_id ou external_id de caractéristiques. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne Tableau : Caractéristiques [sn_prd_pm_characteristic]
characteristic.name	Nom de la caractéristique. Type de données : chaîne
caractéristique.valeur	Options de caractéristiques associées au test de service. Les caractéristiques varient en fonction de l’instance client. Type de données : chaîne
characteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
description	Description du test de service. Type de données : chaîne
endDateTime	Date et heure de fin du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
Mode	Mode dans lequel le test de service s’exécute. Valeurs valides : ONDEMAND : déclenche manuellement le test de service. PROACTIF : déclenche automatiquement le test de service. Type de données : chaîne Valeur par défaut : ONDEMAND
nom	Nom du test de service. Type de données : chaîne
relatedService (en anglais)	Définition de test associée pour ce test. Type de données : objet `"relatedService": { "href": "string", "id": "String", "name": "String" }`
relatedService.id	Sys_id ou external_id de l’inventaire des produits. Type de données : chaîne Table : Inventaire des produits [sn_prd_invt_product_inventory]
relatedService.name	Nom de l’inventaire de produits. Type de données : chaîne
startDateTime	Date et heure de début du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
État	État du test de service. Valeurs valides : confirmé annulé terminé échoué inProgress En attente rejeté Type de données : chaîne
testMeasure	Mesure d’un aspect spécifique d’un test de produit, de service ou de ressource, tel que la perte de paquets ou l’état de connectivité. Type de données : tableau d’objets `"testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ]`
testMeasure.accuracy	Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40
testMeasure.captureDateTime	Date et heure auxquelles la mesure a été capturée. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasure.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasure.id	Sys_id ou external_id de la mesure de test. Type de données : chaîne Tableau : Mesures d’essai [sn_st_mgmt_test_measure]
testMeasure.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasure.metricName	Nom d’une mesure dans la mesure de test. Type de données : chaîne
testMeasure.ruleViolation	Objet pour définir une règle dans la définition de règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d’objets `"RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ]`
testMeasure.ruleViolation.appliedConsequence	Action (action prescrite ou notification) à entreprendre lorsqu’une règle de seuil n’est pas respectée. Type de données : tableau d’objets `"appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ]`
testMeasure.ruleViolation.appliedConsequence.appliedAction	Action à entreprendre lorsqu’une règle de seuil n’est pas respectée. Par exemple, l’envoi d’un avertissement ou la génération d’un rapport. Les actions appliquées peuvent varier d’une instance à l’autre. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction	Marqueur indiquant s’il faut répéter ou non l’action appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMesure.RègleViolation.appliquéeConconséquence.description	Description de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.id	Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.appliedConsequence.name	Nom de la conséquence appliquée. Type de données : chaîne
testMeasure.ruleViolation.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : true : la valeur est identique. false : la valeur n’est pas identique. Type de données : booléennes Valeur par défaut : false
testMeasure.ruleViolation.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à est Type de données : chaîne
testMeasure.ruleViolation.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : est inférieur à Type de données : chaîne
testMeasure.ruleViolation.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Détermine si le seuil est franchi ou n’est plus atteint. Type de données : nombre
testMeasure.ruleViolation.description	Description de la violation de la règle de seuil. Type de données : chaîne
testMeasure.ruleViolation.id	Sys_id ou external_id de la violation de la règle de seuil. Type de données : chaîne Table : Violation de la règle de seuil [sn_st_mgmt_threshold_rule_violation]
testMeasure.ruleViolation.name	Nom de la violation de la règle de seuil. Type de date : chaîne
testMeasure.ruleViolation.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Maximum : 40
testMeasure.ruleViolation.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé faible moyen Type de données : chaîne
testMeasure.ruleViolation.tolerancePeriod	Durée ou intervalle de temps pendant lequel les croisements autorisés peuvent se produire avant le déclenchement d’une conséquence. Type de date : objet `"tolerancePeriod": { "amount": Number, "units": "String" }`
testMeasure.ruleViolation.tolerancePeriod.amount	Montant de la période, en nombre. Type de données : nombre
testMeasure.ruleViolation.tolerancePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMesure.unitéDeMesure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMesure.valeur	Valeur de la mesure dans le test. Type de données : objet `"value": { "id": "String", "name": "String", "valueType": "String", "value": "String" }`
testMeasure.value.id	ID de la valeur de mesure dans le test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de mesure dans le test. Type de données : chaîne
testMeasure.value.name	Nom de la valeur de mesure dans le test. Type de données : chaîne
testMesure.valeur.valeur	Valeur de la mesure dans le test. Type de données : chaîne
testMesure.valeur.valeurType	Type de valeur de mesure de test, par exemple numérique, texte, etc. Type de données : chaîne
testSpecification	Définition de test associée pour ce test. Type de données : objet `"testSpecification": { "href": "String", "id": "String" }`
testSpecification.href	Référence de lien hypertexte vers la définition du test de service. Type de données : chaîne
testSpecification.id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
validFor.endDateTime	Date de fin et horodatage du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date de début et horodatage du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

L’exemple suivant crée un nouveau test de service en fonction des détails spécifiques fournis dans le corps de la demande.

curl "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data {
  "description": "Service test",
  "endDateTime": "2025-01-31 15:05:43",
  "mode": "proactive",
  "name": "Speed Test TR0001002",
  "startDateTime": "2024-06-05 09:07:10",
  "validFor": {
    "startDateTime": "",
    "endDateTime": ""
  },
  "relatedService": {
    "id": "fa6d13f45b5620102dff5e92dc81c77f",
    "name": "Internet_VPLS_PI0000011"
  },
  "testSpecification": {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad",
    "id": "76a3b160432a02104fefe4511fb8f2ad"
  },
  "characteristic": [
    {
      "id": "e7ef960443f202104fefe4511fb8f224",
      "name": "AccessRequired",
      "valueType": "yes_no",
      "value": "Yes"
    }
  ],
  "testMeasure": [
    {
      "id": "61d1382e3be28210d140068aa4e45a2e",
      "accuracy": "0.0001",
      "captureDateTime": "",
      "captureMethod": "automatic",
      "metricDescription": "",
      "metricName": "Flow speed",
      "unitOfMeasure": "A second",
      "value": "3000",
      "ruleViolation": [
        {
          "id": "61d1382e3be28210d140068aa4e45a2f",
          "description": "This speed is greater than the target",
          "name": "tooMuchTraffic",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "",
          "conformanceTargetLower": "2500",
          "conformanceComparatorLower": "greater than",
          "appliedConsequence": [
            {
              "id": "65d1382e3be28210d140068aa4e45a31",
              "appliedAction": "sendWarning",
              "description": "send a warning to the system",
              "name": "sendWarning",
              "repeatAction": "0"
            }
          ]
        }
      ]
    }
  ]
}

La réponse renvoie les détails de confirmation concernant le nouveau service de test et lui attribue un ID unique, 2b406ec043b202104fe4511fb8f211 :

{
  "description": "Service test",
  "endDateTime": "2025-01-31 15:05:43",
  "mode": "proactive",
  "name": "Speed Test TR0001002",
  "startDateTime": "2024-06-05 09:07:10",
  "validFor": {
    "startDateTime": "",
    "endDateTime": ""
  },
  "relatedService": {
    "id": "fa6d13f45b5620102dff5e92dc81c77f",
    "name": "Internet_VPLS_PI0000011"
  },
  "testSpecification": {
    "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad",
    "id": "76a3b160432a02104fefe4511fb8f2ad"
  },
  "characteristic": [
    {
      "id": "e7ef960443f202104fefe4511fb8f224",
      "name": "AccessRequired",
      "valueType": "yes_no",
      "value": "Yes"
    }
  ],
  "testMeasure": [
    {
      "id": "61d1382e3be28210d140068aa4e45a2e",
      "accuracy": "0.0001",
      "captureDateTime": "",
      "captureMethod": "automatic",
      "metricDescription": "",
      "metricName": "Flow speed",
      "unitOfMeasure": "A second",
      "value": "3000",
      "ruleViolation": [
        {
          "id": "61d1382e3be28210d140068aa4e45a2f",
          "description": "This speed is greater than the target",
          "name": "tooMuchTraffic",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "",
          "conformanceTargetLower": "2500",
          "conformanceComparatorLower": "greater than",
          "appliedConsequence": [
            {
              "id": "65d1382e3be28210d140068aa4e45a31",
              "appliedAction": "sendWarning",
              "description": "send a warning to the system",
              "name": "sendWarning",
              "repeatAction": "0"
            }
          ]
        }
      ]
    }
  ],
  "id": "2b406ec043b202104fefe4511fb8f211"
}

Gestion des tests de service API ouverte : POST /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification

Crée une nouvelle définition de test de service.

Format d'URL

URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification

Paramètres de demande pris en charge

Tableau 44. Paramètres de chemin d'accès
Nom	Description
Aucun

Tableau 45. Paramètres de requête
Nom	Description
Néant

Tableau 46. Paramètres de corps de demande (XML ou JSON)
Nom	Description
description	Description de la définition du test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Définition de test de service [sn_st_mgmt_test_definition]
nom	Requis. Nom de la définition de test de service. Type de données : chaîne
relatedServiceSpecification	Requis. Spécifications de service de la définition de test. Type de données : tableau d’objets `"relatedServiceSpecification": [ { "id": "String", "name": "String" } ]`
relatedServiceSpecification.id	Sys_id ou external_id de la spécification de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Spécification [sn_prd_pm_specification].
relatedServiceSpecification.name	Nom de la spécification de service. Type de données : chaîne
serviceTestSpecRelationship	Définition de test de service connexe. Type de données : tableau d’objets `"serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ]`
serviceTestSpecRelationship.id	Sys_id ou external_id de la définition de test de service connexe. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Définition de test [sn_st_mgmt_test_definition].
serviceTestSpecRelationship.name	Nom de la définition de test connexe. Type de données : chaîne
serviceTestSpecRelationship.relationshipType	Type de relation. Valeurs valides : dépendance exclusivité substitution Type de données : chaîne
specCaractéristique	Caractéristiques de la définition de test. Type de données : tableau d’objets `"specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ]`
specCharacteristic.characteristicValueSpecification	Valeurs possibles de la caractéristique. Type de données : tableau d’objets `"characteristicValueSpecification": [ { "value": "String" } ]`
specCharacteristic.characteristicValueSpecification.value	Valeur de la caractéristique. Type de données : chaîne
specCharacteristic.description	Description de la caractéristique. Type de données : chaîne
specCharacteristic.name	Nom de la caractéristique. Type de données : chaîne
specCharacteristic.validFor	Plage de dates pour laquelle la caractéristique est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
specCharacteristic.validFor.endDateTime	Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.validFor.startDateTime	Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne
specCharacteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
testMeasureDefinition	Définitions de mesure de test de test pour cette définition de test de service. Pour plus d'informations, consultez Define test measure definitions for a service test. Type de données : tableau d’objets `"testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ]`
testMeasureDefinition.captureFrequency	Fréquence à laquelle capturer la mesure. Valeurs valides : quotidien mensuel Aucun une fois hebdomadaire Type de données : chaîne
testMeasureDefinition.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasureDefinition.capturePeriod	Période ou durée de la capture des mesures. Type de données : objet `"capturePeriod": { "amount": Number, "units": "String" }`
testMeasureDefinition.capturePeriod.amount	Nombre de périodes de capture. Type de données : nombre
testMeasureDefinition.capturePeriod.units	Unités de la période. Valeurs valides : jours Heures minutes secondes Type de données : chaîne
testMeasureDefinition.id	Sys_id ou external_id des définitions des mesures de test. Type de données : chaîne Table : Table de définition de la mesure de test [sn_st_mgmt_test_measure_definition]
testMeasureDefinition.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasureDefinition.metricName	Nom défini par l’utilisateur d’une mesure dans la mesure de test. Type de données : chaîne
testMeasureDefinition.name	Nom de la définition de la mesure de test. Type de données : chaîne
testMeasureDefinition.thresholdRule	Règle qui définit les conditions à atteindre avant d’appliquer des conséquences lorsqu’un seuil est franchi (ou non franchi) dans la définition de la mesure de test. Pour plus d'informations, consultez Define threshold rules for a test measure definition. Type de données : tableau d’objets `{ "thresholdRule": { "consequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } }`
testMeasureDefinition.thresholdRule.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : true : la valeur est identique à la valeur de conformanceTargetExact. false : la valeur n’est pas identique conformanceTargetExact. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à supérieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : inférieur à inférieur ou égal à Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Type de données : nombre
testMeasureDefinition.thresholdRule.consequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Pour plus d'informations, consultez Define measure consequences for the threshold rules. Type de données : tableau d’objets `"consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ]`
testMeasureDefinition.thresholdRule.consequence.description	Description de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.id	Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.name	Nom de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.prescribeAction	Action définie par l’utilisateur à prendre en cas de dépassement de seuil. Les actions varient d’une instance à l’autre. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.repeatAction	Marqueur indiquant s’il faut répéter la conséquence appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.consequence.validFor	Plage de dates pour laquelle la conséquence est valide. Type de données : objet `"validFor": { "startDateTime": "String", "endDateTime ": "String" }`
testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime	Date de fin de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime	Date de début de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.description	Description de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.id	Sys_id ou external_id des règles de seuil. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Règles de seuil [sn_st_mgmt_threshold_rule].
testMeasureDefinition.thresholdRule.name	Nom de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasureDefinition.thresholdRule.thresholdRuleSeverity	Niveau de gravité de la règle de seuil. Valeurs valides : élevé moyen faible Type de données : chaîne
testMeasureDefinition.unitOfMeasure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMeasureDefinition.validFor	Plage de dates à laquelle la définition de la mesure de test est valide. Type de données : chaîne `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
testMeasureDefinition.validFor.endDateTime	Date de fin de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.validFor.startDateTime	Date de début de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
valide pour	Plage de dates pour laquelle la définition de test est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
validFor.endDateTime	Date et heure de la définition de test auxquelles son état est mis hors service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date et heure de publication de la définition de test sur laquelle son état est défini. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

En-têtes

Tableau 47. En-têtes de demandes
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 48. En-têtes de réponses
En-tête	Description
Type de contenu	Format de données du corps de la réponse. Prend uniquement en charge application/json.

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.

Tableau 49. Codes d'état
Code d'état	Description
200	Réussi. La demande a été correctement traitée.
400	Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
description	Description de la définition du test de service. Type de données : chaîne
id	Sys_id ou external_id de la définition du test de service. Type de données : chaîne Table : Test de service [sn_st_mgmt_test]
nom	Nom de la définition de test de service. Type de données : chaîne
relatedServiceSpecification	Spécifications de service pour les définitions de test. Type de données : tableau d’objets `"relatedServiceSpecification": [ { "id": "String", "name": "String" } ]`
relatedServiceSpecification.id	Sys_id ou external_id de la spécification de service. Type de données : chaîne Table : dans le champ sys_id ou external_id de la table Spécification [sn_prd_pm_specification].
relatedServiceSpecification.name	Nom de la spécification de service. Type de données : chaîne
serviceTestSpecRelationship	Définition de test de service connexe. Type de données : tableau d’objets `"serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ]`
serviceTestSpecRelationship.id	Sys_id ou external_id de la définition de test de service connexe. Type de données : chaîne Table : Définition de test [sn_st_mgmt_test_definition]
serviceTestSpecRelationship.name	Nom de la définition de test connexe. Type de données : chaîne
serviceTestSpecRelationship.relationshipType	Type de relation. Valeurs acceptées : dépendance exclusivité substitution Type de données : chaîne
specCaractéristique	Caractéristiques des définitions de tests. Type de données : tableau d’objets `"specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ]`
specCharacteristic.characteristicValueSpecification	Valeurs possibles de la caractéristique. Type de données : tableau d’objets `"characteristicValueSpecification": [ { "value": "String" } ]`
specCharacteristic.characteristicValueSpecification.value	Valeur de la caractéristique. Type de données : chaîne
specCharacteristic.description	Description de la caractéristique. Type de données : chaîne
specCharacteristic.name	Nom de la caractéristique. Type de données : chaîne
specCharacteristic.validFor	Plage de dates pour laquelle la caractéristique est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
specCharacteristic.validFor.endDateTime	Date de fin de la caractéristique. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
specCharacteristic.validFor.startDateTime	Date de début de la caractéristique. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
specCharacteristic.valueType	Type de valeur caractéristique. choix date Date/Heure durée E-mail étiquette Test de ligne unique oui/non Type de données : chaîne
testMeasureDefinition	Définitions de mesure de test de test pour cette définition de test de service. Pour plus d'informations, consultez Define test measure definitions for a service test. Type de données : tableau d’objets `"testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ]`
testMeasureDefinition.captureFrequency	Fréquence de capture de la mesure. Valeurs valides : quotidien mensuel Aucun une fois hebdomadaire Type de données : chaîne
testMeasureDefinition.captureMethod	Méthode utilisée pour capturer la mesure. Valeurs valides : automatic : capture automatique de la mesure. manual : capturer manuellement la mesure. aucun : ne capture pas la mesure. Type de données : chaîne
testMeasureDefinition.capturePeriod	Durée ou période de la capture. Type de données : objet `"capturePeriod": { "amount": Number, "units": "String" }`
testMeasureDefinition.capturePeriod.amount	Nombre de périodes de capture. Type de données : nombre
testMeasureDefinition.capturePeriod.units	Unités de la période. Valeurs acceptées : jours Heures minutes secondes Type de données : chaîne
testMeasureDefinition.id	Sys_id ou external_id des définitions de mesure de test. Type de données : chaîne Table : Définition de la mesure de test [sn_st_mgmt_test_measure_definition]
testMeasureDefinition.metricDescription	Brève description de la mesure. Type de données : chaîne
testMeasureDefinition.metricName	Nom défini par l’utilisateur d’une mesure dans la mesure de test. Type de données : chaîne
testMeasureDefinition.name	Nom de la définition de la mesure de test. Type de données : chaîne
testMeasureDefinition.thresholdRule	Règle qui définit la condition (augmenter ou effacer) à atteindre pour appliquer des conséquences lorsqu’un seuil est franchi ou cesse de l’être pour une définition de mesure de test particulière. Type de données : tableau d’objets `{ "thresholdRule": { "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": [Array], "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } }`
testMeasureDefinition.thresholdRule.conformanceComparatorExact	Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : true : la valeur est identique à la valeur de conformanceTargetExact. false : la valeur n’est pas identique conformanceTargetExact. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.conformanceComparatorLower	Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : supérieur à est Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceComparatorUpper	Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : inférieur à est Type de données : chaîne
testMeasureDefinition.thresholdRule.conformanceTargetExact	Requis si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur true, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetLower	Valeur de seuil inférieure pour comparer les résultats des mesures de test. Type de données : nombre
testMeasureDefinition.thresholdRule.conformanceTargetUpper	Valeur de seuil supérieure pour comparer les résultats de la mesure de test. Type de données : nombre
testMeasureDefinition.thresholdRule.consequence	Action (action prescrite ou notification) à effectuer lorsqu’une règle de seuil est dépassée. Type de données : tableau d’objets `"consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ]`
testMeasureDefinition.thresholdRule.consequence.description	Description de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.id	Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.name	Nom de la conséquence. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.prescribeAction	Action définie par l’utilisateur à prendre en cas de dépassement de seuil. Les actions varient d’une instance à l’autre. Type de données : chaîne
testMeasureDefinition.thresholdRule.consequence.repeatAction	Marqueur indiquant s’il faut répéter ou non l’action appliquée. Valeurs valides : vrai : répète l’action. faux : ne répète pas l’action. Type de données : booléennes Valeur par défaut : false
testMeasureDefinition.thresholdRule.consequence.validFor	Plage de dates pour laquelle la conséquence est valide. Type de données : objet `"validFor": { "startDateTime": "String", "endDateTime ": "String" }`
testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime	Date de fin de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime	Date de début de validité de la conséquence. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.thresholdRule.description	Description de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.id	Sys_id ou external_id des règles de seuil. Type de données : chaîne Table : Règles de seuil [sn_st_mgmt_threshold_rule]
testMeasureDefinition.thresholdRule.name	Nom de la règle de seuil. Type de données : chaîne
testMeasureDefinition.thresholdRule.numberOfAllowedCrossing	Nombre maximal de croisements autorisés pendant la période de tolérance avant l’application des conséquences. Type de données : nombre Valeur maximale : 40
testMeasureDefinition.thresholdRule.thresholdRuleSeverity	Sévérité de la règle de seuil. Valeurs valides : élevé faible moyen Type de données : chaîne
testMeasureDefinition.unitOfMeasure	Valeur mesurable du temps utilisé pour calculer les performances d’un service en jours, minutes et secondes. Type de données : chaîne
testMeasureDefinition.validFor	Plage de dates pour laquelle la définition de la mesure de test est valide. Type de données : objet `"validFor": { "endDateTime": "String", "startDateTime": "String" }`
testMeasureDefinition.validFor.endDateTime	Date de fin de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
testMeasureDefinition.validFor.startDateTime	Date de début de validité de la définition de la mesure de test. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
valide pour	Plage de dates pour laquelle le test de service est valide. Type de données : objet `"validFor": { "endDateTime ": "String", "startDateTime": "String" }`
validFor.endDateTime	Date et heure de fin du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.
validFor.startDateTime	Date et heure de début du test de service. Type de données : chaîne Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`.

Demande cURL

L’exemple suivant crée une nouvelle définition de test de service.

curl "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--user 'username':'password'
-- data {
  "description": "Upstream and Downstream speed ",
  "name": "Speed Test",
  "validFor": {
    "startDateTime": "2024-05-31",
    "endDateTime": "2024-06-27"
  },
  "testMeasureDefinition": [
    {
      "id": "1a04f560432a02104fefe4511fb8f2ad",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the downstream speed in a service",
      "metricName": "Downstream Speed",
      "name": "Downstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "30 Minutes",
      "validFor": {
        "startDateTime": "2024-05-30 08:49:26",
        "endDateTime": "2024-05-31 08:49:29"
      },
      "thresholdRule": [
        {
          "id": "a754f960432a02104fefe4511fb8f2d0",
          "description": "This speed is greater than the target upper",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "15 Minutes",
          "conformanceTargetLower": "75",
          "conformanceComparatorLower": "greater than",
          "consequence": [
            {
              "id": "15a4bd60432a02104fefe4511fb8f2b8",
              "prescribeAction": "null",
              "description": "generate a waring report",
              "name": "degradedQualityOfService",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:51:29",
                "endDateTime": "2024-08-06 08:51:31"
              }
            },
            {
              "id": "e6847d60432a02104fefe4511fb8f2c3",
              "prescribeAction": "null",
              "description": "send a warning to the system",
              "name": "packetdrop",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:50:53",
                "endDateTime": "2024-08-06 08:50:55"
              }
            }
          ]
        },
        {
          "id": "cb55b5a0432a02104fefe4511fb8f201",
          "description": "",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "medium",
          "tolerancePeriod": "",
          "conformanceTargetUpper": "120",
          "conformanceComparatorUpper": "less than",
          "consequence": []
        }
      ]
    },
    {
      "id": "8f987524432a02104fefe4511fb8f2f0",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the upstream speed in the service",
      "metricName": "Upstream Speed",
      "name": "Upstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "",
      "validFor": {
        "startDateTime": "",
        "endDateTime": ""
      },
      "thresholdRule": []
    }
  ],
  "specCharacteristic": [
    {
      "name": "restart",
      "description": "restart",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2024-05-30 08:45:49"
      },
      "characteristicValueSpecification": [
        {
          "value": "No",
        },
        {
          "value": "Yes",
        }
      ]
    }
  ],
  "serviceTestSpecRelationship": [
    {
      "id": "76a3b160432a02104fefe4511fb8f2ad",
      "name": "OAM Test",
      "relationshipType": ""
    }
  ],
  "relatedServiceSpecification": [
    {
      "id": "aeddcd1fb7d69910ff00f203ae11a990",
      "name": "Home Internet"
    }
  ]
}

Corps de la réponse.

{
  "description": "Upstream and Downstream speed ",  
  "name": "Speed Test",
  "validFor": {
    "startDateTime": "2024-05-31",
    "endDateTime": "2024-06-27"
  },
  "testMeasureDefinition": [
    {
      "id": "1a04f560432a02104fefe4511fb8f2ad",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the downstream speed in a service",
      "metricName": "Downstream Speed",
      "name": "Downstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "30 Minutes",
      "validFor": {
        "startDateTime": "2024-05-30 08:49:26",
        "endDateTime": "2024-05-31 08:49:29"
      },
      "thresholdRule": [
        {
          "id": "a754f960432a02104fefe4511fb8f2d0",
          "description": "This speed is greater than the target upper",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "high",
          "tolerancePeriod": "15 Minutes",
          "conformanceTargetLower": "75",
          "conformanceComparatorLower": "greater than",
          "consequence": [
            {
              "id": "15a4bd60432a02104fefe4511fb8f2b8",
              "prescribeAction": "null",
              "description": "generate a waring report",
              "name": "degradedQualityOfService",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:51:29",
                "endDateTime": "2024-08-06 08:51:31"
              }
            },
            {
              "id": "e6847d60432a02104fefe4511fb8f2c3",
              "prescribeAction": "null",
              "description": "send a warning to the system",
              "name": "packetdrop",
              "repeatAction": "0",
              "validFor": {
                "startDateTime": "2024-05-30 08:50:53",
                "endDateTime": "2024-08-06 08:50:55"
              }
            }
          ]
        },
        {
          "id": "cb55b5a0432a02104fefe4511fb8f201",
          "description": "",
          "name": "InternetSpeedValue",
          "numberOfAllowedCrossing": "0",
          "thresholdRuleSeverity": "medium",
          "tolerancePeriod": "",
          "conformanceTargetUpper": "120",
          "conformanceComparatorUpper": "less than",
          "consequence": []
        }
      ]
    },
    {
      "id": "8f987524432a02104fefe4511fb8f2f0",
      "captureFrequency": "once",
      "captureMethod": "automatic",
      "metricDescription": "This is the upstream speed in the service",
      "metricName": "Upstream Speed",
      "name": "Upstream Speed",
      "unitOfMeasure": "a second",
      "valueType": "",
      "capturePeriod": "",
      "validFor": {
        "startDateTime": "",
        "endDateTime": ""
      },
      "thresholdRule": []
    }
  ],
  "specCharacteristic": [
    {
      "name": "restart",
      "description": "restart",
      "valueType": "yes_no",
      "validFor": {
        "startDatetime": "2024-05-30 08:45:49"
      },
      "characteristicValueSpecification": [
        {
          "value": "No",
          "validFor": {
            "startDateTime": "",
            "endDateTime": ""
          }
        },
        {
          "value": "Yes",
          "validFor": {
            "startDateTime": "",
            "endDateTime": ""
          }
        }
      ]
    }
  ],
  "serviceTestSpecRelationship": [
    {
      "id": "76a3b160432a02104fefe4511fb8f2ad",
      "name": "OAM Test",
      "relationshipType": ""
    }
  ],
  "relatedServiceSpecification": [
    {
      "id": "aeddcd1fb7d69910ff00f203ae11a990",
      "name": "Home Internet"
    }
  ]
  "id": "89d2b920432a02104fefe4511fb8f22e"
}