すべてのプロダクト
Search

このプロダクト

    :CreateCloudBenchTasks

    ドキュメントセンター

    :CreateCloudBenchTasks

    最終更新日:Jan 13, 2026

    CreateCloudBenchTasks 操作を呼び出して、ストレステスト タスクを作成できます。

    操作説明

    Database Autonomy Service ( DAS ) は、インテリジェントなストレステストを提供し、サービス トラフィックのピークを効果的に処理するためにインスタンス タイプのスケールアウトが必要かどうかを確認するのに役立ちます。 詳細については、「インテリジェント ストレステスト」をご参照ください。 データベースは、次の前提条件を満たしている必要があります。

    • ソースデータベースは、RDS MySQL 高可用性エディションまたは RDS Enterprise Edition、および PolarDB MySQL クラスタエディションのみをサポートしています。

    • ターゲット データベースインスタンスは、RDS MySQL または PolarDB MySQL です。

    • インスタンスは DAS に接続されています。 詳細については、「Alibaba Cloud データベースインスタンスへの接続」をご参照ください。

    • DAS Enterprise Edition を有効にする必要があります。 詳細については、「DAS Enterprise Edition」をご参照ください。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    hdm:CreateCloudBenchTasks

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    TaskType

    string

    必須

    ストレステスト タスクのタイプ。有効な値：

    • pressure test（デフォルト）: インテリジェント ストレステスト。ターゲット インスタンスタイプでサポートされる最大速度で、ソースインスタンスからキャプチャされたトラフィックをターゲット インスタンスで再生します。

    • smart pressure test: 生成されたストレステスト。短期間でソースインスタンスからキャプチャされたトラフィックを分析および学習し、元のトラフィックのビジネス モデルおよびトラフィック分布と一致するトラフィックを生成して継続的なストレステストを行い、ソースインスタンスからデータを収集する時間を短縮し、ストレージ コストとパフォーマンスオーバーヘッドを削減します。

    pressure test
    SrcInstanceId

    string

    必須

    ソースインスタンスの ID 。 RDS MySQL インスタンスと PolarDB MySQL インスタンスのみがサポートされています。 GetInstanceInspections 操作を呼び出して、ID を取得できます。

    説明

    DstType が Instance に設定されている場合、このパラメータは必須です。

    rm-2ze1jdv45i7l6****
    Description

    string

    必須

    ストレステスト タスクの説明。

    test-das-bench-0501
    SrcPublicIp

    string

    任意

    予約済みパラメータ。

    None
    DstInstanceId

    string

    任意

    ターゲット インスタンスの ID 。 RDS MySQL インスタンスと PolarDB MySQL インスタンスのみがサポートされています。 GetInstanceInspections 操作を呼び出して、ID を取得できます。

    説明

    DstType が Instance に設定されている場合、このパラメータは必須です。

    rm-2ze1jdv45i7l6****
    GatewayVpcId

    string

    任意

    データベース ゲートウェイの仮想プライベートクラウド ( VPC ) ID 。

    説明

    ClientType が ECS に設定されている場合、このパラメータは必須です。

    vpc-t4nsnwvpbc1h76ja4****
    GatewayVpcIp

    string

    任意

    データベース ゲートウェイの IP アドレスまたはドメイン名。

    説明

    ClientType が ECS に設定されている場合、このパラメータは必須です。

    172.30.XX.XX
    ClientType

    string

    必須

    ストレステスト マシンのタイプ。有効な値：

    • ECS: データベース ゲートウェイ を自分で準備する必要があります。

    • DAS_ECS: DAS によって自動的に購入およびデプロイされる ECS インスタンス。

    ECS
    RequestStartTime

    string

    任意

    ストレステスト タスクの開始時刻。時刻は UNIX タイムスタンプ 形式です。単位：ミリ秒。

    1608888296000
    RequestEndTime

    string

    任意

    ストレステスト タスクの終了時刻。時刻は UNIX タイムスタンプ 形式です。単位：ミリ秒。

    1608888296001
    RequestDuration

    string

    任意

    ストレステスト タスクの期間。単位：ミリ秒。

    86400000
    Rate

    string

    任意

    ターゲット インスタンスでのソースインスタンス トラフィックの再生速度。再生速度は正の整数である必要があります。有効な値： 1 ～ 30 。デフォルト値： 1 。

    1
    SmartPressureTime

    string

    任意

    生成されたストレステストの期間。単位：ミリ秒。

    説明

    TaskType が smart pressure test に設定されている場合、このパラメータは必須です。

    86400000
    DtsJobClass

    string

    任意

    DTS 移行タスクの仕様。 DescribeCloudbenchTask 操作を呼び出して、仕様を取得できます。

    説明

    ストレステスト タスクでは、ベースライン データをソースインスタンスからターゲット インスタンスに移行する必要があります。新しい DTS タスクを作成する場合、このパラメータは必須です。

    medium
    DtsJobId

    string

    任意

    DTS 移行タスクの ID 。 ConfigureDtsJob 操作を呼び出して、ID を取得できます。

    説明

    DTS コンソールで DTS タスクが作成済みの場合、このパラメータは必須です。

    23127
    SrcSuperAccount

    string

    任意

    ソースインスタンスの特権アカウント。値： admin 。

    説明

    DstType が Instance に設定されている場合、このパラメータは必須です。

    admin
    SrcSuperPassword

    string

    任意

    ソースインスタンスの特権アカウントのパスワード。

    説明

    DstType が Instance に設定されている場合、このパラメータは必須です。

    test123
    DstSuperAccount

    string

    任意

    ターゲット インスタンスの特権アカウント。

    root
    DstSuperPassword

    string

    任意

    ターゲット インスタンスの特権アカウントのパスワード。

    test123
    DstType

    string

    任意

    ターゲット インスタンスのタイプ。有効な値：

    • Instance（デフォルト）: インスタンス ID 。

    • ConnectionString: インスタンスの接続アドレス。

    Instance
    DstConnectionString

    string

    任意

    ターゲット インスタンスの接続アドレス。 RDS MySQL インスタンスと PolarDB MySQL インスタンスのみがサポートされています。

    説明

    このパラメータは、DstType が ConnectionString に設定されている場合に有効になります。

    rm-de21209****.mysql.rds.aliyuncs.com
    DstPort

    string

    任意

    ターゲット インスタンスのポート。

    説明

    このパラメータは、DstType が ConnectionString に設定されている場合に有効になります。

    3306
    WorkDir

    string

    任意

    ストレステストによって生成される一時ディレクトリ。

    /tmp/bench/
    BackupId

    string

    任意

    バックアップセットの ID 。 DescribeBackups 操作を呼び出して、バックアップ リストを照会し、ID を取得できます。

    229132
    BackupTime

    string

    任意

    バックアップの時刻。形式：yyyy-MM-ddTHH:mm:ssZ（ UTC 時刻）。

    2021-04-23T13:22:14Z
    Amount

    string

    任意

    作成するストレステスト タスクの総数。有効な値： 0 ～ 30 。デフォルト値： 1 。

    1
    EndState

    string

    任意

    ストレステスト タスク終了後のステータス。有効な値：

    • WAIT_TARGET: ストレステストのターゲット インスタンスを準備します。

    • WAIT_DBGATEWAY: ストレステスト デプロイメントを準備します。

    • WAIT_SQL: 完全な SQL 文を準備します。

    • WAIT_LOGIC: トラフィックの再生を開始する準備をします。

    説明

    ストレステスト タスクが EndState で設定されたステータスを完了すると、タスクは直接完了ステータスに達します。

    WAIT_TARGET

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    返された状態コード。

    200
    Message

    string

    返されたメッセージ。

    説明

    リクエストが成功した場合、Successful が返されます。リクエストが失敗した場合、エラーコードなどの例外情報が返されます。

    Successful
    RequestId

    string

    リクエスト ID 。

    B6D17591-B48B-4D31-9CD6-9B9796B2****
    Success

    string

    リクエストが成功したかどうかを示します。

    • true: リクエストは成功しました。

    • false: リクエストは失敗しました。

    true
    Data

    object

    taskIds

    array

    詳細のリスト。

    string

    情報項目の総数、エラーコード、その他の情報を含む詳細のリスト。

    "Data": { "total": 1, "list":[...] }, "Code": 200, "Success": true }

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "taskIds": [
      "\"Data\": { \"total\": 1, \"list\":[...] }, \"Code\": 200, \"Success\": true }"
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParams The request parameters are invalid.
    403 NoPermission You are not authorized to do this action.

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

    変更履歴

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