すべてのプロダクト
Search

このプロダクト

    Platform For AI:CreateBenchmarkTask

    ドキュメントセンター

    Platform For AI:CreateBenchmarkTask

    最終更新日:Dec 23, 2025

    ストレステストタスクを作成します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eas:CreateBenchmarkTask

    *BenchmarkTask

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

    		 なし なし

    リクエスト構文

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    body

    string

    任意

    リクエストボディです。ボディには、ストレステストタスクを作成するために設定されるパラメーターが含まれます。

    { "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 } }

    ストレステストタスクを作成するためのパラメーター

    次の表に、eas-benchmark を使用してストレステストタスクを作成するために設定するパラメーターを説明します。

    パラメーター説明
    baseストレステストタスクの基本構成。
    serviceテスト対象サービスに関連する構成。
    dataストレステストのリクエストデータに関連する構成。
    httpサービスへの HTTP リクエストに関連する構成。
    optionalストレステストタスクのオプションの詳細設定。

    表 1. base パラメーターのフィールド

    フィールド説明
    nameストレステストタスクの名前。このフィールドを指定しない場合、タスクはサービス名に基づいて自動的に命名されます。このフィールドはオプションです。
    duration合計ストレステスト期間。単位：秒。デフォルト値：1200。このフィールドはオプションです。
    qpsストレステストタスクに期待される秒間クエリ数 (QPS)。デフォルト値：10000。このフィールドはオプションです。
    concurrencyストレステストタスクの各インスタンスに対して作成する同時接続数。デフォルト値は 40 で、自動的に変更されることがあります。このフィールドはオプションです。
    agentCountストレステストタスク用に作成するインスタンスの数。デフォルト値は 1 で、自動的に変更されることがあります。このフィールドはオプションです。

    表 2. service パラメーターのフィールド

    **フィールド****説明**
    serviceUrlテスト対象のサービスの URL。Elastic Algorithm Service (EAS) のサービスをテストする場合、このフィールドは無視できます。このフィールドはオプションです。
    serviceNameテスト対象のサービスの名前。EAS のサービスをテストする場合、このフィールドは必須です。カスタムサービスをテストする場合、このフィールドは無視できます。このフィールドはオプションです。
    requestTokenサービスへのアクセスに使用するトークン。**serviceName** の値が指定されている場合、このフィールドは無視できます。このフィールドはオプションです。
    endpointTypeサービスがサポートするストレステストのタイプ。有効な値：default および direct。**default** は、ゲートウェイを使用してサービス上でストレステストタスクが実行されることを指定します。**direct** は、サービス上で直接ストレステストタスクが実行されることを指定します。デフォルト値：**direct**。このフィールドはオプションです。

    表 3. data パラメーターのフィールド

    **フィールド****説明**
    contentストレステストリクエストのコンテンツ。このフィールドの値は STRING 型です。このフィールドはオプションです。
    pathストレステストデータのパス。パスには単一のファイルまたは .zip ファイルを指定できます。.zip ファイルは自動的にダウンロードされ、解凍されます。このフィールドはオプションです。
    dataTypeテストデータのタイプ。有効な値：text および binary。デフォルト値：text。このフィールドはオプションです。
    multiLineストレステストデータを改行で区切るかどうかを指定します。有効な値：true および false。デフォルト値：false。このフィールドを true に設定すると、ダウンロードされたデータは行ごとに解析されます。このフィールドはオプションです。

    表 4. HTTP パラメーターのフィールド

    **フィールド****説明**
    methodHTTP リクエストメソッド。デフォルト値：POST。このフィールドはオプションです。
    hostリクエストを送信するホスト。デフォルトでは空です。このフィールドはオプションです。
    headersHTTP リクエストのヘッダー。ヘッダーは LIST 型です (例：`["Authorization:aaa", "Content-Type:text"]`)。このフィールドはオプションです。
    timeoutHTTP リクエストのレイテンシー。単位：ミリ秒。デフォルト値：20000。このフィールドはオプションです。

    表 5. optional パラメーターのフィールド

    **フィールド****説明**
    modeストレステストモード。有効な値：auto、scan、manual。値 scan は、定期的にストレステストを実行することを指定します。デフォルト値：auto。このフィールドはオプションです。
    adjustIntervalストレステストが自動的に実行される間隔。単位：秒。このフィールドを 1 に設定すると、ストレステストは 1 秒間隔で実行されます。デフォルト値：60。このフィールドはオプションです。
    minQPSストレステストの最小 QPS。デフォルト値：100。このフィールドはオプションです。
    maxQPSストレステストの最大 QPS。デフォルト値：10000。このフィールドはオプションです。
    maxRT最大応答時間。実際の応答時間が指定された上限を超えた場合、応答時間が上限を下回るまで QPS が自動的に調整されます。このフィールドはオプションです。
    qpsGrowthDeltaQPS の増分。デフォルト値：50。このフィールドはオプションです。
    faultTolerate許容できる最大リクエストエラー率 (HTTP 200 状態コードのエラーを除く)。デフォルト値：0.001。このフィールドはオプションです。
    faultActionリクエストエラー率が faultTolerate フィールドで指定されたしきい値を超えた場合に実行される操作。有効な値：stop および revise。stop は、現在の QPS を維持し、負荷の増加を停止することを意味します。revise は、リクエストエラー率が期待値を満たすまで QPS を動的に調整することを意味します。このフィールドはオプションです。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

    40325405-579C-4D82********
    TaskName

    string

    ストレステストタスクの名前。

    benchmark-larec-test-1076
    Region

    string

    ストレステストタスクが実行されるリージョンの ID。

    cn-shanghai
    Message

    string

    返されたメッセージ。

    Benchmark task [foo] is Creating

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。