---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# REST API für Cloud Runner-Testanwender

# REST API für Cloud Runner-Testanwender {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 Minuten Lesedauer

Verwaltet Testanwenderaufträge, die in einem Cloud Runner für Automated Test Framework (ATF) ausgeführt werden sollen.
Die Cloud Runner Test User API erfordert das Plugin [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) (sn_atf_tg). Die mit dieser API verfügbaren Methoden werden im Now -Namespace ausgeführt und können mit dem API-Namen, Ein-Klick-Regressionstests für ATF, im REST-API-Explorer aufgerufen werden. 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üft den Fortschritt des Anwendertestauftrags.
* Brechen Sie den Testauftrag ab.
{#cloudrunner-testuser-api__cloudrnr-TestUserAPI-scoped_ul_vwb_wvn_31c}

Die Cloud Runner Test Runner API kann zusammen mit [REST API für Cloud Runner-Testgenerierung](https://www.servicenow.com/docs/cDiiuDDI9hWNzKmv7Gufzw#cloudrunner-testgeneration-api "Verwaltet die Testauftragsgenerierung, die in einem Cloud Runner für Automated Test Framework (ATF) ausgeführt werden soll.") und [REST API für Cloud Runner-Testanwender](https://www.servicenow.com/docs/pBMj2YlrLniExXfO0cX6pA#cloudrunner-testuser-api "Verwaltet Testanwenderaufträge, die in einem Cloud Runner für Automated Test Framework (ATF) ausgeführt werden sollen.")verwendet werden. Sie können beispielsweise einen Test generieren (Cloud Runner-Testgenerierungs-API), dann den Fortschritt des Tests in der Browser-Orchestrationswarteschlange abrufen (Cloud Runner-TEST-Generierungs-API) und die Anzahl der Tests überprüfen, die bestanden oder fehlgeschlagen sind.

Informationen zum Anzeigen der Server-API-Referenzdokumentation dieser API finden Sie unter [Cloud Runner TestUserApi -- Bereichsbezogen, Global](https://www.servicenow.com/docs/gbDZ~ScrqVPI9I6gaCV0Jg#cloudrnr-TestUserAPI-scoped "Verwaltet Testanwenderaufträge, die in einem Cloud Runner für Automated 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 (Browser Orchestration Queue) bereit.

### URL-Format

Standard-URL: GET /api/now/sn_atf_tg/test_user_progress

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 1. Pfadparameter]

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

| Name | Beschreibung |
|-|-|
| snboqId | Erforderlich. Die sys_id des BOQ-Datensatzes des Testanwenderauftrags, dessen Fortschritt abgerufen werden soll. Befindet sich in der BOQ-Tabelle \[sn_atf_tg_sn_boq\]. Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

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

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

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cr-TestUserAPI-GET-test-user-progress__entry__14}{#cr-TestUserAPI-GET-test-user-progress__accept-RESTAPI}

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

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

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Status des BOQ-Datensatzes. 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 konnte nicht gefunden werden -- Ungültige Sys-ID. Vergewissern Sie sich, 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. Vergewissern Sie sich, dass der Benutzer über die Administratorrolle verfügt. |
[Tabelle : 6. Statuscodes]

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

### Parameter des Antworttexts (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 |
| result.message | Fehlermeldung, in der beschrieben wird, warum der Test Runner-Fortschritt nicht abgerufen werden kann. Der Nachrichtenparameter wird in einer erfolgreichen Antwort nicht zurückgegeben. Datentyp: Zeichenfolge |
| result.progress | Ein Prozentsatz, der angibt, wie kurz der Abschluss eines Tests ist, während er ausgeführt wird. Datentyp: Zahl |
| result.state | Der aktuelle Status des BOQ-Datensatzes. Mögliche Werte: * Ausstehend: Die angeforderte Testaktivität wurde erstellt und wartet auf die Ausführung. * Wird verarbeitet -- Die Instanz scannt Datensätze, um sicherzustellen, dass die Ausführungstracker für Cloud Runner markiert sind, bevor die Anforderung an die Cloud-Infrastruktur gesendet wird. * Browser angefordert: An die Cloud-Infrastruktur wurde eine Anforderung zum Starten von Browsern für die Testgenerierung oder den Testlauf gesendet. * Wird ausgeführt -- Cloud-Infrastrukturbrowser suchen ausstehende Tests und führen sie aus. * Abgeschlossen: Die Testaufgabe ist abgeschlossen. * Status „Fehlgeschlagen" -- Die Testaufgabe ist fehlgeschlagen. {#cr-TestUserAPI-GET-test-user-progress__ul_hph_y5h_41c} Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Das folgende Anforderungsbeispiel zeigt, wie Sie den Fortschritt eines Testbenutzerauftrags überprüfen.

    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.
Mit dieser Methode wird überprüft, ob der Anwender die folgenden Kriterien erfüllt:

* Vorhanden,
* Ist aktiv,
* Ist nicht ausgesperrt,
* Passwortzurücksetzung erforderlich,
* Ist Administrator,
* Ist schreibgeschützt,
* Ist nur Webservices

### URL-Format

Standard-URL: GET /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. Pfadparameter]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__6}

