GET /scenarios POST /scenari OPZIONI/scenari GET /scenarios/ {testID}POST /scenarios/ {testID}DELETE /scenarios/ {testID}OPZIONI /scenarios/ {testID}OTTIENI /tasks OPZIONI/task GET /regions OPZIONI/regioni

API di test di carico distribuita

Questa soluzione di test di carico consente di esporre i dati dei risultati del test in modo sicuro. L'API funge da «porta d'ingresso» per l'accesso ai dati di test archiviati in Amazon DynamoDB. Puoi anche utilizzare il APIs per accedere a qualsiasi funzionalità estesa incorporata nella soluzione.

Questa soluzione utilizza un pool di utenti Amazon Cognito integrato con Amazon API Gateway per l'identificazione e l'autorizzazione. Quando un pool di utenti viene utilizzato con l'API, i client possono chiamare i metodi attivati dal pool di utenti solo dopo aver fornito un token di identità valido.

Per ulteriori informazioni sull'esecuzione dei test direttamente tramite l'API, consulta Signing Requests nella documentazione di riferimento dell'API REST di Amazon API Gateway.

Le seguenti operazioni sono disponibili nell'API della soluzione.

Nota

Per ulteriori informazioni testScenario e altri parametri, consulta gli scenari e gli esempi di payload nel GitHub repository.

Scenari

GET /scenarios
POST /scenari
OPZIONI/scenari
OTTIENI /scenarios/ {testID}
PUBBLICA /scenarios/ {testID}
ELIMINA /scenarios/ {testID}
OPZIONI /scenarios/ {testID}

Attività

OTTIENI /tasks
OPZIONI /tasks

Regioni

GET /regions
OPZIONI/regioni

`GET /scenarios`

Descrizione

L'GET /scenariosoperazione consente di recuperare un elenco di scenari di test.

Risposta

Nome	Descrizione
`data`	Un elenco di scenari che include l'ID, il nome, la descrizione, lo stato e il tempo di esecuzione per ogni test

POST /scenari

Descrizione

L'POST /scenariosoperazione consente di creare o pianificare uno scenario di test.

Corpo della richiesta

Nome	Descrizione
`testName`	Il nome del test
`testDescription`	La descrizione del test
`testTaskConfigs`	Un oggetto che specifica `concurrency` (il numero di esecuzioni parallele), `taskCount` (il numero di attività necessarie `region` per eseguire un test) e lo scenario
`testScenario`	La definizione del test che include concorrenza, tempo di test, host e metodo per il test
`testType`	Il tipo di test (ad esempio`simple`,`jmeter`)
`fileType`	Il tipo di file da caricare (ad esempio`none`,`script`,`zip`)
`scheduleDate`	La data in cui eseguire un test. Fornito solo se si pianifica un test (ad esempio,`2021-02-28`)
`scheduleTime`	Il tempo necessario per eseguire un test. Fornito solo se si pianifica un test (ad esempio,`21:07`)
`scheduleStep`	Fase del processo di pianificazione. Fornito solo se si pianifica un test ricorrente. (I passaggi disponibili includono e) `create` `start`
`cronvalue`	Il valore cron per personalizzare la pianificazione ricorrente. Se usato, ometti ScheduleDate e ScheduleTime.
`cronExpiryDate`	Data obbligatoria in modo che il cron scada e non venga eseguito all'infinito.
`recurrence`	La ricorrenza di un test programmato. Fornito solo se si pianifica un test ricorrente (ad esempio,,, `daily` o) `weekly` `biweekly` `monthly`

Risposta

Nome	Descrizione
`testId`	L'ID univoco del test
`testName`	Il nome del test
`status`	Lo stato del test

OPZIONI/scenari

Descrizione

L'OPTIONS /scenariosoperazione fornisce una risposta alla richiesta con le intestazioni di risposta CORS corrette.

Risposta

Nome	Descrizione
`testId`	L'ID univoco del test
`testName`	Il nome del test
`status`	Lo stato del test

GET /scenarios/ {testID}

Descrizione

L'GET /scenarios/{testId}operazione consente di recuperare i dettagli di uno scenario di test specifico.

Parametro di richiesta

testId

L'ID univoco del test

Tipo: stringa

Campo obbligatorio: sì

Risposta

