---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Servicetestmanagement -- offene API

# Servicetestmanagement -- offene API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 73 Minuten Lesedauer

Die Servicetestmanagement Offen Die API stellt Endpunkte zum Erstellen und Abrufen von Servicetestdefinitionen und Servicetests bereit.
Verwenden Sie diese API, um Service Problem Management-Informationen zwischen externen Systemen und zu verwalten Now Platform. Die Servicetestmanagement Offen API ist ein ServiceNowImplementierung der REST-Spezifikation der TM-Forumsservice-Problemmanagement-API. Diese Implementierung basiert auf <https://www.tmforum.org/resources/specification/tmf653-service-test-management-api-user-guide-v4-1-0/>.

Diese REST-API wurde entwickelt, um Servicetests in einer Telekommunikationsumgebung zu verwalten und auszuführen. Anwender können Servicetests definieren, auslösen und überwachen, um sicherzustellen, dass Services Qualitäts- und Leistungsstandards erfüllen. Die API bietet Funktionen für das Testmanagement, einschließlich Erstellen und Aktualisieren von Testdefinitionen, Ausführen von Tests, Abrufen von Testergebnissen und Verwaltung von Testzeitplänen.

Die Servicetestmanagement Offen API erfordert das Plugin „Kundenservice-Problemmanagement" (com.sn_sprb_mgmt) und die Rolle „sn_sprb_mgmt.test_integrator". Diese API gehört zum Namespace sn_sprb_mgmt. Für weitere Informationen zum Serviceproblem-Management. Siehe [Customer Service Problem Management](https://www.servicenow.com/docs/access?context=cspm-landing-page&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US)Um weitere Informationen zu dieser Anwendung zu erhalten.  
Die Servicetestmanagement Offen API erstellt oder aktualisiert Daten in den folgenden Tabellen:

* Testlauf \[sn_st_mgmt_test\]
* Servicetestdefinition \[sn_st_mgmt_test_definition\]
* Testdefinitionsmerkmal \[sn_st_mgmt_test_definition_characteristic\]
* Testmerkmal \[sn_st_mgmt_test_characteristic\]
* Beziehung von Spezifikation zu Testdefinition \[sn_st_mgmt_test_definition_m2m\]
* Testdefinitionsbeziehung \[sn_st_mgmt_test_definition_rel\]
* Testmaßnahme \[sn_st_mgmt_test_measure\]
* Messkonsequenz \[sn_st_mgmt_measure_consequence\]
* Testmaßdefinition \[sn_st_mgmt_test_measure_definition\]
* Angewendete Konsequenz \[sn_st_mgmt_applied_consequence\]
* Schwellenwertregel \[sn_st_mgmt_threshold_rule\]
* Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\]
{#service-test-management-api__ul_a4n_gcw_4bc}

## Servicetestmanagement -- offene API -- GET /sn_sprb_mgmt/servicetestmanagement/serviceTest AB {#ariaid-title2}

Ruft eine Liste aller Servicetests ab.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest

### Unterstützte Anforderungsparameter

{#servicetestmgmt-GET-serviceTest__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 1. Pfad-Parameter]

{#servicetestmgmt-GET-serviceTest__entry__6}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Wenn dieser Parameter nicht verwendet wird, werden alle Felder zurückgegeben. Befindet sich in der Tabelle „Servicetest" \[sn_st_mgmt_test\]. Gültige Felder: * Merkmal * Beschreibung * endDateTime * ID * Modus * ZugehörigService * startDateTime * Staat * Testmessung * Testspezifikation * ValidiertFür {#servicetestmgmt-GET-serviceTest__ul_mtw_b3v_bcc} Datentyp: Zeichenfolge |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Höchstwert: 100 Standard: 20 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Parameter, um Ergebnisse in kleinen und verwaltbaren Blöcken zu paginieren. Der erste Datensatz wird bei 0 indiziert. Datentyp: Zahl Standard: 0 |
| status | Filtern Sie Testdefinitionen nach dem aktuellen Status des Tests. Nur Testdefinitionen im angegebenen Status werden in der Antwort zurückgegeben. Gültige Werte: * bestätigt * Abgebrochen * Abgeschlossen * Fehlgeschlagen * inProgress * Ausstehend * abgelehnt {#servicetestmgmt-GET-serviceTest__ul_vzj_npn_xbc} Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#servicetestmgmt-GET-serviceTest__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-GET-serviceTest__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Anforderungskopfzeilen.]

{#servicetestmgmt-GET-serviceTest__entry__24}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Gibt den Bereich der Inhalte an, die in einem paginierten Aufruf zurückgegeben werden. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert des Inhaltsbereichs-Headers ist Elemente `3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur Anwendung/JSON. |
| Verknüpfen | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse. * zuerst * letzte * Weiter * previous {#servicetestmgmt-GET-serviceTest__ul_yy3_2fs_pbc} |
| X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-GET-serviceTest__entry__34}{#servicetestmgmt-GET-serviceTest__entry-200-status-code}{#servicetestmgmt-GET-serviceTest__entry-400-status-code}{#servicetestmgmt-GET-serviceTest__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 206 | In Antwort zurückgegebene Teilressource (mit Paginierung). |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 6. Statuscodes]

{#servicetestmgmt-GET-serviceTest__table_ash_mhx_vbc__entry__2}

| Name | Beschreibung |
|-|-|
| Merkmal | Liste, die die Merkmale des zugehörigen Servicetests beschreibt. Weitere Informationen zu Testdefinitionsmerkmalen finden Sie unter Datentyp: Array von Objekten "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] |
| characteristic.id | SYS_ID oder external_ID von Merkmalen. Wenn „external_ID" für diesen Datensatz vorhanden ist, gibt die Antwort die „external_ID" zurück, andernfalls wird die sys_ID zurückgegeben Datentyp: Zeichenfolge Tabelle: Merkmale \[sn_prd_pm_characteristic\] |
| characteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Merkmal.Wert | Merkmalsoptionen, die dem Servicetest zugeordnet sind. Merkmale variieren je nach Kundeninstanz. Datentyp: Zeichenfolge |
| Merkmal.WertTyp | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-GET-serviceTest__ul_zfr_twr_dcc} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Servicetests. Datentyp: Zeichenfolge |
| endDateTime | Enddatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| href | Hyperlink-Verweis auf den Servicetest. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| Modus | Modus, in dem der Servicetest ausgeführt wird. Gültige Werte: * ONDEMAND: Löst den Servicetest manuell aus. * PROAKTIV: Löst den Servicetest automatisch aus. {#servicetestmgmt-GET-serviceTest__ul_ybc_mqn_xbc} Datentyp: Zeichenfolge Standard: ONDEMAND |
| name | Erforderlich. Name des Servicetests. Datentyp: Zeichenfolge |
| ZugehörigService | Erforderlich. Testdefinition, die dem Servicetest zugeordnet ist. Datentyp: Objekt "relatedService": { "href": "String", "id": "String", "name": "String" } |
| relatedService.id | SYS_ID oder external_ID des Produktbestands. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| relatedService.name | Name des Produktbestands. Datentyp: Zeichenfolge |
| startDateTime | Startdatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| Staat | Status, in dem sich der Servicetest befindet. Gültige Werte: * bestätigt * Abgebrochen * Abgeschlossen * Fehlgeschlagen * inProgress * Ausstehend * abgelehnt {#servicetestmgmt-GET-serviceTest__ul_gym_mqn_xbc} Datentyp: Zeichenfolge |
| Testmessung | Maß für einen bestimmten Aspekt eines Produkt-, Service- oder Ressourcentests, z. B. verlorene Pakete oder Konnektivitätsstatus. Datentyp: Array von Objekten "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] |
| Testmaß.Genauigkeit | Float-Dezimalwert, der die Genauigkeit der Testmessung darstellt, die für die zugehörigen Metriken erfasst wurde. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.captureDateTime | Datum und Uhrzeit der Erfassung der Metrik. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasure.id | SYS_ID oder external_ID der Testmaßnahmen. Datentyp: Zeichenfolge Tabelle: In den Feldern „sys_ID" oder „external_ID" der Tabelle „Testmaßnahmen" \[sn_st_mgmt_test_measure\]. |
| testMeasure.Measure.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-GET-serviceTest__ul_ed2_gxv_xbc} Datentyp: Zeichenfolge |
| TestMeasure.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasure.metricName | Name der Testmaßmetrik. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation | Ein Objekt zum Definieren einer Regel in der Schwellenwertregeldefinition, zusammen mit Konsequenzen, wenn die Regel verletzt wird. Datentyp: Array von Objekten "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] |
| testMeasure.ruleViolation.tolerancePeriod.amount | Anzahl der Zeiträume, bevor die Konsequenz angewendet wird. Datentyp: Zahl |
| testMeasure.ruleViolation.appliedConsequence | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Datentyp: Array von Objekten "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] |
| testMeasure.ruleViolation.appliedConsequence.appliedAction | Aktion, die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Beispiel: Senden einer Warnung oder Generieren eines Berichts. Angewendete Aktionen können zwischen Instanzen variieren. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.description | Beschreibung der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.id | SYS_ID oder external_ID der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.name | Name der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.repeatAction | Kennzeichnung, die angibt, ob die Konsequenz wiederholt werden soll, wenn ein zweiter Verstoß auftritt. Gültige Werte: * Wahr: Wiederholen Sie die Aktion. * Falsch: Wiederholen Sie die Aktion nicht. {#servicetestmgmt-GET-serviceTest__ul_ld2_gxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComporatorExact | Kennzeichnung, die angibt, ob ein Wert identisch ist. Gültige Werte: * Wahr: Der Wert ist identisch. * Falsch: Der Wert ist nicht identisch. {#servicetestmgmt-GET-serviceTest__ul_od2_gxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComporatorLower | Operator zum Überprüfen, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmgmt-GET-serviceTest__ul_sd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComporatorUpper | Operator zum Überprüfen, ob ein Wert über dem Schwellenwert liegt. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmgmt-GET-serviceTest__ul_vd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.id | SYS_ID oder external_ID des Schwellenwertregelverstoßes. Datentyp: Zeichenfolge Tabelle: Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\] |
| testMeasure.ruleViolation.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.ruleViolation.thresholdRuleSeverity | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmgmt-GET-serviceTest__ul_xd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.tolerancePeriod | Angegebenes Zeitintervall, in dem das Überschreiten von Vorkommen aktiviert wird, ohne unmittelbare Konsequenzen oder Aktionen auszulösen. Datumstyp: Objekt "tolerancePeriod": { "amount": Number, "units": "String" } |
| testMeasure.ruleViolation.tolerancePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-GET-serviceTest__ul_qbw_qds_dcc} Datentyp: Zeichenfolge |
| Testmaß.EinheitenMessung | Maßeinheit für die Konformitätszielwerte der Testmessung. Datentyp: Zeichenfolge |
| TestMeasure.value | Wert der Testmaßnahme. Datentyp: Objekt "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } |
| testMeasure.value.id | ID des Testmesswerts. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Testmesswerts. Datentyp: Zeichenfolge |
| TestMeasure.value.value | Wert der Testmaßnahme. Datentyp: Zeichenfolge |
| TestMeasure.Wert.WertTyp | Typ des Testmesswerts, z. B. numerisch, Text usw. Datentyp: Zeichenfolge |
| Testspezifikation | Erforderlich. Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "testSpecification": { "href": "String", "id": "String" } |
| TestSpecification.href | Hyperlink-Verweis auf die Servicetestdefinition. Datentyp: Zeichenfolge |
| testSpecification.id | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicetestdefinition" \[sn_st_mgmt_test_definition\]. |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime ": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Gültigkeitsenddatum des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Gültigkeitsstartdatum des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[Tabelle : 7. Antworttext-Parameter (XML oder JSON)]

{#servicetestmgmt-GET-serviceTest__table_ash_mhx_vbc}  

### Curl-Anforderung

Das folgende Beispiel ruft Informationen zu den beiden Servicetests in der Instanz ab.

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

Antworttext.

    [
      {
        "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"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]

## Servicetestmanagement -- offene API -- GET /sn_sprb_mgmt/servicetestmanagement/serviceTest/{ID} ab {#ariaid-title3}

Ruft eine Servicetest-Entität basierend auf der angegebenen ID eines Servicetests ab.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{ID}

### Unterstützte Anforderungsparameter

{#servicetestmgmt-GET-serviceTest-id__entry__2}

| Name | Beschreibung |
|-|-|
| id | SYS_ID oder external_ID des abzurufenden Servicetests. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
[Tabelle : 8. Pfad-Parameter]

{#servicetestmgmt-GET-serviceTest-id__entry__6}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Wenn dieser Parameter nicht verwendet wird, werden alle Felder zurückgegeben. Befindet sich in der Tabelle „Servicetest" \[sn_st_mgmt_test\]. Gültige Felder: * Merkmal * Beschreibung * endDateTime * ID * Modus * ZugehörigService * startDateTime * Staat * Testmessung * Testspezifikation * ValidiertFür {#servicetestmgmt-GET-serviceTest-id__ul_mtw_b3v_bcc} Datentyp: Zeichenfolge |
[Tabelle : 9. Abfrageparameter]

{#servicetestmgmt-GET-serviceTest-id__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 10. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-GET-serviceTest-id__entry__14}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Anforderungskopfzeilen.]

{#servicetestmgmt-GET-serviceTest-id__entry__18}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur Anwendung/JSON. |
[Tabelle : 12. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-GET-serviceTest-id__entry__22}{#servicetestmgmt-GET-serviceTest-id__entry-200-status-code}{#servicetestmgmt-GET-serviceTest-id__entry-400-status-code}{#servicetestmgmt-GET-serviceTest-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 13. Statuscodes]

### Antworttext-Parameter (JSON oder XML) {#servicetestmgmt-GET-serviceTest-id__section_vkd_xwr_pbc}

{#servicetestmgmt-GET-serviceTest-id__section_vkd_xwr_pbc__entry__2}

| Name | Beschreibung |
|-|-|
| Merkmal | Liste, die die Merkmale des zugehörigen Servicetests beschreibt. Datentyp: Array von Objekten "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] |
| Merkmal.ID | SYS_ID oder external_ID von Merkmalen.wenn external_ID für diesen Datensatz vorhanden ist, gibt die Antwort die external_ID zurück, andernfalls wird die sys_ID zurückgegeben Datentyp: Zeichenfolge Tabelle: Merkmale \[sn_prd_pm_characteristic\] |
| characteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Merkmal.Wert | Merkmalsoptionen, die dem Servicetest zugeordnet sind. Merkmale variieren je nach Kundeninstanz. Datentyp: Zeichenfolge |
| Merkmal.WertTyp | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-GET-serviceTest-id__ul_egw_twr_dcc} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Servicetests. Datentyp: Zeichenfolge |
| endDateTime | Enddatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| href | Hyperlink-Verweis auf den Servicetest. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| Modus | Modus, in dem der Servicetest ausgeführt wird. Gültige Werte: * ONDEMAND: Löst den Servicetest manuell aus. * PROAKTIV: Löst den Servicetest automatisch aus. {#servicetestmgmt-GET-serviceTest-id__ul_itl_ksn_xbc} Datentyp: Zeichenfolge Standard: ONDEMAND |
| name | Name des Servicetests. Datentyp: Zeichenfolge |
| ZugehörigService | Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "relatedService": { "href": "String", "id": "String", "name": "String" } |
| RelatedService.ID | SYS_ID oder external_ID des Produktbestands. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| relatedService.name | Name des Produktbestandsartikels. Datentyp: Zeichenfolge |
| startDateTime | Startdatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| Staat | Status des Servicetests. Gültige Werte: * bestätigt * Abgebrochen * Abgeschlossen * Fehlgeschlagen * inProgress * Ausstehend * abgelehnt {#servicetestmgmt-GET-serviceTest-id__ul_prs_txv_xbc} Datentyp: Zeichenfolge |
| Testmessung | Maß für einen bestimmten Aspekt eines Produkt-, Service- oder Ressourcentests, z. B. verlorene Pakete oder Konnektivitätsstatus. Datentyp: Array von Objekten "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] |
| Testmaß.Genauigkeit | Float-Dezimalwert, der die Genauigkeit der Testmessung darstellt, die für die zugehörigen Metriken erfasst wurde. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.captureDateTime | Datum und Uhrzeit der Erfassung der Metrik. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasure.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-GET-serviceTest-id__ul_zrs_txv_xbc} Datentyp: Zeichenfolge |
| TestMeasure.ID | SYS_ID oder external_ID der Testmaßnahme. Datentyp: Zeichenfolge Tabelle: Testmaßnahmen \[sn_st_mgmt_test_measure\] |
| TestMeasure.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasure.metricName | Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation | Objekt zum Definieren einer Regel in der Schwellenwertregeldefinition, zusammen mit Konsequenzen, wenn die Regel verletzt wird. Datentyp: Array von Objekten "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 | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Datentyp: Array von Objekten "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] |
| testMeasure.ruleViolation.appliedConsequence.appliedAction | Aktion, die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Beispiel: Senden einer Warnung oder Generieren eines Berichts. Angewendete Aktionen können zwischen Instanzen variieren. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | Kennzeichnung, die angibt, ob die angewendete Aktion wiederholt werden soll oder nicht. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-GET-serviceTest-id__ul_kss_txv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.appliedConsequence.description | Beschreibung der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.id | SYS_ID oder external_ID der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.name | Name der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem Wert von identisch ist conformanceTargetExact. Gültige Werte: * Wahr: Der Wert ist identisch. * Falsch: Der Wert ist nicht identisch. {#servicetestmgmt-GET-serviceTest-id__ul_uss_txv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComparatorLower | Ein Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * ist {#servicetestmgmt-GET-serviceTest-id__ul_fts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComparatorUpper | Ein Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * ist * Kleiner als {#servicetestmgmt-GET-serviceTest-id__ul_mts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.description | Beschreibung des Verstoßes gegen die Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.id | SYS_ID oder external_ID des Schwellenwertregelverstoßes. Datentyp: Zeichenfolge Tabelle: Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\] |
| testMeasure.ruleViolation.name | Name des Verstoßes gegen die Schwellenwertregel. Datumstyp: Zeichenfolge |
| testMeasure.ruleViolation.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Maximum: 40 |
| testMeasure.ruleViolation.thresholdRuleSeverity | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * niedrig * mittel {#servicetestmgmt-GET-serviceTest-id__ul_tts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.tolerancePeriod | Dauer oder Zeitintervall, in dem zulässige Überschreitungen auftreten können, bevor eine Konsequenz initiiert wird. Datumstyp: Objekt "tolerancePeriod": { "amount": Number, "units": "String" } |
| testMeasure.ruleViolation.tolerancePeriod.amount | Betrag des Zeitraums in Zahl. Datentyp: Zahl |
| testMeasure.ruleViolation.tolerancePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-GET-serviceTest-id__ul_my3_qds_dcc} Datentyp: Zeichenfolge |
| Testmaß.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasure.value | Wert der Metrik im Test. Datentyp: Objekt "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } |
| TestMeasure.value.ID | ID des Metrikwerts im Test. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Metrikwerts im Test. Datentyp: Zeichenfolge |
| TestMeasure.value.value | Wert der Metrik im Test. Datentyp: Zeichenfolge |
| TestMeasure.Wert.WertTyp | Typ des Testmesswerts, z. B. numerisch, Text usw. Datentyp: Zeichenfolge |
| Testspezifikation | Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "testSpecification": { "href": "String", "id": "String" } |
| TestSpecification.href | Hyperlink-Verweis auf die Servicetestdefinition. Datentyp: Zeichenfolge |
| TestSpecification.ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum und Zeitstempel des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Startdatum und Zeitstempel des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

### Curl-Anforderung {#servicetestmgmt-GET-serviceTest-id__example_z5y_hvr_rbc}

Das folgende Beispiel ruft Details zur Servicetestentität ab, die der angegebenen ID zugeordnet ist, 44b7a8ea3b6a42107222bf9985e45a45.

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

Antworttext.

    {
      "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"
                }
              ]
            }
          ]
        }
      ]
    }

## Servicetestmanagement -- offene API -- GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification ab {#ariaid-title4}

Ruft eine Liste aller Servicetestdefinitionen ab.

### URL-Format

Standard-URL: RUFEN SIE die /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification AB

### Unterstützte Anforderungsparameter

{#servicetestmgmt-GET-servTestSpecif__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Pfad-Parameter]

{#servicetestmgmt-GET-servTestSpecif__entry__6}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Wenn dieser Parameter nicht verwendet wird, werden alle Felder zurückgegeben. Befindet sich in der Tabelle „Servicetestdefinition" \[sn_st_mgmt_test_definition\]. Gültige Werte: * Beschreibung * ID * name * ZugehörigServicespezifikation * ServiceTestSpecRelationship * Merkmal * TestMeasureDefinition * ValidiertFür {#servicetestmgmt-GET-servTestSpecif__ul_hss_b3v_bcc} Datentyp: Zeichenfolge |
| limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie offsetParameter zum Paginieren des Datensatzabrufs. Datentyp: Zahl Höchstwert: 100 Standard: 20 |
| Offset | Startindex, bei dem mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Parameter, um Ergebnisse in kleinen und verwaltbaren Blöcken zu paginieren. Der erste Datensatz wird bei 0 indiziert. Datentyp: Zahl Standard: 0 |
| status | Filtern Sie Testdefinitionen nach dem aktuellen Status des Tests. Nur Testdefinitionen im angegebenen Status werden in der Antwort zurückgegeben. Gültige Werte: * archiviert * Entwurf * Veröffentlicht * Stillgelegt Datentyp: Zeichenfolge |
[Tabelle : 15. Abfrageparameter]

{#servicetestmgmt-GET-servTestSpecif__entry__16}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 16. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-GET-servTestSpecif__entry__20}{#servicetestmgmt-GET-servTestSpecif__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 17. Anforderungskopfzeilen.]

{#servicetestmgmt-GET-servTestSpecif__entry__24}

| Header | Beschreibung |
|-|-|
| Inhaltsbereich | Gibt den Bereich der Inhalte an, die in einem paginierten Aufruf zurückgegeben werden. Beispiel: Wenn `Offset=2 `Und `Grenzwert = 3 `, Der Wert des Inhaltsbereichs-Headers ist Elemente `3-5 `. |
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur Anwendung/JSON. |
| Verknüpfen | Enthält die folgenden Links zum Navigieren durch Abfrageergebnisse: * zuerst * letzte * Weiter * previous {#servicetestmgmt-GET-servTestSpecif__ul_acj_pkx_4bc} |
| X-Gesamtzahl | Für paginierte Abfragen gibt dieser Header die Gesamtzahl der auf dem Server verfügbaren Datensätze an. |
[Tabelle : 18. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-GET-servTestSpecif__entry__34}{#servicetestmgmt-GET-servTestSpecif__entry-200-status-code}{#servicetestmgmt-GET-servTestSpecif__entry-400-status-code}{#servicetestmgmt-GET-servTestSpecif__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 206 | In Antwort zurückgegebene Teilressource (mit Paginierung). |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 19. Statuscodes]

### Antworttext-Parameter (JSON oder XML) {#servicetestmgmt-GET-servTestSpecif__section_xvz_1lx_4bc}

{#servicetestmgmt-GET-servTestSpecif__table_yvz_1lx_4bc__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Servicetestdefinition. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
| name | Erforderlich. Name der Servicetestdefinition. Datentyp: Zeichenfolge |
| ZugehörigServicespezifikation | Erforderlich. Servicespezifikationen der Testdefinition. Datentyp: Array von Objekten "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] |
| relatedServiceSpecification.id | SYS_ID oder external_ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Spezifikation" \[sn_prd_pm_specification\]. |
| relatedServiceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship | Zugehörige Servicetestdefinition. Datentyp: Array von Objekten "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] |
| ServiceTestSpecRelationship.ID | SYS_ID oder external_ID der zugehörigen Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Testdefinition \[sn_st_mgmt_test_definition\] |
| serviceTestSpecRelationship.name | Name der zugehörigen Testdefinition. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship.RelationshipType | Typ der Beziehung. Akzeptierte Werte: * Abhängigkeit * Exklusivität * Ersatz {#servicetestmgmt-GET-servTestSpecif__ul_hpg_xtr_dcc} Datentyp: Zeichenfolge |
| Merkmal | Merkmale der Testdefinition. Datentyp: Array von Objekten "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| specCharacteristic.characteristicValueSpecification | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "characteristicValueSpecification": [ { "value": "String" } ] |
| specCharacteristic.characteristicValueSpecification.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Specteristic.validFor | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Specteristic.validFor.endDateTime | Enddatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.validFor.startDateTime | Startdatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.valueType | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-GET-servTestSpecif__ul_i3m_twr_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition | Testmaßdefinitionen für diese Servicetestdefinition. Weitere Informationen finden Sie unter [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "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 | Die Häufigkeit, mit der die Metrik erfasst werden soll. Gültige Werte: * täglich * monatlich * Keine * einmal * wöchentlich {#servicetestmgmt-GET-servTestSpecif__ul_lsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfasst die Metrik nicht. {#servicetestmgmt-GET-servTestSpecif__ul_gsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.capturePeriod | Zeitraum oder Dauer der Metrikerfassung. Datentyp: Objekt "capturePeriod": { "amount": Number, "units": "String" } |
| testMeasureDefinition.capturePeriod.amount | Anzahl der Erfassungszeiträume. Datentyp: Zahl |
| testMeasureDefinition.capturePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-GET-servTestSpecif__ul_rn1_3ds_dcc} Datentyp: Zeichenfolge |
| testMeasureDefinition.id | SYS_ID oder external_ID der Testmaßdefinitionen. Datentyp: Zeichenfolge Tabelle: Testmaßdefinitionstabelle \[sn_st_mgmt_test_measure_definition\] |
| TestMeasureDefinition.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasureDefinition.metricName | Anwenderdefinierter Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasureDefinition.name | Name der Testmaßdefinition. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel | Regel, die Bedingungen definiert, die erreicht werden sollen, bevor Konsequenzen angewendet werden, wenn ein Schwellenwert​in der Testmaßdefinition überschritten (oder nicht überschritten) wird. Weitere Informationen finden Sie unter [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten { "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.threshold.Rule.KonformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem für festgelegten Wert identisch ist testMeasureDefinition.thresholdRule.conformanceTargetExact. Wenn auf „wahr" festgelegt, testMeasureDefinition.thresholdRule.conformanceTargetExactIst erforderlich. Gültige Werte: * Wahr: Der Wert ist identisch mit dem Wert von conformanceTargetExact. * Falsch: Der Wert ist nicht identisch conformanceTargetExact. {#servicetestmgmt-GET-servTestSpecif__ul_bsw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorLower | Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmgmt-GET-servTestSpecif__ul_zrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorOber | Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmgmt-GET-servTestSpecif__ul_wrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceZielLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Regel.Konsequenz | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Weitere Informationen finden Sie unter [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] |
| testMeasureDefinition.thresholdRule.consequence.description | Beschreibung der Konsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.id | SYS_ID oder external_ID der Maßkonsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.name | Name der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel.Konsequenz.vorgeschriebenen Aktion | Anwenderdefinierte Aktion für Schwellenwertverstöße. Aktionen variieren zwischen Instanzen. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.wiederholte Aktion | Kennzeichnung, die angibt, ob die angewendete Konsequenz wiederholt werden soll. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-GET-servTestSpecif__ul_srw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor | Datumsbereich, für den die Konsequenz gültig ist. Datentyp: Objekt "validFor": { "startDateTime": "String", "endDateTime ": "String" } |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.endDateTime | Gültigkeitsenddatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.startDateTime | Gültigkeitsstartdatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasureDefinition.thresholdRule.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.id | SYS_ID oder external_ID der Schwellenwertregeln. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Schwellenwertregeln" \[sn_st_mgmt_threshold_rule\]. |
| testMeasureDefinition.thresholdRule.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| TestMeasureDefinition.threshold-Regel.threshold-Regelschweregrad | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmgmt-GET-servTestSpecif__ul_orw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasureDefinition.validFür | Datumsbereich, für den die Testmaßdefinition gültig ist. Datentyp: Zeichenfolge "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| TestMeasureDefinition.validFor.endDateTime | Gültigkeitsenddatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.validFor.startDateTime | Gültigkeitsstartdatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidiertFür | Datumsbereich, für den die Testdefinition gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Datum und Uhrzeit der Testdefinition, zu der der Status der Definition stillgelegt wird. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Datum und Uhrzeit der Testdefinition, an der der Status veröffentlicht wird. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

{#servicetestmgmt-GET-servTestSpecif__table_yvz_1lx_4bc}  

### Curl-Anforderung

Dieses Beispiel ruft Details zu allen Testservice-Testdefinitionen in der Instanz ab. In diesem Fall werden zwei Definitionen zurückgegeben.

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

Antworttext.

    [
      {
        "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"
          }
        ]
      }
    ]

## Servicetestmanagement -- offene API -- GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{ID} AB {#ariaid-title5}

Ruft eine Servicetest-Definitionsentität ab.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{ID}

### Unterstützte Anforderungsparameter

{#servicetestmanagement-GET-id__entry__2}

| Name | Beschreibung |
|-|-|
| id | SYS_ID oder external_ID der abzurufenden Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
[Tabelle : 20. Pfad-Parameter]

{#servicetestmanagement-GET-id__entry__6}

| Name | Beschreibung |
|-|-|
| Felder | Liste der Felder, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert. Wenn dieser Parameter nicht verwendet wird, werden alle Felder zurückgegeben. Befindet sich in der Tabelle „Servicetestdefinition" \[sn_st_mgmt_test_definition\]. Gültige Werte: * Beschreibung * ID * name * ZugehörigServicespezifikation * ServiceTestSpecRelationship * Merkmal * TestMeasureDefinition * ValidiertFür {#servicetestmanagement-GET-id__ul_hss_b3v_bcc} Datentyp: Zeichenfolge |
| status | Filtern Sie Testdefinitionen nach dem aktuellen Status des Tests. Nur Testdefinitionen im angegebenen Status werden in der Antwort zurückgegeben. Gültige Werte: * archiviert * Entwurf * Veröffentlicht * Stillgelegt Datentyp: Zeichenfolge |
[Tabelle : 21. Abfrageparameter]

{#servicetestmanagement-GET-id__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 22. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmanagement-GET-id__entry__16}{#servicetestmanagement-GET-id__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 23. Anforderungskopfzeilen.]

{#servicetestmanagement-GET-id__entry__20}{#servicetestmanagement-GET-id__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 24. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmanagement-GET-id__entry__24}{#servicetestmanagement-GET-id__entry-200-status-code}{#servicetestmanagement-GET-id__entry-400-status-code}{#servicetestmanagement-GET-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 25. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#servicetestmanagement-GET-id__entry__32}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Servicetestdefinition. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
| name | Erforderlich. Name der Servicetestdefinition. Datentyp: Zeichenfolge |
| ZugehörigServicespezifikation | Erforderlich. Servicespezifikationen der Testdefinition. Datentyp: Array von Objekten "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] |
| relatedServiceSpecification.id | SYS_ID oder external_ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Spezifikation" \[sn_prd_pm_specification\]. |
| relatedServiceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship | Zugehörige Servicetestdefinition. Datentyp: Array von Objekten "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] |
| ServiceTestSpecRelationship.ID | SYS_ID oder external_ID der zugehörigen Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Testdefinition \[sn_st_mgmt_test_definition\] |
| serviceTestSpecRelationship.name | Name der zugehörigen Testdefinition. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship.RelationshipType | Typ der Beziehung. Akzeptierte Werte: * Abhängigkeit * Exklusivität * Ersatz {#servicetestmanagement-GET-id__ul_hpg_xtr_dcc} Datentyp: Zeichenfolge |
| Merkmal | Merkmale der Testdefinition. Datentyp: Array von Objekten "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| specCharacteristic.characteristicValueSpecification | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "characteristicValueSpecification": [ { "value": "String" } ] |
| specCharacteristic.characteristicValueSpecification.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Specteristic.validFor | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Specteristic.validFor.endDateTime | Enddatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.validFor.startDateTime | Startdatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.valueType | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmanagement-GET-id__ul_i3m_twr_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition | Testmaßdefinitionen für diese Servicetestdefinition. Weitere Informationen finden Sie unter [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "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 | Die Häufigkeit, mit der die Metrik erfasst werden soll. Gültige Werte: * täglich * monatlich * Keine * einmal * wöchentlich {#servicetestmanagement-GET-id__ul_lsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfasst die Metrik nicht. {#servicetestmanagement-GET-id__ul_gsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.capturePeriod | Zeitraum oder Dauer der Metrikerfassung. Datentyp: Objekt "capturePeriod": { "amount": Number, "units": "String" } |
| testMeasureDefinition.capturePeriod.amount | Anzahl der Erfassungszeiträume. Datentyp: Zahl |
| testMeasureDefinition.capturePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmanagement-GET-id__ul_rn1_3ds_dcc} Datentyp: Zeichenfolge |
| testMeasureDefinition.id | SYS_ID oder external_ID der Testmaßdefinitionen. Datentyp: Zeichenfolge Tabelle: Testmaßdefinitionstabelle \[sn_st_mgmt_test_measure_definition\] |
| TestMeasureDefinition.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasureDefinition.metricName | Anwenderdefinierter Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasureDefinition.name | Name der Testmaßdefinition. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel | Regel, die Bedingungen definiert, die erreicht werden sollen, bevor Konsequenzen angewendet werden, wenn ein Schwellenwert​in der Testmaßdefinition überschritten (oder nicht überschritten) wird. Weitere Informationen finden Sie unter [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten { "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.threshold.Rule.KonformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem für festgelegten Wert identisch ist testMeasureDefinition.thresholdRule.conformanceTargetExact. Wenn auf „wahr" festgelegt, testMeasureDefinition.thresholdRule.conformanceTargetExactIst erforderlich. Gültige Werte: * Wahr: Der Wert ist identisch mit dem Wert von conformanceTargetExact. * Falsch: Der Wert ist nicht identisch conformanceTargetExact. {#servicetestmanagement-GET-id__ul_bsw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorLower | Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmanagement-GET-id__ul_zrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorOber | Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmanagement-GET-id__ul_wrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceZielLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Regel.Konsequenz | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Weitere Informationen finden Sie unter [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] |
| testMeasureDefinition.thresholdRule.consequence.description | Beschreibung der Konsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.id | SYS_ID oder external_ID der Maßkonsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.name | Name der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel.Konsequenz.vorgeschriebenen Aktion | Anwenderdefinierte Aktion für Schwellenwertverstöße. Aktionen variieren zwischen Instanzen. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.wiederholte Aktion | Kennzeichnung, die angibt, ob die angewendete Konsequenz wiederholt werden soll. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmanagement-GET-id__ul_srw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor | Datumsbereich, für den die Konsequenz gültig ist. Datentyp: Objekt "validFor": { "startDateTime": "String", "endDateTime ": "String" } |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.endDateTime | Gültigkeitsenddatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.startDateTime | Gültigkeitsstartdatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasureDefinition.thresholdRule.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.id | SYS_ID oder external_ID der Schwellenwertregeln. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Schwellenwertregeln" \[sn_st_mgmt_threshold_rule\]. |
| testMeasureDefinition.thresholdRule.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| TestMeasureDefinition.threshold-Regel.threshold-Regelschweregrad | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmanagement-GET-id__ul_orw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasureDefinition.validFür | Datumsbereich, für den die Testmaßdefinition gültig ist. Datentyp: Zeichenfolge "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| TestMeasureDefinition.validFor.endDateTime | Gültigkeitsenddatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.validFor.startDateTime | Gültigkeitsstartdatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidiertFür | Datumsbereich, für den die Testdefinition gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Datum und Uhrzeit der Testdefinition, zu der der Status der Definition stillgelegt wird. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Datum und Uhrzeit der Testdefinition, an der der Status veröffentlicht wird. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

### Curl-Anforderung

Dieses Beispiel ruft Details einer Servicetestdefinition mit einer bestimmten ID ab.

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

Antworttext.

    {
      "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"
        }
      ]
    }

## Servicetestmanagement -- offene API -- PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTest/{ID} {#ariaid-title6}

Aktualisiert eine Servicetest-Entität.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{ID}

### Unterstützte Anforderungsparameter

{#servicetestmgmt-PATCH-serviceTestid__entry__2}

| Name | Beschreibung |
|-|-|
| id | SYS_ID oder external_ID des abzurufenden Servicetests. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
[Tabelle : 26. Pfad-Parameter]

{#servicetestmgmt-PATCH-serviceTestid__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 27. Abfrageparameter]

{#servicetestmgmt-PATCH-serviceTestid__entry__10}

| Name | Beschreibung |
|-|-|
| Merkmal | Liste, die die Merkmale des zugehörigen Servicetests beschreibt. Weitere Informationen zu Testdefinitionsmerkmalen finden Sie unter Datentyp: Array von Objekten "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] |
| characteristic.id | SYS_ID oder external_ID von Merkmalen. Wenn „external_ID" für diesen Datensatz vorhanden ist, gibt die Antwort die „external_ID" zurück, andernfalls wird die sys_ID zurückgegeben Datentyp: Zeichenfolge Tabelle: Merkmale \[sn_prd_pm_characteristic\] |
| characteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Merkmal.Wert | Merkmalsoptionen, die dem Servicetest zugeordnet sind. Merkmale variieren je nach Kundeninstanz. Datentyp: Zeichenfolge |
| Merkmal.WertTyp | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-PATCH-serviceTestid__ul_zfr_twr_dcc} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Servicetests. Datentyp: Zeichenfolge |
| endDateTime | Enddatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| Modus | Modus, in dem der Servicetest ausgeführt wird. Gültige Werte: * ONDEMAND: Löst den Servicetest manuell aus. * PROAKTIV: Löst den Servicetest automatisch aus. {#servicetestmgmt-PATCH-serviceTestid__ul_ybc_mqn_xbc} Datentyp: Zeichenfolge Standard: ONDEMAND |
| name | Erforderlich. Name des Servicetests. Datentyp: Zeichenfolge |
| ZugehörigService | Erforderlich. Testdefinition, die dem Servicetest zugeordnet ist. Datentyp: Objekt "relatedService": { "href": "String", "id": "String", "name": "String" } |
| RelatedService.href | Hyperlink-Verweis auf den zugehörigen Service. Datentyp: Zeichenfolge |
| relatedService.id | SYS_ID oder external_ID des Produktbestands. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| startDateTime | Startdatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| Staat | Status, in dem sich der Servicetest befindet. Gültige Werte: * bestätigt * Abgebrochen * Abgeschlossen * Fehlgeschlagen * inProgress * Ausstehend * abgelehnt {#servicetestmgmt-PATCH-serviceTestid__ul_gym_mqn_xbc} Datentyp: Zeichenfolge |
| Testmessung | Maß für einen bestimmten Aspekt eines Produkt-, Service- oder Ressourcentests, z. B. verlorene Pakete oder Konnektivitätsstatus. Datentyp: Array von Objekten "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] |
| Testmaß.Genauigkeit | Float-Dezimalwert, der die Genauigkeit der Testmessung darstellt, die für die zugehörigen Metriken erfasst wurde. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.captureDateTime | Datum und Uhrzeit der Erfassung der Metrik. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasure.id | SYS_ID oder external_ID der Testmaßnahmen. Datentyp: Zeichenfolge Tabelle: In den Feldern „sys_ID" oder „external_ID" der Tabelle „Testmaßnahmen" \[sn_st_mgmt_test_measure\]. |
| testMeasure.Measure.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-PATCH-serviceTestid__ul_ed2_gxv_xbc} Datentyp: Zeichenfolge |
| TestMeasure.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasure.metricName | Name der Testmaßmetrik. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation | Ein Objekt zum Definieren einer Regel in der Schwellenwertregeldefinition, zusammen mit Konsequenzen, wenn die Regel verletzt wird. Datentyp: Array von Objekten "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] |
| testMeasure.ruleViolation.tolerancePeriod.amount | Anzahl der Zeiträume, bevor die Konsequenz angewendet wird. Datentyp: Zahl |
| testMeasure.ruleViolation.appliedConsequence | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Datentyp: Array von Objekten "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] |
| testMeasure.ruleViolation.appliedConsequence.appliedAction | Aktion, die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Beispiel: Senden einer Warnung oder Generieren eines Berichts. Angewendete Aktionen können zwischen Instanzen variieren. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.description | Beschreibung der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.id | SYS_ID oder external_ID der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.name | Name der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.repeatAction | Kennzeichnung, die angibt, ob die Konsequenz wiederholt werden soll, wenn ein zweiter Verstoß auftritt. Gültige Werte: * Wahr: Wiederholen Sie die Aktion. * Falsch: Wiederholen Sie die Aktion nicht. {#servicetestmgmt-PATCH-serviceTestid__ul_ld2_gxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComporatorExact | Kennzeichnung, die angibt, ob ein Wert identisch ist. Gültige Werte: * Wahr: Der Wert ist identisch. * Falsch: Der Wert ist nicht identisch. {#servicetestmgmt-PATCH-serviceTestid__ul_od2_gxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComporatorLower | Operator zum Überprüfen, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmgmt-PATCH-serviceTestid__ul_sd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComporatorUpper | Operator zum Überprüfen, ob ein Wert über dem Schwellenwert liegt. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmgmt-PATCH-serviceTestid__ul_vd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.id | SYS_ID oder external_ID des Schwellenwertregelverstoßes. Datentyp: Zeichenfolge Tabelle: Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\] |
| testMeasure.ruleViolation.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.ruleViolation.thresholdRuleSeverity | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmgmt-PATCH-serviceTestid__ul_xd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.tolerancePeriod | Angegebenes Zeitintervall, in dem das Überschreiten von Vorkommen aktiviert wird, ohne unmittelbare Konsequenzen oder Aktionen auszulösen. Datumstyp: Objekt "tolerancePeriod": { "amount": Number, "units": "String" } |
| testMeasure.ruleViolation.tolerancePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-PATCH-serviceTestid__ul_qbw_qds_dcc} Datentyp: Zeichenfolge |
| Testmaß.EinheitenMessung | Maßeinheit für die Konformitätszielwerte der Testmessung. Datentyp: Zeichenfolge |
| TestMeasure.value | Wert der Testmaßnahme. Datentyp: Objekt "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } |
| testMeasure.value.id | ID des Testmesswerts. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Testmesswerts. Datentyp: Zeichenfolge |
| TestMeasure.value.value | Wert der Testmaßnahme. Datentyp: Zeichenfolge |
| TestMeasure.Wert.WertTyp | Typ des Testmesswerts, z. B. numerisch, Text usw. Datentyp: Zeichenfolge |
| Testspezifikation | Erforderlich. Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "testSpecification": { "href": "String", "id": "String" } |
| TestSpecification.href | Hyperlink-Verweis auf die Servicetestdefinition. Datentyp: Zeichenfolge |
| testSpecification.id | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicetestdefinition" \[sn_st_mgmt_test_definition\]. |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime ": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Gültigkeitsenddatum des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Gültigkeitsstartdatum des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[Tabelle : 28. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-PATCH-serviceTestid__entry__120}{#servicetestmgmt-PATCH-serviceTestid__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 29. Anforderungskopfzeilen.]

{#servicetestmgmt-PATCH-serviceTestid__entry__124}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 30. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-PATCH-serviceTestid__entry__128}{#servicetestmgmt-PATCH-serviceTestid__entry-200-status-code}{#servicetestmgmt-PATCH-serviceTestid__entry-400-status-code}{#servicetestmgmt-PATCH-serviceTestid__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 31. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#servicetestmgmt-PATCH-serviceTestid__entry__136}

| Name | Beschreibung |
|-|-|
| Merkmal | Liste, die die Merkmale des zugehörigen Servicetests beschreibt. Datentyp: Array von Objekten "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] |
| Merkmal.ID | SYS_ID oder external_ID von Merkmalen. Wenn „external_ID" für diesen Datensatz vorhanden ist, gibt die Antwort die „external_ID" zurück, andernfalls wird die sys_ID zurückgegeben Datentyp: Zeichenfolge Tabelle: Merkmale \[sn_prd_pm_characteristic\] |
| characteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Merkmal.Wert | Merkmalsoptionen, die dem Servicetest zugeordnet sind. Merkmale variieren je nach Kundeninstanz. Datentyp: Zeichenfolge |
| Merkmal.WertTyp | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Servicetests. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| name | Name des Servicetests. Datentyp: Zeichenfolge |
| ZugehörigService | Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "relatedService": { "href": "string", "id": "String", "name": "String" } |
| RelatedService.ID | SYS_ID oder external_ID des Produktbestands. Datentyp: Zeichenfolge Tabelle: Produktbestand \[sn_prd_invt_product_inventory\] |
| relatedService.name | Name des Produktbestands. Datentyp: Zeichenfolge |
| Testmessung | Maß für einen bestimmten Aspekt eines Produkt-, Service- oder Ressourcentests, z. B. verlorene Pakete oder Konnektivitätsstatus. Datentyp: Array von Objekten "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] |
| Testmaß.Genauigkeit | Float-Dezimalwert, der die Genauigkeit der Testmessung darstellt, die für die zugehörigen Metriken erfasst wurde. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.captureDateTime | Datum und Uhrzeit der Erfassung der Metrik. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasure.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-PATCH-serviceTestid__ul_zrs_txv_xbc} Datentyp: Zeichenfolge |
| TestMeasure.ID | SYS_ID oder external_ID der Testmaßnahme. Datentyp: Zeichenfolge Tabelle: Testmaßnahmen \[sn_st_mgmt_test_measure\] |
| TestMeasure.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasure.metricName | Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation | Objekt zum Definieren einer Regel in der Schwellenwertregeldefinition, zusammen mit Konsequenzen, wenn die Regel verletzt wird. Datentyp: Array von Objekten "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 | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Datentyp: Array von Objekten "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] |
| testMeasure.ruleViolation.appliedConsequence.appliedAction | Aktion, die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Beispiel: Senden einer Warnung oder Generieren eines Berichts. Angewendete Aktionen können zwischen Instanzen variieren. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | Kennzeichnung, die angibt, ob die angewendete Aktion wiederholt werden soll oder nicht. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-PATCH-serviceTestid__ul_kss_txv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.appliedConsequence.description | Beschreibung der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.id | SYS_ID oder external_ID der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.name | Name der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem Wert von identisch ist conformanceTargetExact. Gültige Werte: * Wahr: Der Wert ist identisch. * Falsch: Der Wert ist nicht identisch. {#servicetestmgmt-PATCH-serviceTestid__ul_uss_txv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComparatorLower | Ein Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * ist {#servicetestmgmt-PATCH-serviceTestid__ul_fts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComparatorUpper | Ein Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * ist * Kleiner als {#servicetestmgmt-PATCH-serviceTestid__ul_mts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.description | Beschreibung des Verstoßes gegen die Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.id | SYS_ID oder external_ID des Schwellenwertregelverstoßes. Datentyp: Zeichenfolge Tabelle: Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\] |
| testMeasure.ruleViolation.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Maximum: 40 |
| testMeasure.ruleViolation.thresholdRuleSeverity | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * niedrig * mittel {#servicetestmgmt-PATCH-serviceTestid__ul_tts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.tolerancePeriod | Dauer oder Zeitintervall, in dem zulässige Überschreitungen auftreten können, bevor eine Konsequenz initiiert wird. Datumstyp: Objekt "tolerancePeriod": { "amount": Number, "units": "String" } |
| testMeasure.ruleViolation.tolerancePeriod.amount | Betrag des Zeitraums in Zahl. Datentyp: Zahl |
| testMeasure.ruleViolation.tolerancePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-PATCH-serviceTestid__ul_my3_qds_dcc} Datentyp: Zeichenfolge |
| Testmaß.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasure.value | Wert der Metrik im Test. Datentyp: Objekt "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } |
| TestMeasure.value.ID | ID des Metrikwerts im Test. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Metrikwerts im Test. Datentyp: Zeichenfolge |
| TestMeasure.value.value | Wert der Metrik im Test. Datentyp: Zeichenfolge |
| TestMeasure.Wert.WertTyp | Typ des Testmesswerts, z. B. numerisch, Text usw. Datentyp: Zeichenfolge |
| Testspezifikation | Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "testSpecification": { "href": "String", "id": "String" } |
| TestSpecification.href | Hyperlink-Verweis auf die Servicetestdefinition. Datentyp: Zeichenfolge |
| TestSpecification.ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum und Zeitstempel des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Startdatum und Zeitstempel des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

### Curl-Anforderung

Das folgende Beispiel aktualisiert die angegebene Servicetest-Entität gemäß den im Anforderungstext angegebenen Details.

    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"
                }
              ]
            }
          ]
        }
      ]
    }

Die Antwort zeigt eine erfolgreiche Aktualisierung an, indem die geänderten Informationen im angegebenen Testservice zurückgegeben werden.

    {
      "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"
                }
              ]
            }
          ]
        }
      ]
    }

## Servicetestmanagement -- offene API -- PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{ID} {#ariaid-title7}

Ermöglicht teilweise Aktualisierungen einer Servicetestdefinitionsentität.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{ID}

### Unterstützte Anforderungsparameter

{#servicetestmgmt-PATCH-servTestSp-id__entry__2}

| Name | Beschreibung |
|-|-|
| id | SYS_ID oder external_ID der abzurufenden Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
[Tabelle : 32. Pfad-Parameter]

{#servicetestmgmt-PATCH-servTestSp-id__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 33. Abfrageparameter]

{#servicetestmgmt-PATCH-servTestSp-id__entry__10}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Servicetestdefinition. Datentyp: Zeichenfolge |
| name | Erforderlich. Name der Servicetestdefinition. Datentyp: Zeichenfolge |
| ZugehörigServicespezifikation | Erforderlich. Servicespezifikationen der Testdefinition. Datentyp: Array von Objekten "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] |
| relatedServiceSpecification.id | SYS_ID oder external_ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Spezifikation" \[sn_prd_pm_specification\]. |
| relatedServiceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship | Zugehörige Servicetestdefinition. Datentyp: Array von Objekten "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] |
| ServiceTestSpecRelationship.ID | SYS_ID oder external_ID der zugehörigen Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Testdefinition \[sn_st_mgmt_test_definition\] |
| serviceTestSpecRelationship.name | Name der zugehörigen Testdefinition. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship.RelationshipType | Typ der Beziehung. Akzeptierte Werte: * Abhängigkeit * Exklusivität * Ersatz {#servicetestmgmt-PATCH-servTestSp-id__ul_hpg_xtr_dcc} Datentyp: Zeichenfolge |
| Merkmal | Merkmale der Testdefinition. Datentyp: Array von Objekten "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| specCharacteristic.characteristicValueSpecification | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "characteristicValueSpecification": [ { "value": "String" } ] |
| specCharacteristic.characteristicValueSpecification.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Specteristic.validFor | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Specteristic.validFor.endDateTime | Enddatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.validFor.startDateTime | Startdatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.valueType | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-PATCH-servTestSp-id__ul_i3m_twr_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition | Testmaßdefinitionen für diese Servicetestdefinition. Weitere Informationen finden Sie unter [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "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 | Die Häufigkeit, mit der die Metrik erfasst werden soll. Gültige Werte: * täglich * monatlich * Keine * einmal * wöchentlich {#servicetestmgmt-PATCH-servTestSp-id__ul_lsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfasst die Metrik nicht. {#servicetestmgmt-PATCH-servTestSp-id__ul_gsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.capturePeriod | Zeitraum oder Dauer der Metrikerfassung. Datentyp: Objekt "capturePeriod": { "amount": Number, "units": "String" } |
| testMeasureDefinition.capturePeriod.amount | Anzahl der Erfassungszeiträume. Datentyp: Zahl |
| testMeasureDefinition.capturePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-PATCH-servTestSp-id__ul_rn1_3ds_dcc} Datentyp: Zeichenfolge |
| testMeasureDefinition.id | SYS_ID oder external_ID der Testmaßdefinitionen. Datentyp: Zeichenfolge Tabelle: Testmaßdefinitionstabelle \[sn_st_mgmt_test_measure_definition\] |
| TestMeasureDefinition.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasureDefinition.metricName | Anwenderdefinierter Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasureDefinition.name | Name der Testmaßdefinition. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel | Regel, die Bedingungen definiert, die erreicht werden sollen, bevor Konsequenzen angewendet werden, wenn ein Schwellenwert​in der Testmaßdefinition überschritten (oder nicht überschritten) wird. Weitere Informationen finden Sie unter [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten { "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.threshold.Rule.KonformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem für festgelegten Wert identisch ist testMeasureDefinition.thresholdRule.conformanceTargetExact. Wenn auf „wahr" festgelegt, testMeasureDefinition.thresholdRule.conformanceTargetExactIst erforderlich. Gültige Werte: * Wahr: Der Wert ist identisch mit dem Wert von conformanceTargetExact. * Falsch: Der Wert ist nicht identisch conformanceTargetExact. {#servicetestmgmt-PATCH-servTestSp-id__ul_bsw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorLower | Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmgmt-PATCH-servTestSp-id__ul_zrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorOber | Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmgmt-PATCH-servTestSp-id__ul_wrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceZielLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Regel.Konsequenz | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Weitere Informationen finden Sie unter [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] |
| testMeasureDefinition.thresholdRule.consequence.description | Beschreibung der Konsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.id | SYS_ID oder external_ID der Maßkonsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.name | Name der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel.Konsequenz.vorgeschriebenen Aktion | Anwenderdefinierte Aktion für Schwellenwertverstöße. Aktionen variieren zwischen Instanzen. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.wiederholte Aktion | Kennzeichnung, die angibt, ob die angewendete Konsequenz wiederholt werden soll. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-PATCH-servTestSp-id__ul_srw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor | Datumsbereich, für den die Konsequenz gültig ist. Datentyp: Objekt "validFor": { "startDateTime": "String", "endDateTime ": "String" } |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.endDateTime | Gültigkeitsenddatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.startDateTime | Gültigkeitsstartdatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasureDefinition.thresholdRule.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.id | SYS_ID oder external_ID der Schwellenwertregeln. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Schwellenwertregeln" \[sn_st_mgmt_threshold_rule\]. |
| testMeasureDefinition.thresholdRule.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| TestMeasureDefinition.threshold-Regel.threshold-Regelschweregrad | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmgmt-PATCH-servTestSp-id__ul_orw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasureDefinition.validFür | Datumsbereich, für den die Testmaßdefinition gültig ist. Datentyp: Zeichenfolge "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| TestMeasureDefinition.validFor.endDateTime | Gültigkeitsenddatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.validFor.startDateTime | Gültigkeitsstartdatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[Tabelle : 34. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-PATCH-servTestSp-id__entry__118}{#servicetestmgmt-PATCH-servTestSp-id__accept-RESTAPI}{#servicetestmgmt-PATCH-servTestSp-id__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 35. Anforderungskopfzeilen.]

{#servicetestmgmt-PATCH-servTestSp-id__entry__124}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur Anwendung/JSON. |
[Tabelle : 36. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-PATCH-servTestSp-id__entry__128}{#servicetestmgmt-PATCH-servTestSp-id__entry-200-status-code}{#servicetestmgmt-PATCH-servTestSp-id__entry-400-status-code}{#servicetestmgmt-PATCH-servTestSp-id__entry-404-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
[Tabelle : 37. Statuscodes]

### Antworttext-Parameter (JSON oder XML) {#servicetestmgmt-PATCH-servTestSp-id__section_h1m_wz4_qbc}

{#servicetestmgmt-PATCH-servTestSp-id__table_i1m_wz4_qbc__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Servicetestdefinition. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| name | Name der Servicetestdefinition. Datentyp: Zeichenfolge |
| ZugehörigServicespezifikation | Servicespezifikationen für die Testdefinitionen. Datentyp: Array von Objekten "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] |
| RelatedServicespezifikation.ID | SYS_ID oder external_ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Spezifikation" \[sn_prd_pm_specification\]. |
| relatedServiceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship | Zugehörige Servicetestdefinition. Datentyp: Array von Objekten "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] |
| ServiceTestSpecRelationship.ID | SYS_ID oder external_ID der zugehörigen Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Testdefinition \[sn_st_mgmt_test_definition\] |
| serviceTestSpecRelationship.name | Name der zugehörigen Testdefinition. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship.RelationshipType | Typ der Beziehung. Akzeptierte Werte: * Abhängigkeit * Exklusivität * Ersatz {#servicetestmgmt-PATCH-servTestSp-id__d4502e2410} Datentyp: Zeichenfolge |
| Merkmal | Testdefinitionsmerkmale. Datentyp: Array von Objekten "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| specCharacteristic.characteristicValueSpecification | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "characteristicValueSpecification": [ { "value": "String" } ] |
| specCharacteristic.characteristicValueSpecification.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Specteristic.validFor | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Specteristic.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| SpecCharacteristic.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| SpecCharacteristic.valueType | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-PATCH-servTestSp-id__ul_uwb_5wr_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition | Testmaßdefinitionen für diese Servicetestdefinition. Weitere Informationen finden Sie unter [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "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 | Häufigkeit, mit der die Metrik erfasst werden soll. Gültige Werte: * täglich * monatlich * Keine * einmal * wöchentlich {#servicetestmgmt-PATCH-servTestSp-id__ul_od2_sxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-PATCH-servTestSp-id__ul_rd2_sxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.capturePeriod | Dauer oder Zeitraum der Erfassung. Datentyp: Objekt "capturePeriod": { "amount": Number, "units": "String" } |
| testMeasureDefinition.capturePeriod.amount | Anzahl der Erfassungszeiträume. Datentyp: Zahl |
| testMeasureDefinition.capturePeriod.units | Einheiten des Zeitraums. Akzeptierte Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-PATCH-servTestSp-id__ul_lfv_dds_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.ID | SYS_ID oder external_ID der Testmaßdefinitionen. Datentyp: Zeichenfolge Tabelle: Testmaßdefinition \[sn_st_mgmt_test_measure_definition\] |
| TestMeasureDefinition.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasureDefinition.metricName | Anwenderdefinierter Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasureDefinition.name | Name der Testmaßdefinition. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel | Regel, die die Bedingung (erhöhen oder löschen) definiert, um Konsequenzen anzuwenden, wenn ein Schwellenwert​für eine bestimmte Testmaßdefinition überschritten wird oder nicht mehr überschritten wird. Datentyp: Array von Objekten { "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.threshold.Rule.KonformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem Wert von identisch ist conformanceTargetExact. Gültige Werte: * Wahr: Der Wert ist identisch mit dem Wert von conformanceTargetExact. * Falsch: Der Wert ist nicht identisch conformanceTargetExact. {#servicetestmgmt-PATCH-servTestSp-id__ul_gyl_vqr_dcc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorLower | Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * ist {#servicetestmgmt-PATCH-servTestSp-id__ul_b22_sxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorOber | Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * Kleiner als * ist {#servicetestmgmt-PATCH-servTestSp-id__ul_e22_sxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceZielLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Regel.Konsequenz | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Datentyp: Array von Objekten "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] |
| testMeasureDefinition.thresholdRule.consequence.description | Beschreibung der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.ID | SYS_ID oder external_ID der Maßkonsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.name | Name der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel.Konsequenz.vorgeschriebenen Aktion | Anwenderdefinierte Aktion für Schwellenwertverstöße. Aktionen variieren zwischen Instanzen. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.wiederholte Aktion | Kennzeichnung, die angibt, ob die angewendete Aktion wiederholt werden soll oder nicht. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-PATCH-servTestSp-id__ul_rjm_pxy_rbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor | Datumsbereich, für den die Konsequenz gültig ist. Datentyp: Objekt "validFor": { "startDateTime": "String", "endDateTime ": "String" } |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.endDateTime | Gültigkeitsenddatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.startDateTime | Gültigkeitsstartdatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasureDefinition.thresholdRule.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.ID | SYS_ID oder external_ID der Schwellenwertregeln. Datentyp: Zeichenfolge Tabelle: Schwellenwertregeln \[sn_st_mgmt_threshold_rule\] |
| testMeasureDefinition.thresholdRule.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| TestMeasureDefinition.threshold-Regel.threshold-Regelschweregrad | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * niedrig * mittel {#servicetestmgmt-PATCH-servTestSp-id__ul_j22_sxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasureDefinition.validFür | Datumsbereich, für den die Testmaßdefinition gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| TestMeasureDefinition.validFor.endDateTime | Gültigkeitsenddatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.validFor.startDateTime | Gültigkeitsstartdatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

{#servicetestmgmt-PATCH-servTestSp-id__table_i1m_wz4_qbc}  

### Curl-Anforderung

Das folgende Beispiel aktualisiert die angegebene Servicetestdefinitions-ID gemäß den im Anforderungstext angegebenen Änderungen teilweise.

    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"
        }
      ]
    }

Der Antworttext gibt den aktualisierten Teil der Servicetestspezifikation zurück:

    {
      "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"
        }
      ]
    }

## Servicetestmanagement -- offene API -- POST /sn_sprb_mgmt/servicetestmanagement/serviceTest {#ariaid-title8}

Erstellt einen Servicetest.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTest

### Unterstützte Anforderungsparameter

{#servicetestmgmt-POST-serviceTest__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 38. Pfad-Parameter]

{#servicetestmgmt-POST-serviceTest__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 39. Abfrageparameter]

{#servicetestmgmt-POST-serviceTest__id_q31_zd1_qbc__entry__2}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.valueType}{#servicetestmgmt-POST-serviceTest__serviceTest-request-description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-endDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-mode}{#servicetestmgmt-POST-serviceTest__serviceTest-request-name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.href}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-startDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-state}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.accuracy}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.captureDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.captureMethod}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.metricDescription}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.metricName}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.appliedAction}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.repeatAction}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorExact}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorLower}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorUpper}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetExact}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetLower}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetUpper}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-test.Measure.ruleViolation.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.numberOfAllowedCrossing}{#servicetestmgmt-POST-serviceTest__serviceTest-request-estMeasure.ruleViolation.thresholdRuleSeverity}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.tolerancePeriod}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.amount}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.tolerancePeriod.units}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.unitOfMeasure}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.valueType}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification.href}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor.endDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor.startDateTime}

| Name | Beschreibung |
|-|-|
| Merkmal | Liste, die die Merkmale des zugehörigen Servicetests beschreibt. Weitere Informationen zu Testdefinitionsmerkmalen finden Sie unter Datentyp: Array von Objekten "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] |
| characteristic.id | SYS_ID oder external_ID von Merkmalen. Wenn „external_ID" für diesen Datensatz vorhanden ist, gibt die Antwort die „external_ID" zurück, andernfalls wird die sys_ID zurückgegeben Datentyp: Zeichenfolge Tabelle: Merkmale \[sn_prd_pm_characteristic\] |
| characteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Merkmal.Wert | Merkmalsoptionen, die dem Servicetest zugeordnet sind. Merkmale variieren je nach Kundeninstanz. Datentyp: Zeichenfolge |
| Merkmal.WertTyp | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-POST-serviceTest__ul_zfr_twr_dcc} Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Servicetests. Datentyp: Zeichenfolge |
| endDateTime | Enddatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ID | SYS_ID oder external_ID des Servicetests. Diese ID erstellt einen Servicetest und wird als external_ID verwendet Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| Modus | Modus, in dem der Servicetest ausgeführt wird. Gültige Werte: * ONDEMAND: Löst den Servicetest manuell aus. * PROAKTIV: Löst den Servicetest automatisch aus. {#servicetestmgmt-POST-serviceTest__ul_ybc_mqn_xbc} Datentyp: Zeichenfolge Standard: ONDEMAND |
| name | Erforderlich. Name des Servicetests. Datentyp: Zeichenfolge |
| ZugehörigService | Erforderlich. Testdefinition, die dem Servicetest zugeordnet ist. Datentyp: Objekt "relatedService": { "href": "String", "id": "String", "name": "String" } |
| RelatedService.href | Hyperlink-Verweis auf den zugehörigen Service. Datentyp: Zeichenfolge |
| relatedService.id | SYS_ID oder external_ID des Produktbestands. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Produktbestand" \[sn_prd_invt_product_inventory\]. |
| relatedService.name | Name des Produktbestandsartikels. Datentyp: Zeichenfolge |
| startDateTime | Startdatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| Staat | Status, in dem sich der Servicetest befindet. Gültige Werte: * bestätigt * Abgebrochen * Abgeschlossen * Fehlgeschlagen * inProgress * Ausstehend * abgelehnt {#servicetestmgmt-POST-serviceTest__ul_gym_mqn_xbc} Datentyp: Zeichenfolge |
| Testmessung | Maß für einen bestimmten Aspekt eines Produkt-, Service- oder Ressourcentests, z. B. verlorene Pakete oder Konnektivitätsstatus. Datentyp: Array von Objekten "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] |
| Testmaß.Genauigkeit | Float-Dezimalwert, der die Genauigkeit der Testmessung darstellt, die für die zugehörigen Metriken erfasst wurde. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.captureDateTime | Datum und Uhrzeit der Erfassung der Metrik. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasure.id | SYS_ID oder external_ID der Testmaßnahmen. Datentyp: Zeichenfolge Tabelle: In den Feldern „sys_ID" oder „external_ID" der Tabelle „Testmaßnahmen" \[sn_st_mgmt_test_measure\]. |
| testMeasure.Measure.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-POST-serviceTest__ul_ed2_gxv_xbc} Datentyp: Zeichenfolge |
| TestMeasure.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasure.metricName | Name der Testmaßmetrik. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation | Ein Objekt zum Definieren einer Regel in der Schwellenwertregeldefinition, zusammen mit Konsequenzen, wenn die Regel verletzt wird. Datentyp: Array von Objekten "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] |
| testMeasure.ruleViolation.appliedConsequence | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Datentyp: Array von Objekten "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] |
| testMeasure.ruleViolation.appliedConsequence.appliedAction | Aktion, die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Beispiel: Senden einer Warnung oder Generieren eines Berichts. Angewendete Aktionen können zwischen Instanzen variieren. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.description | Beschreibung der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.id | SYS_ID oder external_ID der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.name | Name der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.repeatAction | Kennzeichnung, die angibt, ob die Konsequenz wiederholt werden soll, wenn ein zweiter Verstoß auftritt. Gültige Werte: * Wahr: Wiederholen Sie die Aktion. * Falsch: Wiederholen Sie die Aktion nicht. {#servicetestmgmt-POST-serviceTest__ul_ld2_gxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComporatorExact | Kennzeichnung, die angibt, ob ein Wert identisch ist. Gültige Werte: * Wahr: Der Wert ist identisch. * Falsch: Der Wert ist nicht identisch. {#servicetestmgmt-POST-serviceTest__ul_od2_gxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComporatorLower | Operator zum Überprüfen, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmgmt-POST-serviceTest__ul_sd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComporatorUpper | Operator zum Überprüfen, ob ein Wert über dem Schwellenwert liegt. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmgmt-POST-serviceTest__ul_vd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.id | SYS_ID oder external_ID des Schwellenwertregelverstoßes. Datentyp: Zeichenfolge Tabelle: Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\] |
| testMeasure.ruleViolation.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.ruleViolation.thresholdRuleSeverity | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmgmt-POST-serviceTest__ul_xd2_gxv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.tolerancePeriod | Angegebenes Zeitintervall, in dem das Überschreiten von Vorkommen aktiviert wird, ohne unmittelbare Konsequenzen oder Aktionen auszulösen. Datumstyp: Objekt "tolerancePeriod": { "amount": Number, "units": "String" } |
| testMeasure.ruleViolation.tolerancePeriod.amount | Anzahl der Zeiträume, bevor die Konsequenz angewendet wird. Datentyp: Zahl |
| testMeasure.ruleViolation.tolerancePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-POST-serviceTest__ul_qbw_qds_dcc} Datentyp: Zeichenfolge |
| Testmaß.EinheitenMessung | Maßeinheit für die Konformitätszielwerte der Testmessung. Datentyp: Zeichenfolge |
| TestMeasure.value | Wert der Testmaßnahme. Datentyp: Objekt "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } |
| testMeasure.value.id | ID des Testmesswerts. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Testmesswerts. Datentyp: Zeichenfolge |
| TestMeasure.value.value | Wert der Testmaßnahme. Datentyp: Zeichenfolge |
| TestMeasure.Wert.WertTyp | Typ des Testmesswerts, z. B. numerisch, Text usw. Datentyp: Zeichenfolge |
| Testspezifikation | Erforderlich. Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "testSpecification": { "href": "String", "id": "String" } |
| TestSpecification.href | Hyperlink-Verweis auf die Servicetestdefinition. Datentyp: Zeichenfolge |
| testSpecification.id | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Servicetestdefinition" \[sn_st_mgmt_test_definition\]. |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime ": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Gültigkeitsenddatum des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Gültigkeitsstartdatum des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[Tabelle : 40. Anforderungstext-Parameter (XML oder JSON)]

{#servicetestmgmt-POST-serviceTest__id_q31_zd1_qbc}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-POST-serviceTest__entry__124}{#servicetestmgmt-POST-serviceTest__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 41. Anforderungskopfzeilen.]

{#servicetestmgmt-POST-serviceTest__entry__128}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 42. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-POST-serviceTest__entry__132}{#servicetestmgmt-POST-serviceTest__entry-200-status-code}{#servicetestmgmt-POST-serviceTest__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
[Tabelle : 43. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#servicetestmgmt-POST-serviceTest__table_qzk_r2p_qbc__entry__2}

| Name | Beschreibung |
|-|-|
| Merkmal | Liste, die die Merkmale des zugehörigen Servicetests beschreibt. Datentyp: Array von Objekten "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] |
| Merkmal.ID | SYS_ID oder external_ID von Merkmalen. Wenn „external_ID" für diesen Datensatz vorhanden ist, gibt die Antwort die „external_ID" zurück, andernfalls wird die sys_ID zurückgegeben Datentyp: Zeichenfolge Tabelle: Merkmale \[sn_prd_pm_characteristic\] |
| characteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Merkmal.Wert | Merkmalsoptionen, die dem Servicetest zugeordnet sind. Merkmale variieren je nach Kundeninstanz. Datentyp: Zeichenfolge |
| Merkmal.WertTyp | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein Datentyp: Zeichenfolge |
| Beschreibung | Beschreibung des Servicetests. Datentyp: Zeichenfolge |
| endDateTime | Enddatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| Modus | Modus, in dem der Servicetest ausgeführt wird. Gültige Werte: * ONDEMAND: Löst den Servicetest manuell aus. * PROAKTIV: Löst den Servicetest automatisch aus. {#servicetestmgmt-POST-serviceTest__ul_itl_ksn_xbc} Datentyp: Zeichenfolge Standard: ONDEMAND |
| name | Name des Servicetests. Datentyp: Zeichenfolge |
| ZugehörigService | Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "relatedService": { "href": "string", "id": "String", "name": "String" } |
| RelatedService.ID | SYS_ID oder external_ID des Produktbestands. Datentyp: Zeichenfolge Tabelle: Produktbestand \[sn_prd_invt_product_inventory\] |
| relatedService.name | Name des Produktbestands. Datentyp: Zeichenfolge |
| startDateTime | Startdatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| Staat | Status des Servicetests. Gültige Werte: * bestätigt * Abgebrochen * Abgeschlossen * Fehlgeschlagen * inProgress * Ausstehend * abgelehnt {#servicetestmgmt-POST-serviceTest__ul_prs_txv_xbc} Datentyp: Zeichenfolge |
| Testmessung | Maß für einen bestimmten Aspekt eines Produkt-, Service- oder Ressourcentests, z. B. verlorene Pakete oder Konnektivitätsstatus. Datentyp: Array von Objekten "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] |
| Testmaß.Genauigkeit | Float-Dezimalwert, der die Genauigkeit der Testmessung darstellt, die für die zugehörigen Metriken erfasst wurde. Datentyp: Zahl Höchstwert: 40 |
| testMeasure.captureDateTime | Datum und Uhrzeit der Erfassung der Metrik. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasure.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-POST-serviceTest__ul_zrs_txv_xbc} Datentyp: Zeichenfolge |
| TestMeasure.ID | SYS_ID oder external_ID der Testmaßnahme. Datentyp: Zeichenfolge Tabelle: Testmaßnahmen \[sn_st_mgmt_test_measure\] |
| TestMeasure.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasure.metricName | Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation | Objekt zum Definieren einer Regel in der Schwellenwertregeldefinition, zusammen mit Konsequenzen, wenn die Regel verletzt wird. Datentyp: Array von Objekten "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 | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Datentyp: Array von Objekten "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] |
| testMeasure.ruleViolation.appliedConsequence.appliedAction | Aktion, die ausgeführt werden soll, wenn eine Schwellenwertregel verletzt wird. Beispiel: Senden einer Warnung oder Generieren eines Berichts. Angewendete Aktionen können zwischen Instanzen variieren. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | Kennzeichnung, die angibt, ob die angewendete Aktion wiederholt werden soll oder nicht. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-POST-serviceTest__ul_kss_txv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.appliedConsequence.description | Beschreibung der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.id | SYS_ID oder external_ID der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.appliedConsequence.name | Name der angewendeten Konsequenz. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem Wert von identisch ist conformanceTargetExact. Gültige Werte: * Wahr: Der Wert ist identisch. * Falsch: Der Wert ist nicht identisch. {#servicetestmgmt-POST-serviceTest__ul_uss_txv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| testMeasure.ruleViolation.conformanceComparatorLower | Ein Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * ist {#servicetestmgmt-POST-serviceTest__ul_fts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceComparatorUpper | Ein Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * ist * Kleiner als {#servicetestmgmt-POST-serviceTest__ul_mts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Bestimmt, ob der Schwellenwert überschritten wird oder nicht mehr überschritten wird. Datentyp: Zahl |
| testMeasure.ruleViolation.description | Beschreibung des Verstoßes gegen die Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.id | SYS_ID oder external_ID des Schwellenwertregelverstoßes. Datentyp: Zeichenfolge Tabelle: Verstoß gegen Schwellenwertregel \[sn_st_mgmt_threshold_rule_violation\] |
| testMeasure.ruleViolation.name | Name des Verstoßes gegen die Schwellenwertregel. Datumstyp: Zeichenfolge |
| testMeasure.ruleViolation.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Maximum: 40 |
| testMeasure.ruleViolation.thresholdRuleSeverity | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * niedrig * mittel {#servicetestmgmt-POST-serviceTest__ul_tts_txv_xbc} Datentyp: Zeichenfolge |
| testMeasure.ruleViolation.tolerancePeriod | Dauer oder Zeitintervall, in dem zulässige Überschreitungen auftreten können, bevor eine Konsequenz initiiert wird. Datumstyp: Objekt "tolerancePeriod": { "amount": Number, "units": "String" } |
| testMeasure.ruleViolation.tolerancePeriod.amount | Betrag des Zeitraums in Zahl. Datentyp: Zahl |
| testMeasure.ruleViolation.tolerancePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-POST-serviceTest__ul_my3_qds_dcc} Datentyp: Zeichenfolge |
| Testmaß.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasure.value | Wert der Metrik im Test. Datentyp: Objekt "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } |
| TestMeasure.value.ID | ID des Metrikwerts im Test. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Metrikwerts im Test. Datentyp: Zeichenfolge |
| testMeasure.value.name | Name des Metrikwerts im Test. Datentyp: Zeichenfolge |
| TestMeasure.value.value | Wert der Metrik im Test. Datentyp: Zeichenfolge |
| TestMeasure.Wert.WertTyp | Typ des Testmesswerts, z. B. numerisch, Text usw. Datentyp: Zeichenfolge |
| Testspezifikation | Testdefinition, die diesem Test zugeordnet ist. Datentyp: Objekt "testSpecification": { "href": "String", "id": "String" } |
| TestSpecification.href | Hyperlink-Verweis auf die Servicetestdefinition. Datentyp: Zeichenfolge |
| TestSpecification.ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum und Zeitstempel des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Startdatum und Zeitstempel des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

{#servicetestmgmt-POST-serviceTest__table_qzk_r2p_qbc}  

### Curl-Anforderung {#servicetestmgmt-POST-serviceTest__example_x42_qf1_qbc}

Das folgende Beispiel erstellt einen neuen Servicetest gemäß bestimmten Details, die im Anforderungstext angegeben sind.

    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"
                }
              ]
            }
          ]
        }
      ]
    }

Die Antwort gibt Bestätigungsdetails zum neuen Testservice zurück und weist ihm eine eindeutige ID zu, 2b406ec043b202104fefe4511fb8f211:

    {
      "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"
    }

## Servicetestmanagement -- offene API -- POST /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification {#ariaid-title9}

Erstellt eine neue Servicetestdefinition.

### URL-Format

Standard-URL: /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification

### Unterstützte Anforderungsparameter

{#servicetestmgmt-POST-serviceTestSp__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 44. Pfad-Parameter]

{#servicetestmgmt-POST-serviceTestSp__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 45. Abfrageparameter]

{#servicetestmgmt-POST-serviceTestSp__id_thr_xwn_qbc__entry__2}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristics-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristics.characteristicValueSpecification-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.value-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.descr-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.valueType-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.captureFrequency-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.captureMethod-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod.amount-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod.units-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.metricDescription-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.metricName-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorExact-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorLower-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorUpper-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetExact-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetLower-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetUpper-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.prescribeAction-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.repeatAction-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.numberOfAllowedCrossing-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.thresholdRuleSeverity-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.unitOfMeasure-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor.startDateTime-param}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Servicetestdefinition. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetestdefinition \[sn_st_mgmt_test_definition\] |
| name | Erforderlich. Name der Servicetestdefinition. Datentyp: Zeichenfolge |
| ZugehörigServicespezifikation | Erforderlich. Servicespezifikationen der Testdefinition. Datentyp: Array von Objekten "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] |
| relatedServiceSpecification.id | SYS_ID oder external_ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Spezifikation" \[sn_prd_pm_specification\]. |
| relatedServiceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship | Zugehörige Servicetestdefinition. Datentyp: Array von Objekten "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] |
| serviceTestSpecRelationship.id | SYS_ID oder external_ID der zugehörigen Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Testdefinition" \[sn_st_mgmt_test_definition\]. |
| serviceTestSpecRelationship.name | Name der zugehörigen Testdefinition. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship.RelationshipType | Typ der Beziehung. Gültige Werte: * Abhängigkeit * Exklusivität * Ersatz Datentyp: Zeichenfolge |
| Merkmal | Merkmale der Testdefinition. Datentyp: Array von Objekten "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| specCharacteristic.characteristicValueSpecification | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "characteristicValueSpecification": [ { "value": "String" } ] |
| specCharacteristic.characteristicValueSpecification.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Specteristic.validFor | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Specteristic.validFor.endDateTime | Enddatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.validFor.startDateTime | Startdatum des Merkmals. FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. Datentyp: Zeichenfolge |
| SpecCharacteristic.valueType | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-POST-serviceTestSp__ul_i3m_twr_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition | Testmaßdefinitionen für diese Servicetestdefinition. Weitere Informationen finden Sie unter [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "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 | Die Häufigkeit, mit der die Metrik erfasst werden soll. Gültige Werte: * täglich * monatlich * Keine * einmal * wöchentlich {#servicetestmgmt-POST-serviceTestSp__ul_lsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfasst die Metrik nicht. {#servicetestmgmt-POST-serviceTestSp__ul_gsw_jxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.capturePeriod | Zeitraum oder Dauer der Metrikerfassung. Datentyp: Objekt "capturePeriod": { "amount": Number, "units": "String" } |
| testMeasureDefinition.capturePeriod.amount | Anzahl der Erfassungszeiträume. Datentyp: Zahl |
| testMeasureDefinition.capturePeriod.units | Einheiten des Zeitraums. Gültige Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-POST-serviceTestSp__ul_rn1_3ds_dcc} Datentyp: Zeichenfolge |
| testMeasureDefinition.id | SYS_ID oder external_ID der Testmaßdefinitionen. Datentyp: Zeichenfolge Tabelle: Testmaßdefinitionstabelle \[sn_st_mgmt_test_measure_definition\] |
| TestMeasureDefinition.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasureDefinition.metricName | Anwenderdefinierter Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasureDefinition.name | Name der Testmaßdefinition. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel | Regel, die Bedingungen definiert, die erreicht werden sollen, bevor Konsequenzen angewendet werden, wenn ein Schwellenwert​in der Testmaßdefinition überschritten (oder nicht überschritten) wird. Weitere Informationen finden Sie unter [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten { "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.threshold.Rule.KonformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem für festgelegten Wert identisch ist testMeasureDefinition.thresholdRule.conformanceTargetExact. Wenn auf „wahr" festgelegt, testMeasureDefinition.thresholdRule.conformanceTargetExactIst erforderlich. Gültige Werte: * Wahr: Der Wert ist identisch mit dem Wert von conformanceTargetExact. * Falsch: Der Wert ist nicht identisch conformanceTargetExact. {#servicetestmgmt-POST-serviceTestSp__ul_bsw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorLower | Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * größer als oder gleich {#servicetestmgmt-POST-serviceTestSp__ul_zrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorOber | Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * weniger als * weniger als oder gleich {#servicetestmgmt-POST-serviceTestSp__ul_wrw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceZielLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Regel.Konsequenz | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Weitere Informationen finden Sie unter [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] |
| testMeasureDefinition.thresholdRule.consequence.description | Beschreibung der Konsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.id | SYS_ID oder external_ID der Maßkonsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.name | Name der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel.Konsequenz.vorgeschriebenen Aktion | Anwenderdefinierte Aktion für Schwellenwertverstöße. Aktionen variieren zwischen Instanzen. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.wiederholte Aktion | Kennzeichnung, die angibt, ob die angewendete Konsequenz wiederholt werden soll. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-POST-serviceTestSp__ul_srw_jxv_xbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor | Datumsbereich, für den die Konsequenz gültig ist. Datentyp: Objekt "validFor": { "startDateTime": "String", "endDateTime ": "String" } |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.endDateTime | Gültigkeitsenddatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.startDateTime | Gültigkeitsstartdatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasureDefinition.thresholdRule.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.id | SYS_ID oder external_ID der Schwellenwertregeln. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Schwellenwertregeln" \[sn_st_mgmt_threshold_rule\]. |
| testMeasureDefinition.thresholdRule.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| TestMeasureDefinition.threshold-Regel.threshold-Regelschweregrad | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * mittel * niedrig {#servicetestmgmt-POST-serviceTestSp__ul_orw_jxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasureDefinition.validFür | Datumsbereich, für den die Testmaßdefinition gültig ist. Datentyp: Zeichenfolge "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| TestMeasureDefinition.validFor.endDateTime | Gültigkeitsenddatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.validFor.startDateTime | Gültigkeitsstartdatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidiertFür | Datumsbereich, für den die Testdefinition gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Datum und Uhrzeit der Testdefinition, zu der der Status der Definition stillgelegt wird. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Datum und Uhrzeit der Testdefinition, an der der Status veröffentlicht wird. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[Tabelle : 46. Anforderungstext-Parameter (XML oder JSON)]

{#servicetestmgmt-POST-serviceTestSp__id_thr_xwn_qbc}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-POST-serviceTestSp__entry__126}{#servicetestmgmt-POST-serviceTestSp__accept-JSON-only-entry-RESTAPI}{#servicetestmgmt-POST-serviceTestSp__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 47. Anforderungskopfzeilen.]

{#servicetestmgmt-POST-serviceTestSp__entry__132}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Antworttexts. Unterstützt nur Anwendung/JSON. |
[Tabelle : 48. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#servicetestmgmt-POST-serviceTestSp__entry__136}{#servicetestmgmt-POST-serviceTestSp__entry-200-status-code}{#servicetestmgmt-POST-serviceTestSp__entry-400-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 400 | Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt. |
[Tabelle : 49. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#servicetestmgmt-POST-serviceTestSp__table_qqg_3s4_qbc__entry__2}

| Name | Beschreibung |
|-|-|
| Beschreibung | Beschreibung der Servicetestdefinition. Datentyp: Zeichenfolge |
| ID | SYS_ID oder external_ID der Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Servicetest \[sn_st_mgmt_test\] |
| name | Name der Servicetestdefinition. Datentyp: Zeichenfolge |
| ZugehörigServicespezifikation | Servicespezifikationen für die Testdefinitionen. Datentyp: Array von Objekten "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] |
| RelatedServicespezifikation.ID | SYS_ID oder external_ID der Servicespezifikation. Datentyp: Zeichenfolge Tabelle: Im Feld „sys_ID" oder „external_ID" der Tabelle „Spezifikation" \[sn_prd_pm_specification\]. |
| relatedServiceSpecification.name | Name der Servicespezifikation. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship | Zugehörige Servicetestdefinition. Datentyp: Array von Objekten "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] |
| ServiceTestSpecRelationship.ID | SYS_ID oder external_ID der zugehörigen Servicetestdefinition. Datentyp: Zeichenfolge Tabelle: Testdefinition \[sn_st_mgmt_test_definition\] |
| serviceTestSpecRelationship.name | Name der zugehörigen Testdefinition. Datentyp: Zeichenfolge |
| ServiceTestSpecRelationship.RelationshipType | Typ der Beziehung. Akzeptierte Werte: * Abhängigkeit * Exklusivität * Ersatz {#servicetestmgmt-POST-serviceTestSp__ul_hpg_xtr_dcc} Datentyp: Zeichenfolge |
| Merkmal | Testdefinitionsmerkmale. Datentyp: Array von Objekten "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] |
| specCharacteristic.characteristicValueSpecification | Mögliche Werte des Merkmals. Datentyp: Array von Objekten "characteristicValueSpecification": [ { "value": "String" } ] |
| specCharacteristic.characteristicValueSpecification.value | Wert des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.description | Beschreibung des Merkmals. Datentyp: Zeichenfolge |
| specCharacteristic.name | Name des Merkmals. Datentyp: Zeichenfolge |
| Specteristic.validFor | Datumsbereich, für den das Merkmal gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| Specteristic.validFor.endDateTime | Enddatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| SpecCharacteristic.validFor.startDateTime | Startdatum des Merkmals. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| SpecCharacteristic.valueType | Typ des Merkmalwerts. * Auswahl * Datum * Datum/Uhrzeit * Dauer * E-Mail * label * Einzeiliger Test * ja/Nein {#servicetestmgmt-POST-serviceTestSp__ul_uwb_5wr_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition | Testmaßdefinitionen für diese Servicetestdefinition. Weitere Informationen finden Sie unter [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=yokohama&pubname=yokohama-proactive-service-exp-workflows&ft:locale=en-US). Datentyp: Array von Objekten "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 | Häufigkeit, mit der die Metrik erfasst werden soll. Gültige Werte: * täglich * monatlich * Keine * einmal * wöchentlich {#servicetestmgmt-POST-serviceTestSp__ul_od2_sxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.captureMethod | Methode zum Erfassen der Metrik. Gültige Werte: * Automatisch: Erfassen Sie die Metrik automatisch. * Manuell: Erfassen Sie die Metrik manuell. * Keine: Erfassen Sie die Metrik nicht. {#servicetestmgmt-POST-serviceTestSp__ul_rd2_sxv_xbc} Datentyp: Zeichenfolge |
| testMeasureDefinition.capturePeriod | Dauer oder Zeitraum der Erfassung. Datentyp: Objekt "capturePeriod": { "amount": Number, "units": "String" } |
| testMeasureDefinition.capturePeriod.amount | Anzahl der Erfassungszeiträume. Datentyp: Zahl |
| testMeasureDefinition.capturePeriod.units | Einheiten des Zeitraums. Akzeptierte Werte: * Tage * Stunden * Minuten * Sekunden {#servicetestmgmt-POST-serviceTestSp__ul_lfv_dds_dcc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.ID | SYS_ID oder external_ID der Testmaßdefinitionen. Datentyp: Zeichenfolge Tabelle: Testmaßdefinition \[sn_st_mgmt_test_measure_definition\] |
| TestMeasureDefinition.metricBeschreibung | Kurze Beschreibung der Metrik. Datentyp: Zeichenfolge |
| TestMeasureDefinition.metricName | Anwenderdefinierter Name einer Metrik in der Testmaßnahme. Datentyp: Zeichenfolge |
| testMeasureDefinition.name | Name der Testmaßdefinition. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel | Regel, die die Bedingung (erhöhen oder löschen) definiert, um Konsequenzen anzuwenden, wenn ein Schwellenwert​für eine bestimmte Testmaßdefinition überschritten wird oder nicht mehr überschritten wird. Datentyp: Array von Objekten { "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.threshold.Rule.KonformanceComparatorExact | Kennzeichnung, die angibt, ob ein Wert mit dem Wert von identisch ist conformanceTargetExact. Gültige Werte: * Wahr: Der Wert ist identisch mit dem Wert von conformanceTargetExact. * Falsch: Der Wert ist nicht identisch conformanceTargetExact. {#servicetestmgmt-POST-serviceTestSp__ul_gyl_vqr_dcc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorLower | Operator, der überprüft, ob ein Wert unter den Schwellenwert fällt. Gültige Werte: * größer als * ist {#servicetestmgmt-POST-serviceTestSp__ul_b22_sxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.KonformanceComparatorOber | Operator, der überprüft, ob ein Wert den Schwellenwert überschreitet. Gültige Werte: * Kleiner als * ist {#servicetestmgmt-POST-serviceTestSp__ul_e22_sxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.conformanceTargetExact | Erforderlich, wenn conformanceComparatorExactIst auf „wahr" festgelegt. Wenn conformanceComparatorExactWert ist auf „wahr" festgelegt. Sein Wert stimmt mit dem in definierten Wert überein conformanceTargetExact. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceZielLower | Unterer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Rule.conformanceTargetUpper | Oberer Schwellenwert für den Vergleich der Testmessergebnisse. Datentyp: Zahl |
| TestMeasureDefinition.threshold.Regel.Konsequenz | Aktion (vorgeschriebene Aktion oder Benachrichtigung), die ausgeführt werden soll, wenn eine Schwellenwertregel überschritten wird. Datentyp: Array von Objekten "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] |
| testMeasureDefinition.thresholdRule.consequence.description | Beschreibung der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.ID | SYS_ID oder external_ID der Maßkonsequenz. Datentyp: Zeichenfolge |
| testMeasureDefinition.thresholdRule.consequence.name | Name der Konsequenz. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold-Regel.Konsequenz.vorgeschriebenen Aktion | Anwenderdefinierte Aktion für Schwellenwertverstöße. Aktionen variieren zwischen Instanzen. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.Konsequenz.wiederholte Aktion | Kennzeichnung, die angibt, ob die angewendete Aktion wiederholt werden soll oder nicht. Gültige Werte: * Wahr: Wiederholt die Aktion. * Falsch: Wiederholt die Aktion nicht. {#servicetestmgmt-POST-serviceTestSp__ul_rjm_pxy_rbc} Datentyp: Boolescher Wert Standard: Falsch |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor | Datumsbereich, für den die Konsequenz gültig ist. Datentyp: Objekt "validFor": { "startDateTime": "String", "endDateTime ": "String" } |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.endDateTime | Gültigkeitsenddatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.threshold.Rule.Konsequenz.validFor.startDateTime | Gültigkeitsstartdatum der Konsequenz. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| testMeasureDefinition.thresholdRule.description | Beschreibung der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.ID | SYS_ID oder external_ID der Schwellenwertregeln. Datentyp: Zeichenfolge Tabelle: Schwellenwertregeln \[sn_st_mgmt_threshold_rule\] |
| testMeasureDefinition.thresholdRule.name | Name der Schwellenwertregel. Datentyp: Zeichenfolge |
| TestMeasureDefinition.threshold.Rule.numberOfAllowedCrossing | Maximal zulässige Überschreitungen innerhalb des Toleranzzeitraums, bevor Konsequenzen angewendet werden. Datentyp: Zahl Höchstwert: 40 |
| TestMeasureDefinition.threshold-Regel.threshold-Regelschweregrad | Schweregrad der Schwellenwertregel. Gültige Werte: * hoch * niedrig * mittel {#servicetestmgmt-POST-serviceTestSp__ul_j22_sxv_xbc} Datentyp: Zeichenfolge |
| TestMeasureDefinition.EinheitenMessung | Messbarer Wert der Zeit, die zur Berechnung der Leistung eines Service verwendet wird, in Tagen, Minuten und Sekunden. Datentyp: Zeichenfolge |
| TestMeasureDefinition.validFür | Datumsbereich, für den die Testmaßdefinition gültig ist. Datentyp: Objekt "validFor": { "endDateTime": "String", "startDateTime": "String" } |
| TestMeasureDefinition.validFor.endDateTime | Gültigkeitsenddatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| TestMeasureDefinition.validFor.startDateTime | Gültigkeitsstartdatum der Testmaßdefinition. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidiertFür | Datumsbereich, für den der Servicetest gültig ist. Datentyp: Objekt "validFor": { "endDateTime ": "String", "startDateTime": "String" } |
| ValidFor.endDateTime | Enddatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
| ValidFor.startDateTime | Startdatum und -Uhrzeit des Servicetests. Datentyp: Zeichenfolge FORMAT: JJJJ-MM-TT 00:00:00. Beispiel: `31.01.2025 09:35:43 `. |
[ ]

{#servicetestmgmt-POST-serviceTestSp__table_qqg_3s4_qbc}  

### Curl-Anforderung

Im folgenden Beispiel wird eine neue Servicetestdefinition erstellt.

    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"
        }
      ]
    }

Antworttext.

    {
      "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"
    }