| Name | Beschreibung |
|-|-|
| username | Erforderlich. Anwendername des sys_user, mit dem überprüft werden kann, ob der Anwender die folgenden Baselinekriterien erfüllt. * Vorhanden, * Ist aktiv, * Ist nicht ausgesperrt, * Passwortzurücksetzung erforderlich, * Ist 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. Anforderungstextparameter (XML oder JSON)]

### Kopfzeilen

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.").
{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__14}{#cr-TestUserAPI-GET-is_valid_cloud_user__accept-RESTAPI}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__18}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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. Vergewissern Sie sich, dass der Benutzer über die Administratorrolle verfügt. |
[Tabelle : 12. Statuscodes]

{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c}

### Parameter des Antworttexts (JSON oder XML)

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__28}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt mit den Ergebnissen der Anforderung. "result": { "validUser": Boolean } {#cr-TestUserAPI-GET-is_valid_cloud_user__codeblock_hhp_4k2_p1c} Datentyp: Objekt |
| result.validUser | Kennzeichnung, die angibt, ob der Anwender die Cloud-Anwenderkriterien erfüllt. Bei „wahr" erfüllt der Benutzer die Kriterien. Datentyp: Boolesch |
[ ]

### 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 -- POST /now/sn_atf_tg/test_user {#ariaid-title4}

Fügt einen Testanwenderauftrag in die BOQ-Tabelle \[sn_atf_tg_sn_boq\] für einen bestimmten Anwendernamen ein, der dann in 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. Pfadparameter]

{#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. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen]

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

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#cr-TestUserAPI-POST-test-user__entry__24}

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

### Parameter des Antworttexts (JSON oder XML)

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

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

### cURL-Anforderung

Das folgende Anforderungsbeispiel zeigt, wie ein Testanwenderauftrag für einen bestimmten Anwendernamen in die Tabelle „BOQ" \[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 eingefügt wird, wenn der Testanwenderauftrag startet.

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

Im folgenden Beispiel wird eine Fehlermeldung 400 zurückgegeben, wenn kein 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 -- POST /now/sn_atf_tg/cancel_test_user {#ariaid-title5}

Legt den Status des Testanwenderauftrags in der Tabelle der Browser-Orchestrationswarteschlange (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. Pfadparameter]

{#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 abzubrechenden BOQ-Datensatzes, der dem Testanwenderauftrag zugeordnet ist. Befindet sich in der SNBOQ-Tabelle \[sn_atf_tg_sn_boq\]. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder 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}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 konnte nicht gefunden werden -- Ungültige Sys-ID. Vergewissern Sie sich, 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. Vergewissern Sie sich, dass der Benutzer über die Administratorrolle verfügt. |
[Tabelle : 24. Statuscodes]

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

### Parameter des Antworttexts (JSON oder XML)

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

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt mit den Ergebnissen der Anforderung. "result": { "message": String } {#cr-TestUserAPI-POST-cancel-test-user__codeblock_hhp_4k2_p1c} Datentyp: Objekt |
| result.message | Nachricht, die beschreibt, ob der Abbruch des Testanwenders erfolgreich war. Datentyp: Zeichenfolge |
[ ]

### cURL-Anforderung

Die folgende Anforderung zeigt, wie ein Testbenutzerauftrag in der Tabelle „Browser-Orchestrationswarteschlange" \[sn_atf_tg_sn_boq\] abgebrochen wird.

    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 -- POST /now/sn_atf_tg/select_cloud_user {#ariaid-title6}

Startet einen End-to-End-Testanwenderauftrag in Cloud Runner. Wenn er sich mit der Administratorrolle anmelden kann, wird von der Cloud-Benutzereigenschaft für zukünftige Testläufe und Testgenerierungen standardmäßig dieser Benutzer 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. Pfadparameter]

{#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 zum Testen und Festlegen des Cloud-Anwenders für zukünftige Test Runner- und Testgenerierungsaufträge. Datentyp: Zeichenfolge |
[Tabelle : 27. Anforderungstextparameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST API verwendet werden, finden Sie unter [Unterstützte REST API-Header](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}

| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützte Typen: application/json oder 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}

| Kopfzeile | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 29. Antwortkopfzeilen]

### 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 [HTTP-Antwortcodes](https://www.servicenow.com/docs/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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. Vergewissern Sie sich, dass der Benutzer über die Administratorrolle verfügt. |
[Tabelle : 30. Statuscodes]

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

### Parameter des Antworttexts (JSON oder XML)

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

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt mit den Ergebnissen der Anforderung. "result": { "message": "String" } {#cr-TestUserAPI-POST-select-cloud-user__codeblock_hhp_4k2_p1c} Datentyp: Objekt |
| result.message | Nachricht, die beschreibt, 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 anfordern, dass ein bestimmter Benutzer für zukünftige Testläufe und Testgenerierungen in der Cloud Runner-Infrastruktur ausgewählt wird.

    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-Benutzer erfolgreich für Testläufe und Generierungen ausgewählt wurde.

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