すべてのプロダクト
Search

このプロダクト

    Database Autonomy Service:CreateCloudBenchTasks

    ドキュメントセンター

    Database Autonomy Service:CreateCloudBenchTasks

    最終更新日:Mar 13, 2026

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

    操作説明

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

    • ソースデータベースは、RDS MySQL High Availability Edition または 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 インスタンスのみがサポートされています。ID を取得するには、GetInstanceInspections 操作を呼び出します。

    説明

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

    rm-2ze1jdv45i7l6****
    Description

    string

    必須

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

    test-das-bench-0501
    SrcPublicIp

    string

    任意

    予約済みパラメーター。

    None
    DstInstanceId

    string

    任意

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

    説明

    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。ID を取得するには、ConfigureDtsJob 操作を呼び出します。

    説明

    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。バックアップリストを照会し、ID を取得するには、DescribeBackups 操作を呼び出します。

    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.

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

    変更履歴

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