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


---

# Cloud Runner-Testanwender-REST-API

# Cloud Runner-Testanwender-REST-API {#ariaid-title1}

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

Verwaltet Testanwenderaufträge, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden sollen.
Die Cloud Runner-Testanwender API erfordert [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)Plugin (sn_atf_tg). Die mit dieser API verfügbaren Methoden werden in ausgeführt Jetzt Namespace und kann über API-Namen aufgerufen werden, Ein-Klick-Regressionstests für ATF , Im REST API Explorer. Für den Zugriff auf diese API ist die Administratorrolle erforderlich.  
Sie können diese API für die folgenden Aufgaben verwenden:

* Starten Sie den Anwendertestauftrag.
* Legen Sie den Cloud-Anwender fest.
* Überprüfen Sie, ob der angegebene Anwender gültig ist.
* Überprüfen Sie den Fortschritt des Anwendertestauftrags.
* Brechen Sie den Testauftrag ab.
{#cloudrunner-testuser-api__cloudrnr-TestUserAPI-scoped_ul_vwb_wvn_31c}

Die Cloud Runner-Testlauf API kann zusammen mit verwendet werden [REST-API für Cloud Runner-Testgenerierung](https://servicenow-prod.fluidtopics.net/f2BtiILLFT4ojMNM6P7QOA#cloudrunner-testgeneration-api "Verwaltet die Testauftragsgenerierung, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden soll.")Und [Cloud Runner-Testanwender-REST-API](https://servicenow-prod.fluidtopics.net/MUeoyh3rK8hyQFqsqByx1A#cloudrunner-testuser-api "Verwaltet Testanwenderaufträge, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden sollen."). Sie können beispielsweise einen Test generieren (Cloud Runner-Testgenerierungs-API), dann den Fortschritt des Tests in der Browser-Orchestration-Warteschlange (Cloud Runner-TESTGENERIERUNGS-API) abrufen und die Anzahl der bestandenen oder fehlgeschlagenen Tests überprüfen.

Informationen zum Anzeigen der Server-API-Referenzdokumentation dieser API finden Sie unter [Cloud Runner-TestanwenderApi -- Umfang, Global](https://servicenow-prod.fluidtopics.net/B3pJaXlVC2jVCRG6bYdCxg#cloudrnr-TestUserAPI-scoped "Verwaltet Testanwenderaufträge, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden sollen. Diese API ist Teil der CloudRunnerApi-Skripteinbindung.").

## Cloud Runner-Testanwender -- GET /now/sn_atf_tg/Test_user_Progress {#ariaid-title2}

Stellt den Status des Testanwenderauftrags für einen angegebenen BOQ-Datensatz (BrowserOrchestration Queue) bereit.

### URL-Format

Standard-URL: ABRUFEN /api/now/sn_atf_tg/Test_user_Progress

### Unterstützte Anforderungsparameter

{#cr-TestUserAPI-GET-test-user-progress__entry__2}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__6}

| Name | Beschreibung |
|-|-|
| SnboqId | Erforderlich. SYS_ID des BOQ-Datensatzes des Testanwenderauftrags, dessen Fortschritt abgerufen werden soll. Datentyp: Zeichenfolge Tabelle: BOQ \[sn_atf_tg_sn_boq\] |
[Tabelle : 2. Abfrageparameter]

{#cr-TestUserAPI-GET-test-user-progress__entry__10}

| 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.").
{#cr-TestUserAPI-GET-test-user-progress__entry__14}{#cr-TestUserAPI-GET-test-user-progress__accept-RESTAPI}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[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.").
{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Der Fortschritt des Testanwenderauftrags wurde erfolgreich abgerufen. |
| 400 | Fehler beim Abrufen des BOQ-Datensatzstatus. Gibt eine der folgenden Nachrichten zurück: * Keine BOQ-ID übergeben -- es wurde keine BOQ-ID angegeben. Fügen Sie dem Anforderungstext die BOQ-ID hinzu. * BOQ-Datensatz kann nicht gefunden werden -- ungültige SYS-ID. Stellen Sie sicher, dass die sys_ID des BOQ-Datensatzes gültig und der Datensatz vorhanden ist. {#cr-TestUserAPI-GET-test-user-progress__ul_d5p_btk_p1c} |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 6. Statuscodes]

{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c}

### Antworttext-Parameter (JSON oder XML)

{#cr-TestUserAPI-GET-test-user-progress__entry__30}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Fortschrittsergebnisse des Test Runner-Auftrags oder eine Nachricht enthält, die erklärt, warum die Anforderung fehlgeschlagen ist. "result": { "progress": 100, "state": "completed" } {#cr-TestUserAPI-GET-test-user-progress__codeblock_tqb_gth_41c} Oder: "result": { "message": "String" } Datentyp: Objekt |
| Ergebnis.Nachricht | Fehlermeldung, die angibt, warum der Test Runner-Fortschritt nicht abgerufen werden kann. Der Nachrichtenparameter wird in einer erfolgreichen Antwort nicht zurückgegeben. Datentyp: Zeichenfolge |
| result.progress | Prozentsatz, der angibt, wie kurz vor dem Abschluss eines Tests steht, während er sich im Status „wird ausgeführt" befindet. Datentyp: Zahl |
| Ergebnis.Status | Aktueller Status des BOQ-Datensatzes. Mögliche Werte: * Angeforderte Browser: Eine Anforderung wurde an die Cloud-Infrastruktur gesendet, um Browser für die Testgenerierung oder Testausführung zu starten. * Abgeschlossen: Die Testaufgabe ist abgeschlossen. * Status „Fehlgeschlagen": Die Testaufgabe ist fehlgeschlagen. * Ausstehend: Die angeforderte Testaktivität wurde erstellt und wartet auf die Ausführung. * Verarbeitung: Die Instanz scannt nach Datensätzen, um sicherzustellen, dass die Ausführungstracker für Cloud Runner markiert sind, bevor die Anforderung an die Cloud-Infrastruktur gesendet wird. * Wird ausgeführt: Die Cloud-Infrastrukturbrowser suchen ausstehende Tests und führen sie aus. {#cr-TestUserAPI-GET-test-user-progress__ul_hph_y5h_41c} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Anforderungsbeispiel zeigt, wie der Fortschritt eines Testanwenderauftrags überprüft wird.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user_progress?snboqId=<sys_id of SNBOQ record>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

Antworttext:

    { 
      "result": { 
        "progress": 100, 
        "state": "completed" 
      } 
    }

## Cloud Runner-Testanwender -- GET /now/sn_atf_tg/is_valid_cloud_user {#ariaid-title3}

Überprüft, ob ein angegebener Anwender ein gültiger Cloud-Anwender ist.
Diese Methode überprüft, ob der Anwender die folgenden Kriterien erfüllt:

* Vorhanden,
* Ist aktiv,
* Ist nicht gesperrt,
* Erfordert eine Passwortzurücksetzung,
* Ist ein Administrator,
* Ist schreibgeschützt,
* Ist nur Webservices

### URL-Format

Standard-URL: ABRUFEN /api/now/sn_atf_tg/is_valid_cloud_user

### Unterstützte Anforderungsparameter

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__2}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__6}

| Name | Beschreibung |
|-|-|
| username | Erforderlich. Anwendername des sys_user, um zu überprüfen, ob der Anwender die folgenden Baseline-Kriterien erfüllt. * Vorhanden, * Ist aktiv, * Ist nicht gesperrt, * Erfordert eine Passwortzurücksetzung, * Ist ein Administrator, * Ist schreibgeschützt, * Ist nur Webservices {#cr-TestUserAPI-GET-is_valid_cloud_user__ul_orh_qnl_p1c} Wenn eine dieser Bedingungen fehlschlägt, gibt die API einen falschen booleschen Wert mit einer Meldung zurück, welche Kriterien fehlgeschlagen sind. Datentyp: Zeichenfolge |
[Tabelle : 8. Abfrageparameter]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__10}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. 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.").
{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__14}{#cr-TestUserAPI-GET-is_valid_cloud_user__accept-RESTAPI}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__18}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. 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.").
{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Gibt „wahr" oder „falsch" zurück, wenn der Anwender gültig ist und die Cloud-Anwenderkriterien erfüllt. |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 12. Statuscodes]

{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c}

### Antworttext-Parameter (JSON oder XML)

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__28}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Ergebnisse der Anforderung enthält. "result": { "validUser": Boolean } {#cr-TestUserAPI-GET-is_valid_cloud_user__codeblock_hhp_4k2_p1c} Datentyp: Objekt |
| Ergebnis.validierter Anwender | Kennzeichnung, die angibt, ob der Anwender die Cloud-Anwenderkriterien erfüllt. Bei „wahr" erfüllt der Anwender die Kriterien. Datentyp: Boolescher Wert |
[ ]

### Curl-Anforderung

Die folgende Anforderung überprüft, ob der angegebene sys_user die Kriterien für die Verwendung der Cloud-Funktionalität erfüllt.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/is_valid_cloud_user?username=<username of sys_user to check>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

Antworttext:

    { 
      "result": { 
        "validUser": <Boolean value indicating whether user is valid cloud user> 
      } 
    }

## Cloud Runner-Testanwender -- POSTEN SIE /now/sn_atf_tg/Test_user {#ariaid-title4}

Fügt einen Testanwenderauftrag für einen bestimmten Anwendernamen in die BOQ-Tabelle \[sn_atf_tg_sn_boq\] ein, der dann im Cloud Runner ausgeführt wird.

### URL-Format

Standard-URL: POST /api/now/sn_atf_tg/Test_user

### Unterstützte Anforderungsparameter

{#cr-TestUserAPI-POST-test-user__entry__2}

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

{#cr-TestUserAPI-POST-test-user__entry__6}

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

{#cr-TestUserAPI-POST-test-user__entry__10}

| Name | Beschreibung |
|-|-|
| username | Erforderlich. Anwendername des sys_user zum Testen der End-to-End-Infrastruktur des Cloud Runners. Datentyp: Zeichenfolge |
[Tabelle : 15. 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.").
{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c__entry__2}{#cr-TestUserAPI-POST-test-user__accept-RESTAPI}{#cr-TestUserAPI-POST-test-user__content_type-RESTAPI}

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

{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c} {#cr-TestUserAPI-POST-test-user__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. 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.").
{#cr-TestUserAPI-POST-test-user__entry__24}

| Statuscode | Beschreibung |
|-|-|
| 200 | Ein Testanwender-BOQ-Auftrag wurde erfolgreich eingefügt. |
| 400 | Fehler beim Starten des Testanwenderauftrags. Wenn ein leerer Anwendername angegeben wird oder ein Anwender in der Tabelle „sys_user" nicht gefunden werden kann, löst der Server einen Fehler aus. |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cr-TestUserAPI-POST-test-user__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Ergebnisse der Anforderung enthält. "result": { "snboqId": String } Oder: "result": { "message": "String" } Datentyp: Objekt |
| Ergebnis.Nachricht | Fehlermeldung, die angibt, warum dem Anwendernamen keine Testfähigkeiten zugewiesen werden können. Der Nachrichtenparameter wird in einer erfolgreichen Antwort nicht zurückgegeben. Datentyp: Zeichenfolge |
| Ergebnis.snboqId | SYS_ID des BOQ-Datensatzes, der eingefügt wird, wenn der Testanwenderauftrag erfolgreich gestartet wird. Datentyp: Zeichenfolge Tabelle: BOQ \[sn_atf_tg_sn_boq\] |
[ ]

### Curl-Anforderung

Das folgende Anforderungsbeispiel zeigt, wie ein Testanwenderauftrag für einen bestimmten Anwendernamen in die BOQ-Tabelle \[sn_atf_tg_sn_boq\] eingefügt wird.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to test cloud infrastructure>\"}" \ 
    --user "username:password"

Die Antwort gibt eine sys_ID des BOQ-Datensatzes zurück, der beim Start des Testanwenderauftrags eingefügt wird.

    { 
      "result": { 
        "snboqId": "<sys_id of newly inserted BOQ record>" 
      } 
    }

Das folgende Beispiel gibt eine Fehlermeldung 400 zurück, wenn kein Anwendername oder ein ungültiger Anwendername übergeben wird.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user" \
    --request POST \
    --header "Accept:application/json" \
    --user "username:password"

Antwort:

    {
      "result": {
        "message": "Unable to set cloud user as cloud user not valid"
      }
    }

## Cloud Runner-Testanwender -- POSTEN SIE /now/sn_atf_tg/Cancel_Test_user {#ariaid-title5}

Legt den Status des Testanwenderauftrags in der Tabelle „Browserorchestration-Warteschlange (BOQ) \[sn_atf_tg_sn_boq\]" auf „Abgeschlossen" fest.

### URL-Format

Standard-URL: POST /api/now/sn_atf_tg/Cancel_Test_user

### Unterstützte Anforderungsparameter

{#cr-TestUserAPI-POST-cancel-test-user__entry__2}

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__6}

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__10}

| Name | Beschreibung |
|-|-|
| SnboqId | Erforderlich. SYS_ID des BOQ-Datensatzes, der dem Testanwenderauftrag zugeordnet ist, abzubrechen. Datentyp: Zeichenfolge Tabelle: SNBOQ \[sn_atf_tg_sn_boq\] |
[Tabelle : 21. 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.").
{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c__entry__2}{#cr-TestUserAPI-POST-cancel-test-user__accept-RESTAPI}{#cr-TestUserAPI-POST-cancel-test-user__content_type-RESTAPI}

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

{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c} {#cr-TestUserAPI-POST-cancel-test-user__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. 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.").
{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Der BOQ-Auftrag wurde erfolgreich abgebrochen. |
| 400 | Fehler beim Abbrechen des Auftrags. Gibt eine der folgenden Nachrichten zurück: * Keine BOQ-ID übergeben -- es wurde keine BOQ-ID angegeben. Fügen Sie dem Anforderungstext die BOQ-ID hinzu. * BOQ-Datensatz kann nicht gefunden werden -- ungültige SYS-ID. Stellen Sie sicher, dass die sys_ID des BOQ-Datensatzes gültig und der Datensatz vorhanden ist. {#cr-TestUserAPI-POST-cancel-test-user__ul_fzp_ztk_p1c} |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 24. Statuscodes]

{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c}

### Antworttext-Parameter (JSON oder XML)

{#cr-TestUserAPI-POST-cancel-test-user__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Ergebnisse der Anforderung enthält. "result": { "message": String } {#cr-TestUserAPI-POST-cancel-test-user__codeblock_hhp_4k2_p1c} Datentyp: Objekt |
| Ergebnis.Nachricht | Nachricht, die angibt, ob der Abbruch des Testanwenders erfolgreich war. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Die folgende Anforderung demonstriert, wie Sie einen Testanwenderauftrag in der Tabelle „Browserorchestration-Warteschlange \[sn_atf_tg_sn_boq\]" abbrechen.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/cancel_test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"snboqId\":\"<sys_id of BOQ record>\"}" \ 
    --user "username:password"

Erfolgreicher Antworttext:

    { 
      "result": { 
        "message": "success" 
      } 
    }

## Cloud Runner-Testanwender -- POSTEN SIE /now/sn_atf_tg/select_Cloud_user {#ariaid-title6}

Startet einen End-to-End-Test-Anwenderauftrag im Cloud Runner. Wenn der Anwender sich mit der Administratorrolle anmelden kann, wird für zukünftige Testläufe und Testgenerierungen standardmäßig dieser Anwender als Cloud-Anwendereigenschaft verwendet.

### URL-Format

Standard-URL: POST /api/now/sn_atf_tg/select_Cloud_user

### Unterstützte Anforderungsparameter

{#cr-TestUserAPI-POST-select-cloud-user__entry__2}

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__6}

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__10}

| Name | Beschreibung |
|-|-|
| username | Erforderlich. Anwendername des sys_user, der den Cloud-Anwender für zukünftige Test Runner- und Testgenerierungsaufträge testen und festlegen soll. Datentyp: Zeichenfolge |
[Tabelle : 27. 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.").
{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c__entry__2}{#cr-TestUserAPI-POST-select-cloud-user__accept-RESTAPI}{#cr-TestUserAPI-POST-select-cloud-user__content_type-RESTAPI}

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

{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c} {#cr-TestUserAPI-POST-select-cloud-user__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. 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.").
{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Die End-to-End-Cloud Runner-Infrastruktur wurde erfolgreich getestet und der Cloud-Anwender für zukünftige Testausführungs- und Testgenerierungsaufträge festgelegt. |
| 400 | Fehler beim Testen der vollständigen End-to-End-Cloud Runner-Infrastruktur und beim Festlegen des Cloud-Anwenders. Stellen Sie sicher, dass der Anwendername nicht leer ist oder dass der Anwender in der Tabelle „sys_user" für einen bestimmten Anwendernamen vorhanden ist. |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 30. Statuscodes]

{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c}

### Antworttext-Parameter (JSON oder XML)

{#cr-TestUserAPI-POST-select-cloud-user__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Ergebnisse der Anforderung enthält. "result": { "message": "String" } {#cr-TestUserAPI-POST-select-cloud-user__codeblock_hhp_4k2_p1c} Datentyp: Objekt |
| Ergebnis.Nachricht | Nachricht, die angibt, ob der Anwender erfolgreich für zukünftige Testläufe und Testgenerierungen in der Cloud Runner-Infrastruktur ausgewählt wurde. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Das folgende Beispiel zeigt, wie Sie die Auswahl eines bestimmten Anwenders für zukünftige Testläufe und Testgenerierungen in der Cloud Runner-Infrastruktur anfordern.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/select_cloud_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to set as cloud user>\"}" \ 
    --user "username:password"

Der Antworttext gibt eine Erfolgsmeldung zurück, die angibt, dass der Cloud-Anwender erfolgreich für Testläufe und Generierungen ausgewählt wurde.

    { 
      "result": { 
        "message": "success" 
      } 
    }


