Todos os produtos
Search

Este produto

    Platform For AI:CreateBenchmarkTask

    Central de documentação

    Platform For AI:CreateBenchmarkTask

    Última atualização: Jul 08, 2026

    Cria uma tarefa de teste de estresse.

    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 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

    O corpo da solicitação. O corpo inclui os parâmetros definidos para criar uma 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 definidos para criar uma tarefa de teste de estresse

    A tabela a seguir descreve os parâmetros definidos para criar uma tarefa de teste de estresse usando eas-benchmark.

    ParâmetroDescrição
    baseAs configurações básicas da tarefa de teste de estresse.
    serviceAs configurações relacionadas ao serviço que você deseja testar.
    dataAs configurações relacionadas aos dados solicitados para o teste de estresse.
    httpAs configurações relacionadas à solicitação HTTP para o serviço.
    optionalAs configurações avançadas opcionais para a tarefa de teste de estresse.

    Tabela 1. Campos no parâmetro base

    CampoDescrição
    nameO nome da tarefa de teste de estresse. Se você não especificar este campo, a tarefa será nomeada automaticamente com base no nome do serviço. Este campo é opcional.
    durationA duração total do teste de estresse. Unidade: segundos. Valor padrão: 1200. Este campo é opcional.
    qpsO número esperado de consultas por segundo (QPS) da tarefa de teste de estresse. Valor padrão: 10000. Este campo é opcional.
    concurrencyO número de conexões simultâneas que você deseja criar para cada instância na tarefa de teste de estresse. O valor padrão é 40 e pode ser alterado automaticamente. Este campo é opcional.
    agentCountO número de instâncias que você deseja criar para a tarefa de teste de estresse. O valor padrão é 1 e pode ser alterado automaticamente. Este campo é opcional.

    Tabela 2. Campos no parâmetro service

    **Campo****Descrição**
    serviceUrlA URL do serviço que você deseja testar. Se um serviço do Elastic Algorithm Service (EAS) for testado, este campo pode ser ignorado. Este campo é opcional.
    serviceNameO nome do serviço que você deseja testar. Se um serviço do EAS for testado, este campo deve ser definido. Se um serviço personalizado for testado, este campo pode ser ignorado. Este campo é opcional.
    requestTokenO token usado para acessar o serviço. Se o valor de **serviceName** for especificado, este campo pode ser ignorado. Este campo é opcional.
    endpointTypeO tipo de teste de estresse suportado pelo serviço. Valores válidos: default e direct. **default** especifica que a tarefa de teste de estresse é executada no serviço por meio de um gateway. **direct** especifica que a tarefa de teste de estresse é executada diretamente no serviço. Valor padrão: **direct**. Este campo é opcional.

    Tabela 3. Campos no parâmetro data

    **Campo****Descrição**
    contentO conteúdo de uma solicitação de teste de estresse. O valor deste campo é do tipo STRING. Este campo é opcional.
    pathO caminho dos dados de teste de estresse. O caminho pode ser um arquivo único ou um arquivo `.zip`. O arquivo `.zip` é baixado e descompactado automaticamente. Este campo é opcional.
    dataTypeO tipo dos dados de teste. Valores válidos: text e binary. Valor padrão: text. Este campo é opcional.
    multiLineEspecifica se os dados de teste de estresse devem ser separados por linha. Valores válidos: true e false. Valor padrão: false. Se você definir este campo como true, os dados baixados serão analisados por linha. Este campo é opcional.

    Tabela 4. Campos no parâmetro HTTP

    **Campo****Descrição**
    methodO método de solicitação HTTP. Valor padrão: POST. Este campo é opcional.
    hostO host que envia a solicitação. Este campo é vazio por padrão. Este campo é opcional.
    headersO cabeçalho da solicitação HTTP. O cabeçalho é do tipo LIST, como `["Authorization:aaa", "Content-Type:text"] `. Este campo é opcional.
    timeoutA latência da solicitação HTTP. Unidade: milissegundos. Valor padrão: 20000. Este campo é opcional.

    Tabela 5. Campos no parâmetro optional

    **Campo****Descrição**
    modeO modo de teste de estresse. Valores válidos: auto, scan e manual. O valor scan especifica a execução periódica do teste de estresse. Valor padrão: auto. Este campo é opcional.
    adjustIntervalO intervalo no qual o teste de estresse é executado automaticamente. Unidade: segundos. Se este campo for definido como 1, o teste de estresse será executado em intervalos de 1 segundo. Valor padrão: 60. Este campo é opcional.
    minQPSO QPS mínimo do teste de estresse. Valor padrão: 100. Este campo é opcional.
    maxQPSO QPS máximo do teste de estresse. Valor padrão: 10000. Este campo é opcional.
    maxRTO tempo máximo de resposta. Se o tempo de resposta real exceder o limite superior especificado, o QPS será ajustado automaticamente até que o tempo de resposta fique abaixo do limite superior. Este campo é opcional.
    qpsGrowthDeltaO incremento de QPS. Valor padrão: 50. Este campo é opcional.
    faultTolerateA taxa máxima de erro de solicitação que pode ser tolerada, excluindo erros com o código de status HTTP 200. Valor padrão: 0.001. Este campo é opcional.
    faultActionA operação executada se a taxa de erro de solicitação exceder o limite especificado pelo campo faultTolerate. Valores válidos: stop e revise. stop significa manter o QPS atual e parar de aumentar a carga. revise significa ajustar dinamicamente o QPS até que a taxa de erro de solicitação atenda à expectativa. Este campo é opcional.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Os parâmetros de 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

    O ID da região onde a tarefa de teste de estresse é executada.

    cn-shanghai
    Message

    string

    A mensagem retornada.

    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.