Nome	Descrizione
`testId`	L'ID univoco del test
`testName`	Il nome del test
`testDescription`	La descrizione del test
`testType`	Il tipo di test che viene eseguito (ad esempio`simple`,`jmeter`)
`fileType`	Il tipo di file che viene caricato (ad esempio`none`,`script`,`zip`)
`status`	Lo stato del test
`startTime`	L'ora e la data di inizio dell'ultimo test
`endTime`	L'ora e la data in cui è terminato l'ultimo test
`testScenario`	La definizione del test che include concorrenza, ora del test, host e metodo per il test
`taskCount`	Il numero di attività necessarie per eseguire il test
`taskIds`	Un elenco di attività IDs per l'esecuzione dei test
`results`	I risultati finali del test
`history`	Un elenco dei risultati finali dei test precedenti
`errorReason`	Un messaggio di errore generato quando si verifica un errore
`nextRun`	La prossima esecuzione pianificata (ad esempio,`2017-04-22 17:18:00`)
`scheduleRecurrence`	La ricorrenza del test (ad esempio,,, `dailyweekly`,`biweekly`) `monthly`

POST /scenarios/ {testID}

Descrizione

L'POST /scenarios/{testId}operazione consente di annullare uno scenario di test specifico.

Parametro di richiesta

testId

L'ID univoco del test

Tipo: stringa

Campo obbligatorio: sì

Risposta

Nome	Descrizione
`status`	Lo stato del test

DELETE /scenarios/ {testID}

Descrizione

L'DELETE /scenarios/{testId}operazione consente di eliminare tutti i dati relativi a uno scenario di test specifico.

Parametro di richiesta

testId

L'ID univoco del test

Tipo: stringa

Campo obbligatorio: sì

Risposta

Nome	Descrizione
`status`	Lo stato del test

OPZIONI /scenarios/ {testID}

Descrizione

L'OPTIONS /scenarios/{testId}operazione fornisce una risposta alla richiesta con le intestazioni di risposta CORS corrette.

Risposta

Nome	Descrizione
`testId`	L'ID univoco del test
`testName`	Il nome del test
`testDescription`	La descrizione del test
`testType`	Il tipo di test che viene eseguito (ad esempio`simple`,`jmeter`)
`fileType`	Il tipo di file che viene caricato (ad esempio`none`,`script`,`zip`)
`status`	Lo stato del test
`startTime`	L'ora e la data di inizio dell'ultimo test
`endTime`	L'ora e la data in cui è terminato l'ultimo test
`testScenario`	La definizione del test che include concorrenza, ora del test, host e metodo per il test
`taskCount`	Il numero di attività necessarie per eseguire il test
`taskIds`	Un elenco di attività IDs per l'esecuzione dei test
`results`	I risultati finali del test
`history`	Un elenco dei risultati finali dei test precedenti
`errorReason`	Un messaggio di errore generato quando si verifica un errore

OTTIENI /tasks

Descrizione

L'GET /tasksoperazione consente di recuperare un elenco di attività Amazon Elastic Container Service (Amazon ECS) in esecuzione.

Risposta

Nome	Descrizione
`tasks`	Un elenco di attività IDs per l'esecuzione dei test

OPZIONI/task

Descrizione

L'operazione OPTIONS /tasks tasks fornisce una risposta alla richiesta con le intestazioni di risposta CORS corrette.

Risposta

Nome	Descrizione
`taskIds`	Un elenco di attività IDs per l'esecuzione dei test

GET /regions

Descrizione

L'GET /regionsoperazione consente di recuperare le informazioni sulle risorse regionali necessarie per eseguire un test in quella regione.

Risposta

Nome	Descrizione
`testId`	L'ID della regione
`ecsCloudWatchLogGroup`	Il nome del gruppo di CloudWatch log di Amazon per le attività di Amazon Fargate nella regione
`region`	La regione in cui esistono le risorse della tabella
`subnetA`	L'ID di una delle sottoreti della regione
`subnetB`	L'ID di una delle sottoreti nella regione
`taskCluster`	Il nome del cluster AWS Fargate nella regione
`taskDefinition`	L'ARN della definizione dell'attività nella regione
`taskImage`	Il nome dell'immagine dell'attività nella regione
`taskSecurityGroup`	L'ID del gruppo di sicurezza nella regione

OPZIONI/regioni

Descrizione

L'OPTIONS /regionsoperazione fornisce una risposta alla richiesta con le intestazioni di risposta CORS corrette.

Risposta

Nome	Descrizione
`testId`	L'ID della regione
`ecsCloudWatchLogGroup`	Il nome del gruppo di CloudWatch log di Amazon per le attività di Amazon Fargate nella regione
`region`	La regione in cui esistono le risorse della tabella
`subnetA`	L'ID di una delle sottoreti della regione
`subnetB`	L'ID di una delle sottoreti nella regione
`taskCluster`	Il nome del cluster AWS Fargate nella regione
`taskDefinition`	L'ARN della definizione dell'attività nella regione
`taskImage`	Il nome dell'immagine dell'attività nella regione
`taskSecurityGroup`	L'ID del gruppo di sicurezza nella regione

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Personalizzazione dell'immagine del contenitore

Aumenta le risorse del contenitore