As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
API de teste de carga distribuída
Essa solução de teste de carga ajuda você a expor os dados dos resultados do teste de maneira segura. A API atua como uma “porta de entrada” para acesso aos dados de teste armazenados no Amazon DynamoDB. Você também pode usar o APIs para acessar qualquer funcionalidade estendida incorporada à solução.
Essa solução usa um grupo de usuários do Amazon Cognito integrado ao Amazon API Gateway para identificação e autorização. Quando um grupo de usuários é usado com a API, os clientes só podem chamar métodos ativados do grupo de usuários depois de fornecerem um token de identidade válido.
Para obter mais informações sobre a execução de testes diretamente por meio da API, consulte Solicitações de assinatura na documentação de referência da API REST do Amazon API Gateway.
As operações a seguir estão disponíveis na API da solução.
nota
Para obter mais informações testScenario e outros parâmetros, consulte cenários
Cenários
Tarefas
Regiões
GET /scenarios
          
            Descrição
A GET /scenarios operação permite que você recupere uma lista de cenários de teste.
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            Uma lista de cenários, incluindo ID, nome, descrição, status e tempo de execução de cada teste  | 
                     
POST /cenários
Descrição
A POST /scenarios operação permite criar ou agendar um cenário de teste.
Corpo da solicitação
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O nome do teste  | 
                     
| 
                            
                                | 
                        
                            A descrição do teste  | 
                     
| 
                            
                                | 
                        
                            Um objeto que especifica   | 
                     
| 
                            
                                | 
                        
                            A definição do teste, incluindo simultaneidade, horário do teste, host e método para o teste  | 
                     
