CreateBenchmarkTask - Platform For AI: Central de Documentação do Alibaba Cloud

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

eas:CreateBenchmarkTask

*BenchmarkTask

acs:eas:{#regionId}:{#accountId}:benchmarktask/*

Nenhuma

Sintaxe da solicitação

POST /api/v2/benchmark-tasks HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	string	Não	Os parâmetros de configuração da tarefa de teste de estresse.	{ "base": { "duration": 600 }, "service": { "serviceName": "test_service", "requestToken": "test_token" }, "data": { "path": "https://larec-benchmark-cd.oss-cn-chengdu.aliyuncs.com/youbei/sv_dbmtl/data/youbei.warmup.tf.bin", "dataType": "binary" }, "optional": { "maxRt": 100 } }

Parâmetros de configuração da tarefa de teste de estresse

A configuração geral do eas-benchmark é dividida em cinco partes, conforme a seguir:

Parâmetro	Descrição
base	A configuração básica da tarefa de teste de estresse.
service	A configuração do serviço a ser testado.
data	A configuração dos dados de solicitação do teste de estresse.
http	A configuração HTTP para solicitações de serviço.
optional	A configuração avançada opcional da tarefa de teste de estresse.

Tabela 1. Descrição de base

Parâmetro	Descrição
name	Opcional. O nome da tarefa de teste de estresse. Se não for especificado, será gerado automaticamente com base no nome do serviço.
duration	Opcional. O tempo total de execução da tarefa de teste de estresse, em segundos. Valor padrão: 1200.
qps	Opcional. As consultas por segundo (QPS) de destino (esperadas) da tarefa de teste de estresse. Valor padrão: 10000.
concurrency	Opcional. O número de conexões simultâneas criadas em cada instância de teste de estresse. O valor padrão inicial é 40, que é ajustado dinamicamente.
agentCount	Opcional. O número de instâncias criadas para a tarefa de teste de estresse. O valor padrão inicial é 1, que é ajustado dinamicamente.

Tabela 2. Descrição de service

Para criar uma tarefa de teste de estresse no modo de acesso por gateway, você deve abrir um ticket para solicitar permissões de lista de permissões.

Parâmetro	Descrição
serviceUrl	Opcional. A URL de acesso do serviço a ser testado. Este parâmetro não é obrigatório se o serviço for um serviço Elastic Algorithm Service (EAS).
serviceName	Opcional. O nome do serviço a ser testado. Este parâmetro é obrigatório se o serviço for um serviço EAS e não é obrigatório se o serviço for um serviço personalizado.
requestToken	Opcional. O token de autenticação para acessar o serviço. Este parâmetro não é obrigatório se serviceName for especificado.
endpointType	Opcional. O tipo de teste de estresse suportado pelo serviço. Valores válidos: default (modo gateway) e direct (modo de conexão direta). Valor padrão: direct.

Tabela 3. Descrição de data

Parâmetro	Descrição
content	Opcional. Os dados de solicitação do teste de estresse no formato de string.
path	Opcional. O caminho HTTP da fonte de dados de teste. Pode ser um único arquivo ou um arquivo `.zip`. Um arquivo `.zip` baixado é descompactado automaticamente.
dataType	Opcional. O tipo dos dados de teste. Valores válidos: text e binary. Valor padrão: text.
multiLine	Opcional. Especifica se os dados de teste são separados por linhas. O valor é do tipo BOOLEAN. Se definido como true, os dados baixados são analisados linha por linha.

Tabela 4. Descrição de HTTP

Parâmetro	Descrição
method	Opcional. O método de solicitação HTTP. Valor padrão: POST.
host	Opcional. A configuração de host para a solicitação. Valor padrão: vazio.
headers	Opcional. As configurações de cabeçalho de solicitação HTTP. O valor é do tipo LIST. Exemplo: `["Authorization:aaa", "Content-Type:text"]`.
timeout	Opcional. O período de tempo limite da solicitação HTTP, em milissegundos. Valor padrão: 20000.

Tabela 5. Descrição de optional

Parâmetro	Descrição
mode	Opcional. O modo de teste de estresse. Valores válidos: auto (modo de aumento automático de carga): Valor padrão. O controlador do eas-benchmark permite a criação automática de workers de agente para teste de estresse, define a simultaneidade apropriada e usa um algoritmo de otimização automática para encontrar a capacidade máxima de carga do serviço. scan (modo de aumento periódico de carga): Aumenta dinamicamente a carga com base em parâmetros como o QPS inicial (minQPS), QPS máximo (maxQPS), intervalo de crescimento do QPS (adjustInterval) e etapa de crescimento do QPS (qpsGrowthDelta) que você especificar, até que a carga do serviço atinja o maxRT ou maxQPS especificado, ou o número de erros no teste de estresse do serviço exceda o nível de tolerância (faultTolerate). manual (modo de aumento manual de carga): Fixa o número de agentes de teste de estresse e a simultaneidade de cada agente. Você pode ajustar dinamicamente o número de agentes e a simultaneidade dos agentes durante o processo de teste de estresse.
adjustInterval	Opcional. O intervalo de ajuste dinâmico para o aumento automático de carga, em segundos. Valor padrão: 60. Por exemplo, se definido como 30, o limite de aumento de carga é ajustado a cada 30 segundos.
minQPS	Opcional. O QPS mínimo durante o processo de aumento automático de carga. Valor padrão: 100.
maxQPS	Opcional. O QPS máximo durante o processo de aumento automático de carga. Valor padrão: 10000.
maxRT	Opcional. O tempo de resposta (RT) máximo esperado. Se esse limite for excedido, o QPS será ajustado automaticamente até que o RT em tempo real atenda à expectativa.
qpsGrowthDelta	Opcional. O incremento de QPS para cada aumento durante o processo de aumento automático de carga. Valor padrão: 50.
faultTolerate	Opcional. O nível de tolerância para a taxa de erro de solicitação (códigos de status não 200). Valor padrão: 0.001.
faultAction	Opcional. O comportamento do teste de estresse quando a taxa de erro de solicitação excede o limite definido por faultTolerate. Valores válidos: stop (mantém o QPS atual e para de aumentar a carga) e revise (ajusta dinamicamente o QPS até que a taxa de erro de solicitação atenda à expectativa).

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	40325405-579C-4D82********
TaskName	string	O nome da tarefa de teste de estresse.	benchmark-larec-test-1076
Region	string	A região onde a tarefa de teste de estresse reside.	cn-shanghai
Message	string	A mensagem retornada para a solicitação.	Benchmark task [foo] is Creating

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "40325405-579C-4D82********",
  "TaskName": "benchmark-larec-test-1076",
  "Region": "cn-shanghai",
  "Message": "Benchmark  task [foo] is Creating"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.