Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# API zum Testen verteilter Lasten
<a name="distributed-load-testing-api"></a>

Diese Lasttestlösung hilft Ihnen dabei, Testergebnisdaten auf sichere Weise verfügbar zu machen. Die API fungiert als „Eingangstür“ für den Zugriff auf Testdaten, die in Amazon DynamoDB gespeichert sind. Sie können die auch verwenden APIs , um auf alle erweiterten Funktionen zuzugreifen, die Sie in die Lösung integriert haben.

Diese Lösung verwendet einen Amazon Cognito Cognito-Benutzerpool, der in Amazon API Gateway zur Identifizierung und Autorisierung integriert ist. Wenn ein Benutzerpool mit der API verwendet wird, dürfen Clients nur Methoden aufrufen, die vom Benutzerpool aktiviert wurden, nachdem sie ein gültiges Identitätstoken bereitgestellt haben.

Weitere Informationen zur Ausführung von Tests direkt über die API finden Sie unter [Signing Requests](https://docs.aws.amazon.com/apigateway/api-reference/signing-requests/) in der Amazon API Gateway REST API-Referenzdokumentation.

Die folgenden Operationen sind in der API der Lösung verfügbar.

**Anmerkung**  
Weitere Informationen zu `testScenario` und anderen Parametern finden Sie in den [Szenarien](https://github.com/aws-solutions/distributed-load-testing-on-aws/blob/main/source/api-services/lib/scenarios/index.js#L267) und [Payload-Beispielen](https://github.com/aws-solutions/distributed-load-testing-on-aws/blob/main/source/webui/src/pages/scenarios/CreateTestScenarioPage.tsx#L281-L388) im GitHub Repository.

 **Informationen zum Stapel** 
+  [ERHALTE /stack-info](#get-stack-info) 

 **Szenarien** 
+  [GET /scenarios](#get-scenarios) 
+  [POST /szenarien](#post-scenarios) 
+  [OPTIONEN /Szenarien](#options-scenarios) 
+  [GET /scenarios/ \$1testId\$1](#get-scenarios-testid) 
+  [POSTE /scenarios/ \$1testId\$1](#post-scenarios-testid) 
+  [LÖSCHEN SIE /scenarios/ \$1testId\$1](#delete-scenarios-testid) 
+  [OPTIONEN /scenarios/ \$1testID\$1](#options-scenarios-testid) 

 **Testläufe** 
+  [GET /scenarios/ \$1testId\$1 /testruns](#get-scenarios-testid-testruns) 
+  [GET /scenarios/ \$1testID\$1 /testruns/ \$1\$1 testRunId](#get-scenarios-testid-testruns-testrunid) 
+  [LÖSCHE /scenarios/ \$1testId\$1 /testruns/ \$1testRunId\$1](#delete-scenarios-testid-testruns-testrunid) 

 **Basislinie** 
+  [GET /scenarios/ \$1testId\$1 /baseline](#get-scenarios-testid-baseline) 
+  [GIB /scenarios/ \$1testId\$1 /baseline ein](#put-scenarios-testid-baseline) 
+  [LÖSCHEN SIE /scenarios/ \$1testId\$1 /baseline](#delete-scenarios-testid-baseline) 

 **Aufgaben** 
+  [HOLEN SIE SICH /tasks](#get-tasks) 
+  [OPTIONEN /Aufgaben](#options-tasks) 

 **Regionen** 
+  [HOLEN SIE SICH /regions](#get-regions) 
+  [OPTIONEN /regions](#options-regions) 

## ERHALTE /stack-info
<a name="get-stack-info"></a>

### Description
<a name="get-stack-info-description"></a>

Der `GET /stack-info` Vorgang ruft Informationen über den bereitgestellten Stack ab, einschließlich Erstellungszeit, Region und Version. Dieser Endpunkt wird vom Frontend verwendet.

### Antwort
<a name="get-stack-info-response"></a>

 **200 — Erfolg** 


| Name | Description | 
| --- | --- | 
|   `created_time`   |  ISO 8601-Zeitstempel, als der Stack erstellt wurde (zum Beispiel) `2025-09-09T19:40:22Z`  | 
|   `region`   |  AWS-Region, in der der Stack bereitgestellt wird (z. B.`us-east-1`)  | 
|   `version`   |  Version der bereitgestellten Lösung (z. B.`v4.0.0`)  | 

 **Antworten auf Fehler** 
+  `403`- Verboten: Unzureichende Berechtigungen für den Zugriff auf Stack-Informationen
+  `404`- Nicht gefunden: Stack-Informationen nicht verfügbar
+  `500`- Interner Serverfehler

## GET /scenarios
<a name="get-scenarios"></a>

### Description
<a name="get-scenarios-description"></a>

Die `GET /scenarios` Operation ermöglicht es Ihnen, eine Liste von Testszenarien abzurufen.

### Antwort
<a name="get-scenarios-response"></a>


| Name | Description | 
| --- | --- | 
|   `data`   |  Eine Liste von Szenarien, einschließlich der ID, des Namens, der Beschreibung, des Status, der Laufzeit, der Tags, der Gesamtzahl der Testläufe und der letzten Ausführung für jeden Test  | 

## POST /szenarien
<a name="post-scenarios"></a>

### Description
<a name="post-scenarios-description"></a>

Die `POST /scenarios` Operation ermöglicht es Ihnen, ein Testszenario zu erstellen oder zu planen.

### Anforderungstext
<a name="post-scenarios-request"></a>


| Name | Description | 
| --- | --- | 
|   `testName`   |  Der Name des Tests  | 
|   `testDescription`   |  Die Beschreibung des Tests  | 
|   `testTaskConfigs`   |  Ein Objekt, das `concurrency` (die Anzahl der parallel Läufe), `taskCount` (die Anzahl der Aufgaben, die zur Ausführung eines Tests erforderlich sind) und `region` für das Szenario angibt  | 
|   `testScenario`   |  Die Testspezifikation, einschließlich Parallelität, Testzeit, Host und Methode für den Test  | 
|   `testType`   |  Der Testtyp (zum Beispiel`simple`,`jmeter`)  | 
|   `fileType`   |  Der Upload-Dateityp (z. B.`none`,`script`,`zip`)  | 
|   `tags`   |  Eine Reihe von Zeichenketten zur Kategorisierung von Tests. Optionales Feld mit einer maximalen Länge von 5 (z. B.`["blue", "3.0", "critical"]`)  | 
|   `scheduleDate`   |  Das Datum, an dem ein Test ausgeführt werden soll. Wird nur angegeben, wenn ein Test geplant wird (z. B.`2021-02-28`)  | 
|   `scheduleTime`   |  Die Zeit, um einen Test durchzuführen. Wird nur angegeben, wenn ein Test geplant wird `21:07` (z. B.  | 
|   `scheduleStep`   |  Der Schritt im Planungsprozess. Wird nur bereitgestellt, wenn ein wiederkehrender Test geplant wird. (Zu den verfügbaren Schritten gehören `create` und`start`)  | 
|   `cronvalue`   |  Der Cron-Wert für die Anpassung der wiederkehrenden Terminplanung. Falls verwendet, lassen Sie ScheduleDate und ScheduleTime weg.  | 
|   `cronExpiryDate`   |  Erforderliches Datum, damit der Cron abläuft und nicht unbegrenzt läuft.  | 
|   `recurrence`   |  Die Wiederholung eines geplanten Tests. Wird nur bereitgestellt, wenn ein wiederkehrender Test geplant wird (z. B.`daily`, `weekly``biweekly`, oder`monthly`)  | 

### Antwort
<a name="post-scenarios-response"></a>


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die eindeutige ID des Tests  | 
|   `testName`   |  Der Name des Tests  | 
|   `status`   |  Der Status des Tests  | 

## OPTIONEN/Szenarien
<a name="options-scenarios"></a>

### Description
<a name="options-scenarios-description"></a>

Die `OPTIONS /scenarios` Operation liefert eine Antwort auf die Anfrage mit den richtigen CORS-Antwortheadern.

### Antwort
<a name="options-scenarios-response"></a>


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die eindeutige ID des Tests  | 
|   `testName`   |  Der Name des Tests  | 
|   `status`   |  Der Status des Tests  | 

## GET /scenarios/ \$1testId\$1
<a name="get-scenarios-testid"></a>

### Description
<a name="get-scenarios-testid-description"></a>

Die `GET /scenarios/{testId}` Operation ermöglicht es Ihnen, die Details eines bestimmten Testszenarios abzurufen.

### Anforderungsparameter
<a name="get-scenarios-testid-request"></a>

 `testId`   
+ Die eindeutige ID des Tests

  Typ: Zeichenfolge

  Erforderlich: Ja

 `latest`   
+ Abfrageparameter, um nur den letzten Testlauf zurückzugeben. Die Standardeinstellung ist `true` 

  Typ: Boolesch

  Erforderlich: Nein

 `history`   
+ Abfrageparameter, um den Testlaufverlauf in die Antwort aufzunehmen. Der Standardwert ist `true`. Auf einstellen, `false` um den Verlauf auszuschließen

  Typ: Boolesch

  Erforderlich: Nein

### Antwort
<a name="get-scenarios-testid-response"></a>


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die eindeutige ID des Tests  | 
|   `testName`   |  Der Name des Tests  | 
|   `testDescription`   |  Die Beschreibung des Tests  | 
|   `testType`   |  Die Art des Tests, der ausgeführt wird (z. B.`simple`,`jmeter`)  | 
|   `fileType`   |  Der Typ der Datei, die hochgeladen wird (z. B.`none`,`script`,`zip`)  | 
|   `tags`   |  Eine Reihe von Zeichenketten zur Kategorisierung von Tests  | 
|   `status`   |  Der Status des Tests  | 
|   `startTime`   |  Die Uhrzeit und das Datum, an dem der letzte Test gestartet wurde  | 
|   `endTime`   |  Uhrzeit und Datum, an dem der letzte Test beendet wurde  | 
|   `testScenario`   |  Die Testspezifikation, einschließlich Parallelität, Testzeit, Host und Methode für den Test  | 
|   `taskCount`   |  Die Anzahl der Aufgaben, die zur Ausführung des Tests erforderlich sind  | 
|   `taskIds`   |  Eine Liste von Aufgaben IDs zum Ausführen von Tests  | 
|   `results`   |  Die endgültigen Ergebnisse des Tests  | 
|   `history`   |  Eine Liste der Endergebnisse früherer Tests (ausgenommen wann`history=false`)  | 
|   `totalRuns`   |  Die Gesamtzahl der Testläufe für dieses Szenario  | 
|   `lastRun`   |  Der Zeitstempel des letzten Testlaufs  | 
|   `errorReason`   |  Eine Fehlermeldung, die generiert wird, wenn ein Fehler auftritt  | 
|   `nextRun`   |  Der nächste geplante Lauf (zum Beispiel`2017-04-22 17:18:00`)  | 
|   `scheduleRecurrence`   |  Die Wiederholung des Tests (z. B.,`daily`, `weekly``biweekly`,`monthly`)  | 

## POST /scenarios/ \$1TestID\$1
<a name="post-scenarios-testid"></a>

### Description
<a name="post-scenarios-testid-description"></a>

Der `POST /scenarios/{testId}` Vorgang ermöglicht es Ihnen, ein bestimmtes Testszenario abzubrechen.

### Parameter anfordern
<a name="post-scenarios-testid-request"></a>

 `testId`   
+ Die eindeutige ID des Tests

  Typ: Zeichenfolge

  Erforderlich: Ja

### Antwort
<a name="post-scenarios-testid-response"></a>


| Name | Description | 
| --- | --- | 
|   `status`   |  Der Status des Tests  | 

## LÖSCHEN SIE /scenarios/ \$1testId\$1
<a name="delete-scenarios-testid"></a>

### Description
<a name="delete-scenarios-testid-description"></a>

Die `DELETE /scenarios/{testId}` Operation ermöglicht es Ihnen, alle Daten zu löschen, die sich auf ein bestimmtes Testszenario beziehen.

### Parameter anfordern
<a name="delete-scenarios-testid-request"></a>

 `testId`   
+ Die eindeutige ID des Tests

  Typ: Zeichenfolge

  Erforderlich: Ja

### Antwort
<a name="delete-scenarios-testid-response"></a>


| Name | Description | 
| --- | --- | 
|   `status`   |  Der Status des Tests  | 

## OPTIONEN /scenarios/ \$1testId\$1
<a name="options-scenarios-testid"></a>

### Description
<a name="options-scenarios-testid-description"></a>

Die `OPTIONS /scenarios/{testId}` Operation liefert eine Antwort auf die Anfrage mit den richtigen CORS-Antwortheadern.

### Antwort
<a name="options-scenarios-testid-response"></a>


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die eindeutige ID des Tests  | 
|   `testName`   |  Der Name des Tests  | 
|   `testDescription`   |  Die Beschreibung des Tests  | 
|   `testType`   |  Die Art des Tests, der ausgeführt wird (z. B.`simple`,`jmeter`)  | 
|   `fileType`   |  Der Typ der Datei, die hochgeladen wird (z. B.`none`,`script`,`zip`)  | 
|   `status`   |  Der Status des Tests  | 
|   `startTime`   |  Die Uhrzeit und das Datum, an dem der letzte Test gestartet wurde  | 
|   `endTime`   |  Uhrzeit und Datum, an dem der letzte Test beendet wurde  | 
|   `testScenario`   |  Die Testspezifikation, einschließlich Parallelität, Testzeit, Host und Methode für den Test  | 
|   `taskCount`   |  Die Anzahl der Aufgaben, die zur Ausführung des Tests erforderlich sind  | 
|   `taskIds`   |  Eine Liste von Aufgaben IDs zum Ausführen von Tests  | 
|   `results`   |  Die endgültigen Ergebnisse des Tests  | 
|   `history`   |  Eine Liste der Endergebnisse vergangener Tests  | 
|   `errorReason`   |  Eine Fehlermeldung, die generiert wird, wenn ein Fehler auftritt  | 

## GET /scenarios/ \$1testId\$1 /testruns
<a name="get-scenarios-testid-testruns"></a>

### Description
<a name="get-scenarios-testid-testruns-description"></a>

Der `GET /scenarios/{testId}/testruns` Vorgang ruft einen Testlauf IDs für ein bestimmtes Testszenario ab, optional gefiltert nach Zeitbereich. Wann`latest=true`, gibt nur den letzten Testlauf zurück.

### Anforderungsparameter
<a name="get-scenarios-testid-testruns-request"></a>

 `testId`   
+ Die ID des Testszenarios

  Typ: Zeichenfolge

  Erforderlich: Ja

 `latest`   
+ Gibt nur die letzte Testlauf-ID zurück

  Typ: Boolescher Wert

  Standard: `false` 

  Erforderlich: Nein

 `start_timestamp`   
+ ISO 8601-Zeitstempel zum Filtern von Testläufen (einschließlich). Beispiel: `2024-01-01T00:00:00Z` 

  Typ: Zeichenfolge (Datums-/Uhrzeitformat)

  Erforderlich: Nein

 `end_timestamp`   
+ ISO 8601-Zeitstempel zum Filtern von Testläufen bis (einschließlich). Beispiel: `2024-12-31T23:59:59Z` 

  Typ: Zeichenfolge (Datums-/Uhrzeitformat)

  Erforderlich: Nein

 `limit`   
+ Maximale Anzahl zurückzugebender Testläufe (wird ignoriert, wenn) `latest=true`

  Typ: Integer (mindestens: 1, maximal: 100)

  Standard: `20` 

  Erforderlich: Nein

 `next_token`   
+ Paginierungstoken aus der vorherigen Antwort, um die nächste Seite zu erhalten

  Typ: Zeichenfolge

  Erforderlich: Nein

### Antwort
<a name="get-scenarios-testid-testruns-response"></a>

 **200 — Erfolg** 


| Name | Description | 
| --- | --- | 
|   `testRuns`   |  Array von Testlaufobjekten, die jeweils `testRunId` (Zeichenfolge) und `startTime` (ISO 8601 Datum/Uhrzeit) enthalten  | 
|   `pagination`   |  Objekt, das `limit` (Ganzzahl) und `next_token` (Zeichenfolge oder Null) enthält. Das Token ist Null, wenn keine weiteren Ergebnisse vorliegen  | 

 **Antworten auf Fehler** 
+  `400`- Ungültiges Zeitstempelformat oder ungültige Parameter
+  `404`- Das Testszenario wurde nicht gefunden
+  `500`- Interner Serverfehler

### Beispielverwendung
<a name="get-scenarios-testid-testruns-examples"></a>
+ Nur letzter Testlauf: `GET /scenarios/test123/testruns?latest=true` 
+ Spätester innerhalb des Zeitbereichs: `GET /scenarios/test123/testruns?latest=true&start_timestamp=2024-01-01T00:00:00Z` 
+ Anfrage zur nächsten Seite: `GET /scenarios/test123/testruns?limit=20&next_token=eyJ0ZXN0SWQiOiJzZVFVeTEyTEtMIiwic3RhcnRUaW1lIjoiMjAyNC0wMS0xM1QxNjo0NTowMFoifQ==` 

## GET /scenarios/ \$1testId\$1 /testruns/ \$1\$1 testRunId
<a name="get-scenarios-testid-testruns-testrunid"></a>

### Description
<a name="get-scenarios-testid-testruns-testrunid-description"></a>

Der `GET /scenarios/{testId}/testruns/{testRunId}` Vorgang ruft vollständige Ergebnisse und Metriken für einen bestimmten Testlauf ab. Lassen Sie optional Verlaufsergebnisse aus, um schneller reagieren `history=false` zu können.

### Anforderungsparameter
<a name="get-scenarios-testid-testruns-testrunid-request"></a>

 `testId`   
+ Die ID des Testszenarios

  Typ: Zeichenfolge

  Erforderlich: Ja

 `testRunId`   
+ Die spezifische Testlauf-ID

  Typ: Zeichenfolge

  Erforderlich: Ja

 `history`   
+ Schließt das Verlaufs-Array als Antwort ein. Stellen Sie auf ein`false`, um den Verlauf für eine schnellere Antwort auszulassen

  Typ: Boolescher Wert

  Standard: `true` 

  Erforderlich: Nein

### Antwort
<a name="get-scenarios-testid-testruns-testrunid-response"></a>

 **200 — Erfolgreich** 


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die eindeutige ID des Tests (zum Beispiel`seQUy12LKL`)  | 
|   `testRunId`   |  Die spezifische Testlauf-ID (z. B.`2DEwHItEne`)  | 
|   `testDescription`   |  Beschreibung des Belastungstests  | 
|   `testType`   |  Die Art des Tests (z. B.`simple`,`jmeter`)  | 
|   `status`   |  Der Status des Testlaufs: `complete``running`,`failed`, oder `cancelled`   | 
|   `startTime`   |  Die Uhrzeit und das Datum, an dem der Test gestartet wurde (z. B.`2025-09-09 21:01:00`)  | 
|   `endTime`   |  Uhrzeit und Datum, an dem der Test beendet wurde (z. B.`2025-09-09 21:18:29`)  | 
|   `succPercent`   |  Erfolgsquote (zum Beispiel`100.00`)  | 
|   `testTaskConfigs`   |  Array von Aufgabenkonfigurationsobjekten`region`, die`taskCount`, und enthalten `concurrency`   | 
|   `completeTasks`   |  Objekte ordnen Regionen der Anzahl abgeschlossener Aufgaben zu  | 
|   `results`   |  Objekt mit detaillierten Kennzahlen wie `avg_lt` (durchschnittliche Latenz), Perzentile (`p0_0`,,,,`p50_0`,`p90_0`,`p100_0`) `p95_0` `p99_0``p99_9`, `avg_rt` (durchschnittliche Reaktionszeit), (durchschnittliche Verbindungszeit), `avg_ct` (durchschnittliche Verbindungszeit), `stdev_rt` (Reaktionszeit mit Standardabweichung),, `concurrency``throughput`, `succ` (Anzahl der Erfolge), `fail` (Anzahl der Fehler),,, `bytes` `testDuration``metricS3Location`, `rc` (Antwortcode-Array) und Array `labels`  | 
|   `testScenario`   |  Objekt, das eine Testkonfiguration mit Eigenschaften`execution`, und `reporting` enthält `scenarios`  | 
|   `history`   |  Array mit historischen Testergebnissen (ausgenommen wann`history=false`)  | 

 **Antworten auf Fehler** 
+  `400`- Ungültige TestID oder testRunId
+  `404`- Testlauf nicht gefunden
+  `500`- Interner Serverfehler

## LÖSCHEN Sie /scenarios/ \$1testId\$1 /testruns/ \$1\$1 testRunId
<a name="delete-scenarios-testid-testruns-testrunid"></a>

### Description
<a name="delete-scenarios-testid-testruns-testrunid-description"></a>

Der `DELETE /scenarios/{testId}/testruns/{testRunId}` Vorgang löscht alle Daten und Artefakte, die sich auf einen bestimmten Testlauf beziehen. Die Testlaufdaten werden aus DynamoDB entfernt, während die tatsächlichen Testdaten in S3 unverändert bleiben.

### Anforderungsparameter
<a name="delete-scenarios-testid-testruns-testrunid-request"></a>

 `testId`   
+ Die ID des Testszenarios

  Typ: Zeichenfolge

  Erforderlich: Ja

 `testRunId`   
+ Die spezifische Testlauf-ID, die gelöscht werden soll

  Typ: Zeichenfolge

  Erforderlich: Ja

### Antwort
<a name="delete-scenarios-testid-testruns-testrunid-response"></a>

 **204 — Erfolgreich** 

Testlauf wurde erfolgreich gelöscht (es wurde kein Inhalt zurückgegeben)

 **Antworten auf Fehler** 
+  `400`- Ungültige TestID oder testRunId
+  `403`- Verboten: Unzureichende Berechtigungen zum Löschen des Testlaufs
+  `404`- Testlauf nicht gefunden
+  `409`- Konflikt: Der Testlauf läuft gerade und kann nicht gelöscht werden
+  `500`- Interner Serverfehler

## GET /scenarios/ \$1testId\$1 /baseline
<a name="get-scenarios-testid-baseline"></a>

### Description
<a name="get-scenarios-testid-baseline-description"></a>

Der `GET /scenarios/{testId}/baseline` Vorgang ruft das angegebene Baseline-Testergebnis für ein Szenario ab. Gibt je nach `data` Parameter entweder die ID des Ausgangstestlaufs oder die vollständigen Baseline-Ergebnisse zurück.

### Anforderungsparameter
<a name="get-scenarios-testid-baseline-request"></a>

 `testId`   
+ Die ID des Testszenarios

  Typ: Zeichenfolge

  Erforderlich: Ja

 `data`   
+ Gibt die vollständigen Basisdaten des Testlaufs zurück`true`, wenn, andernfalls nur testRunId

  Typ: Boolescher Wert

  Standard: `false` 

  Erforderlich: Nein

### Antwort
<a name="get-scenarios-testid-baseline-response"></a>

 **200 — Erfolgreich** 

Wann `data=false` (Standard):


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die ID des Testszenarios (zum Beispiel`seQUy12LKL`)  | 
|   `baselineTestRunId`   |  Die ID des Ausgangstestlaufs (z. B.`2DEwHItEne`)  | 

Wann`data=true`:


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die ID des Testszenarios (zum Beispiel`seQUy12LKL`)  | 
|   `baselineTestRunId`   |  Die ID des Ausgangstestlaufs (z. B.`2DEwHItEne`)  | 
|   `baselineData`   |  Vollständiges Objekt mit den Ergebnissen des Testlaufs (gleiche Struktur wie`GET /scenarios/{testId}/testruns/{testRunId}`)  | 

 **Antworten auf Fehler** 
+  `400`- Ungültiger TestID-Parameter
+  `404`- Das Testszenario wurde nicht gefunden oder es wurde kein Basiswert festgelegt
+  `500`- Interner Serverfehler

## PUT /scenarios/ \$1TestId\$1 /baseline
<a name="put-scenarios-testid-baseline"></a>

### Description
<a name="put-scenarios-testid-baseline-description"></a>

Der `PUT /scenarios/{testId}/baseline` Vorgang legt einen bestimmten Testlauf als Grundlage für den Leistungsvergleich fest. Pro Szenario kann nur eine Basislinie festgelegt werden.

### Anforderungsparameter
<a name="put-scenarios-testid-baseline-request"></a>

 `testId`   
+ Die ID des Testszenarios

  Typ: Zeichenfolge

  Erforderlich: Ja

### Anforderungstext
<a name="put-scenarios-testid-baseline-request-body"></a>


| Name | Description | 
| --- | --- | 
|   `testRunId`   |  Die Testlauf-ID, die als Ausgangswert festgelegt werden soll (z. B.`2DEwHItEne`)  | 

### Antwort
<a name="put-scenarios-testid-baseline-response"></a>

 **200 — Erfolgreich** 


| Name | Description | 
| --- | --- | 
|   `message`   |  Bestätigungsnachricht (zum Beispiel`Baseline set successfully`)  | 
|   `testId`   |  Die ID des Testszenarios (zum Beispiel`seQUy12LKL`)  | 
|   `baselineTestRunId`   |  Die eingestellte Baseline-Testlauf-ID (z. B.`2DEwHItEne`)  | 

 **Antworten auf Fehler** 
+  `400`- Ungültige TestID oder testRunId
+  `404`- Testszenario oder Testlauf nicht gefunden
+  `409`- Konflikt: Der Testlauf kann nicht als Ausgangswert festgelegt werden (z. B. fehlgeschlagener Test)
+  `500`- Interner Serverfehler

## LÖSCHEN Sie /scenarios/ \$1testId\$1 /baseline
<a name="delete-scenarios-testid-baseline"></a>

### Description
<a name="delete-scenarios-testid-baseline-description"></a>

Die `DELETE /scenarios/{testId}/baseline` Operation löscht den Basiswert für ein Szenario, indem er auf eine leere Zeichenfolge gesetzt wird.

### Anforderungsparameter
<a name="delete-scenarios-testid-baseline-request"></a>

 `testId`   
+ Die ID des Testszenarios

  Typ: Zeichenfolge

  Erforderlich: Ja

### Antwort
<a name="delete-scenarios-testid-baseline-response"></a>

 **204 — Erfolg** 

Baseline wurde erfolgreich gelöscht (es wurde kein Inhalt zurückgegeben)

 **Antworten auf Fehler** 
+  `400`- Ungültige TestID
+  `500`- Interner Serverfehler

## GET /tasks
<a name="get-tasks"></a>

### Description
<a name="get-tasks-description"></a>

Mit `GET /tasks` diesem Vorgang können Sie eine Liste der laufenden Amazon Elastic Container Service (Amazon ECS) -Aufgaben abrufen.

### Antwort
<a name="get-tasks-response"></a>


| Name | Description | 
| --- | --- | 
|   `tasks`   |  Eine Liste von Aufgaben IDs zum Ausführen von Tests  | 

## OPTIONEN/Aufgaben
<a name="options-tasks"></a>

### Description
<a name="options-tasks-description"></a>

Der Vorgang `OPTIONS /tasks` tasks liefert eine Antwort auf die Anfrage mit den richtigen CORS-Antwortheadern.

### Antwort
<a name="options-tasks-response"></a>


| Name | Description | 
| --- | --- | 
|   `taskIds`   |  Eine Liste von Aufgaben IDs zum Ausführen von Tests  | 

## GET /regions
<a name="get-regions"></a>

### Description
<a name="get-regions-description"></a>

Mit diesem `GET /regions` Vorgang können Sie die regionalen Ressourceninformationen abrufen, die für die Durchführung eines Tests in dieser Region erforderlich sind.

### Antwort
<a name="get-regions-response"></a>


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die Regions-ID  | 
|   `ecsCloudWatchLogGroup`   |  Der Name der CloudWatch Amazon-Protokollgruppe für die Amazon Fargate-Aufgaben in der Region  | 
|   `region`   |  Die Region, in der die Ressourcen in der Tabelle existieren  | 
|   `subnetA`   |  Die ID eines der Subnetze in der Region  | 
|   `subnetB`   |  Die ID eines der Subnetze in der Region  | 
|   `taskCluster`   |  Der Name des AWS Fargate-Clusters in der Region  | 
|   `taskDefinition`   |  Der ARN der Aufgabendefinition in der Region  | 
|   `taskImage`   |  Der Name des Task-Images in der Region  | 
|   `taskSecurityGroup`   |  Die ID der Sicherheitsgruppe in der Region  | 

## OPTIONEN /Regionen
<a name="options-regions"></a>

### Description
<a name="options-regions-description"></a>

Der `OPTIONS /regions` Vorgang liefert eine Antwort auf die Anfrage mit den richtigen CORS-Antwortheadern.

### Antwort
<a name="options-regions-response"></a>


| Name | Description | 
| --- | --- | 
|   `testId`   |  Die Regions-ID  | 
|   `ecsCloudWatchLogGroup`   |  Der Name der CloudWatch Amazon-Protokollgruppe für die Amazon Fargate-Aufgaben in der Region  | 
|   `region`   |  Die Region, in der die Ressourcen in der Tabelle existieren  | 
|   `subnetA`   |  Die ID eines der Subnetze in der Region  | 
|   `subnetB`   |  Die ID eines der Subnetze in der Region  | 
|   `taskCluster`   |  Der Name des AWS Fargate-Clusters in der Region  | 
|   `taskDefinition`   |  Der ARN der Aufgabendefinition in der Region  | 
|   `taskImage`   |  Der Name des Task-Images in der Region  | 
|   `taskSecurityGroup`   |  Die ID der Sicherheitsgruppe in der Region  |