| 
                            
                                | 
                        
                            O tipo de teste (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            O tipo de arquivo de upload (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            A data para realizar um teste. Fornecido somente ao agendar um teste (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            A hora de fazer um teste. Fornecido somente ao agendar um teste (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            A etapa do processo de agendamento. Fornecido somente ao agendar um teste recorrente. (As etapas disponíveis incluem   | 
                     
| 
                            
                                | 
                        
                            O valor cron para personalizar o agendamento recorrente. Se usado, omita ScheduleDate e ScheduleTime.  | 
                     
| 
                            
                                | 
                        
                            Data obrigatória para que o cron expire e não seja executado indefinidamente.  | 
                     
| 
                            
                                | 
                        
                            A recorrência de um teste agendado. Fornecido somente ao agendar um teste recorrente (por exemplo,,  | 
                     
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O ID exclusivo do teste  | 
                     
| 
                            
                                | 
                        
                            O nome do teste  | 
                     
| 
                            
                                | 
                        
                            O status do teste  | 
                     
OPÇÕES/CENÁRIOS
Descrição
A OPTIONS /scenarios operação fornece uma resposta para a solicitação com os cabeçalhos de resposta CORS corretos.
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O ID exclusivo do teste  | 
                     
| 
                            
                                | 
                        
                            O nome do teste  | 
                     
| 
                            
                                | 
                        
                            O status do teste  | 
                     
GET /scenarios/ {testId}
Descrição
A GET /scenarios/{testId} operação permite que você recupere os detalhes de um cenário de teste específico.
Parâmetro de solicitação
- 
                     
testId - 
                     
- 
                           
O ID exclusivo do teste
Tipo: string
Obrigatório: Sim
 
 - 
                           
 
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O ID exclusivo do teste  | 
                     
| 
                            
                                | 
                        
                            O nome do teste  | 
                     
| 
                            
                                | 
                        
                            A descrição do teste  | 
                     
| 
                            
                                | 
                        
                            O tipo de teste executado (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            O tipo de arquivo que é carregado (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            O status do teste  | 
                     
| 
                            
                                | 
                        
                            A hora e a data em que o último teste começou  | 
                     
| 
                            
                                | 
                        
                            A hora e a data em que o último teste terminou  | 
                     
| 
                            
                                | 
                        
                            A definição do teste, incluindo simultaneidade, horário do teste, host e método para o teste  | 
                     
| 
                            
                                | 
                        
                            O número de tarefas necessárias para executar o teste  | 
                     
| 
                            
                                | 
                        
                            Uma lista de tarefas IDs para executar testes  | 
                     
| 
                            
                                | 
                        
                            Os resultados finais do teste  | 
                     
| 
                            
                                | 
                        
                            Uma lista dos resultados finais dos testes anteriores  | 
                     
| 
                            
                                | 
                        
                            Uma mensagem de erro gerada quando ocorre um erro  | 
                     
| 
                            
                                | 
                        
                            A próxima execução programada (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            A recorrência do teste (por exemplo,,  | 
                     
POST /scenarios/ {testId}
Descrição
A POST /scenarios/{testId} operação permite cancelar um cenário de teste específico.
Parâmetro de solicitação
- 
                     
testId - 
                     
- 
                           
O ID exclusivo do teste
Tipo: string
Obrigatório: Sim
 
 - 
                           
 
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O status do teste  | 
                     
EXCLUIR /scenarios/ {testId}
Descrição
A DELETE /scenarios/{testId} operação permite que você exclua todos os dados relacionados a um cenário de teste específico.
Parâmetro de solicitação
- 
                     
testId - 
                     
- 
                           
O ID exclusivo do teste
Tipo: string
Obrigatório: Sim
 
 - 
                           
 
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O status do teste  | 
                     
OPÇÕES /cenários/ {testId}
Descrição
A OPTIONS /scenarios/{testId} operação fornece uma resposta para a solicitação com os cabeçalhos de resposta CORS corretos.
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O ID exclusivo do teste  | 
                     
| 
                            
                                | 
                        
                            O nome do teste  | 
                     
| 
                            
                                | 
                        
                            A descrição do teste  | 
                     
| 
                            
                                | 
                        
                            O tipo de teste executado (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            O tipo de arquivo que é carregado (por exemplo,  | 
                     
| 
                            
                                | 
                        
                            O status do teste  | 
                     
| 
                            
                                | 
                        
                            A hora e a data em que o último teste começou  | 
                     
| 
                            
                                | 
                        
                            A hora e a data em que o último teste terminou  | 
                     
| 
                            
                                | 
                        
                            A definição do teste, incluindo simultaneidade, horário do teste, host e método para o teste  | 
                     
| 
                            
                                | 
                        
                            O número de tarefas necessárias para executar o teste  | 
                     
| 
                            
                                | 
                        
                            Uma lista de tarefas IDs para executar testes  | 
                     
| 
                            
                                | 
                        
                            Os resultados finais do teste  | 
                     
| 
                            
                                | 
                        
                            Uma lista dos resultados finais dos testes anteriores  | 
                     
| 
                            
                                | 
                        
                            Uma mensagem de erro gerada quando ocorre um erro  | 
                     
GET /tasks
Descrição
A GET /tasks operação permite que você recupere uma lista de tarefas em execução do Amazon Elastic Container Service (Amazon ECS).
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            Uma lista de tarefas IDs para executar testes  | 
                     
OPÇÕES/tarefas
Descrição
A operação de OPTIONS /tasks tarefas fornece uma resposta para a solicitação com os cabeçalhos de resposta CORS corretos.
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            Uma lista de tarefas IDs para executar testes  | 
                     
GET /regiões
Descrição
A GET /regions operação permite que você recupere as informações de recursos regionais necessárias para executar um teste nessa região.
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O ID da região  | 
                     
| 
                            
                                | 
                        
                            O nome do grupo de CloudWatch registros da Amazon para as tarefas do Amazon Fargate na região  | 
                     
| 
                            
                                | 
                        
                            A região na qual existem os recursos na tabela  | 
                     
| 
                            
                                | 
                        
                            O ID de uma das sub-redes na região  | 
                     
| 
                            
                                | 
                        
                            O ID de uma das sub-redes na região  | 
                     
| 
                            
                                | 
                        
                            O nome do cluster AWS Fargate na região  | 
                     
| 
                            
                                | 
                        
                            O ARN da definição da tarefa na região  | 
                     
| 
                            
                                | 
                        
                            O nome da imagem da tarefa na Região  | 
                     
| 
                            
                                | 
                        
                            O ID do grupo de segurança na região  | 
                     
OPÇÕES/REGIÕES
Descrição
A OPTIONS /regions operação fornece uma resposta para a solicitação com os cabeçalhos de resposta CORS corretos.
Resposta
| Nome | Descrição | 
|---|---|
| 
                            
                                | 
                        
                            O ID da região  | 
                     
| 
                            
                                | 
                        
                            O nome do grupo de CloudWatch registros da Amazon para as tarefas do Amazon Fargate na região  | 
                     
| 
                            
                                | 
                        
                            A região na qual existem os recursos na tabela  | 
                     
| 
                            
                                | 
                        
                            O ID de uma das sub-redes na região  | 
                     
| 
                            
                                | 
                        
                            O ID de uma das sub-redes na região  | 
                     
| 
                            
                                | 
                        
                            O nome do cluster AWS Fargate na região  | 
                     
| 
                            
                                | 
                        
                            O ARN da definição da tarefa na região  | 
                     
| 
                            
                                | 
                        
                            O nome da imagem da tarefa na Região  | 
                     
| 
                            
                                | 
                        
                            O ID do grupo de segurança na região  |