All Products
Search

This Product

    Database Autonomy Service:CreateCloudBenchTasks

    Document Center

    Database Autonomy Service:CreateCloudBenchTasks

    Last Updated:Jun 10, 2026

    Anda dapat memanggil operasi CreateCloudBenchTasks untuk membuat tugas pengujian beban.

    Deskripsi operasi

    Database Autonomy Service (DAS) menyediakan pengujian beban cerdas untuk membantu Anda memverifikasi apakah tipe instans Anda perlu ditingkatkan skalanya guna menangani lonjakan trafik layanan secara efektif. Untuk informasi selengkapnya, lihat Pengujian beban cerdas. Database harus memenuhi prasyarat berikut:

    • Database sumber hanya mendukung RDS MySQL High Availability Edition atau RDS Enterprise Edition, dan PolarDB MySQL cluster edition.

    • Instans database target adalah RDS MySQL atau PolarDB MySQL.

    • Instans terhubung ke DAS. Untuk informasi selengkapnya, lihat Menghubungkan ke instans database Alibaba Cloud.

    • DAS Enterprise Edition harus diaktifkan. Untuk informasi selengkapnya, lihat DAS Enterprise Edition.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    hdm:CreateCloudBenchTasks

    create

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    TaskType

    string

    Yes

    Tipe tugas pengujian beban. Nilai yang valid:

    • pressure test (default): Pengujian beban cerdas, yang memutar ulang trafik yang ditangkap dari instans sumber pada instans target dengan kecepatan maksimum yang didukung oleh tipe instans target.

    • smart pressure test: Pengujian beban yang dihasilkan, yang menganalisis dan mempelajari trafik yang ditangkap dari instans sumber dalam waktu singkat, menghasilkan trafik yang konsisten dengan model bisnis dan distribusi trafik dari trafik asli untuk pengujian beban berkelanjutan, mengurangi waktu pengumpulan data dari instans sumber, serta mengurangi biaya penyimpanan dan overhead performa.

    pressure test
    SrcInstanceId

    string

    Yes

    ID instans sumber. Hanya instans RDS MySQL dan PolarDB MySQL yang didukung. Anda dapat memanggil operasi GetInstanceInspections untuk memperoleh ID.

    Catatan

    Parameter ini wajib diisi ketika DstType disetel ke Instance.

    rm-2ze1jdv45i7l6****
    Description

    string

    Yes

    Deskripsi tugas pengujian beban.

    test-das-bench-0501
    SrcPublicIp

    string

    No

    Parameter yang dicadangkan.

    None
    DstInstanceId

    string

    No

    ID instans target. Hanya instans RDS MySQL dan PolarDB MySQL yang didukung. Anda dapat memanggil operasi GetInstanceInspections untuk memperoleh ID.

    Catatan

    Parameter ini wajib diisi ketika DstType disetel ke Instance.

    rm-2ze1jdv45i7l6****
    GatewayVpcId

    string

    No

    ID virtual private cloud (VPC) dari Database Gateway.

    Catatan

    Parameter ini wajib diisi ketika ClientType disetel ke ECS.

    vpc-t4nsnwvpbc1h76ja4****
    GatewayVpcIp

    string

    No

    Alamat IP atau nama domain dari Database Gateway.

    Catatan

    Parameter ini wajib diisi ketika ClientType disetel ke ECS.

    172.30.XX.XX
    ClientType

    string

    Yes

    Tipe mesin pengujian beban. Nilai yang valid:

    • ECS: Anda perlu menyiapkan Database Gateway sendiri.

    • DAS_ECS: Instans ECS yang dibeli dan di-deploy secara otomatis oleh DAS.

    ECS
    RequestStartTime

    string

    No

    Waktu mulai tugas pengujian beban. Waktu dalam format UNIX timestamp. Satuan: milidetik.

    1608888296000
    RequestEndTime

    string

    No

    Waktu berakhir tugas pengujian beban. Waktu dalam format UNIX timestamp. Satuan: milidetik.

    1608888296001
    RequestDuration

    string

    No

    Durasi tugas pengujian beban. Satuan: milidetik.

    86400000
    Rate

    string

    No

    Kecepatan pemutaran ulang trafik instans sumber pada instans target. Kecepatan pemutaran ulang harus berupa bilangan bulat positif. Nilai yang valid: 1 hingga 30. Nilai default: 1.

    1
    SmartPressureTime

    string

    No

    Durasi pengujian beban yang dihasilkan. Satuan: milidetik.

    Catatan

    Parameter ini wajib diisi ketika TaskType disetel ke smart pressure test.

    86400000
    DtsJobClass

    string

    No

    Spesifikasi tugas migrasi DTS. Anda dapat memanggil operasi DescribeCloudbenchTask untuk memperoleh spesifikasi.

    Catatan

    Tugas pengujian beban perlu memigrasikan data baseline dari instans sumber ke instans target. Parameter ini wajib diisi ketika Anda membuat tugas DTS baru.

    medium
    DtsJobId

    string

    No

    ID tugas migrasi DTS. Anda dapat memanggil operasi ConfigureDtsJob untuk memperoleh ID.

    Catatan

    Parameter ini wajib diisi ketika tugas DTS telah dibuat di konsol DTS.

    23127
    SrcSuperAccount

    string

    No

    Akun istimewa (privileged account) dari instans sumber. Nilai: admin.

    Catatan

    Parameter ini wajib diisi ketika DstType disetel ke Instance.

    admin
    SrcSuperPassword

    string

    No

    Kata sandi akun istimewa (privileged account) dari instans sumber.

    Catatan

    Parameter ini wajib diisi ketika DstType disetel ke Instance.

    test123
    DstSuperAccount

    string

    No

    Akun istimewa (privileged account) dari instans target.

    root
    DstSuperPassword

    string

    No

    Kata sandi akun istimewa (privileged account) dari instans target.

    test123
    DstType

    string

    No

    Tipe instans target. Nilai yang valid:

    • Instance (default): ID instans.

    • ConnectionString: alamat koneksi instans.

    Instance
    DstConnectionString

    string

    No

    Alamat koneksi instans target. Hanya instans RDS MySQL dan PolarDB MySQL yang didukung.

    Catatan

    Parameter ini berlaku ketika DstType disetel ke ConnectionString.

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

    string

    No

    Port instans target.

    Catatan

    Parameter ini berlaku ketika DstType disetel ke ConnectionString.

    3306
    WorkDir

    string

    No

    Direktori sementara yang dihasilkan oleh pengujian beban.

    /tmp/bench/
    BackupId

    string

    No

    ID set cadangan (backup). Anda dapat memanggil operasi DescribeBackups untuk meminta daftar cadangan dan memperoleh ID.

    229132
    BackupTime

    string

    No

    Waktu pencadangan. Format: yyyy-MM-ddTHH:mm:ssZ (waktu UTC).

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

    string

    No

    Jumlah total tugas pengujian beban yang akan dibuat. Nilai yang valid: 0 hingga 30. Nilai default: 1.

    1
    EndState

    string

    No

    Status setelah tugas pengujian beban berakhir. Nilai yang valid:

    • WAIT_TARGET: Menyiapkan instans target untuk pengujian beban.

    • WAIT_DBGATEWAY: Menyiapkan deployment pengujian beban.

    • WAIT_SQL: Menyiapkan pernyataan SQL secara lengkap.

    • WAIT_LOGIC: Menyiapkan untuk mulai memutar ulang trafik.

    Catatan

    Ketika tugas pengujian beban mencapai status yang disetel oleh EndState, tugas tersebut langsung mencapai status selesai.

    WAIT_TARGET

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    Code

    string

    Kode status yang dikembalikan.

    200
    Message

    string

    Pesan yang dikembalikan.

    Catatan

    Ketika permintaan berhasil, Successful dikembalikan. Ketika permintaan gagal, informasi pengecualian seperti kode kesalahan dikembalikan.

    Successful
    RequestId

    string

    ID permintaan.

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

    string

    Menunjukkan apakah permintaan berhasil:

    • true: Permintaan berhasil.

    • false: Permintaan gagal.

    true
    Data

    object

    taskIds

    array

    Daftar detail.

    string

    Daftar detail, termasuk jumlah total item informasi, kode kesalahan, dan informasi lainnya.

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

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

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

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.