All Products
Search

This Product

    Elastic Compute Service:CloneDisks

    Document Center

    Elastic Compute Service:CloneDisks

    Last Updated:Sep 02, 2026

    Kloning disk memungkinkan Anda membuat disk baru dengan cepat yang memiliki data sama seperti disk sumber di zona yang sama. Disk hasil kloning mendukung kapasitas, tipe, dan atribut enkripsi kustom. Setelah disk hasil kloning disambungkan ke instans, Anda dapat mereplikasi data bisnis atau melakukan skala keluar layanan dengan cepat.

    Deskripsi operasi

    Catatan

    Fitur kloning disk itu sendiri gratis, tetapi disk baru yang dihasilkan dari kloning dikenakan biaya berdasarkan aturan penagihan penyimpanan blok. Item yang dapat ditagih bervariasi menurut tipe disk dan mencakup biaya kapasitas disk, biaya performa yang disediakan, dan biaya lonjakan performa. Kecuali biaya lonjakan performa yang dikenakan setelah lonjakan terjadi, biaya lainnya mulai terakumulasi setelah disk dibuat, terlepas dari apakah disk tersebut disambungkan ke instans atau tidak.

    Catatan penggunaan

    • Ini adalah operasi asinkron. Setelah pemanggilan berhasil, gunakan taskGroupId dan panggil operasi DescribeTasks untuk mengkueri hasil eksekusi.

    Fitur

    • Kloning hanya mendukung disk seri ESSD (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) sebagai sumber, dan disk baru hanya boleh berupa tipe disk seri ESSD.

      • Disk non-regional hanya dapat dikloning ke tipe disk non-regional. Disk regional hanya dapat dikloning ke tipe disk regional.

      • Disk lokal dan disk ephemeral elastis tidak dapat dikloning atau digunakan sebagai sumber kloning.

    • Anda dapat menentukan tipe dan tingkat kinerja (PL) disk baru selama kloning.

    • Anda dapat menentukan kapasitas disk baru selama kloning, tetapi kapasitas disk baru harus lebih besar atau sama dengan kapasitas disk sumber.

    • Anda dapat mengonfigurasi performa yang disediakan dan lonjakan performa untuk disk baru, dengan syarat tipe disk tujuan mendukung performa yang disediakan dan lonjakan performa.

    • Anda dapat menentukan enkripsi atau mengubah kunci enkripsi untuk disk baru. Jika disk sumber dienkripsi, Anda tidak dapat mengkloningnya menjadi disk yang tidak dienkripsi, tetapi Anda dapat mengubah kunci enkripsi.

    • Anda dapat menggunakan disk langganan sebagai disk sumber. Bahkan jika disk langganan telah kedaluwarsa, disk tersebut tetap dapat digunakan sebagai disk sumber.

    • Disk baru hasil kloning tidak mendukung reinisialisasi.

    • Kloning tidak mendukung set penyimpanan atau kluster penyimpanan blok khusus. Namun, disk dalam Sumber daya ini dapat digunakan sebagai disk sumber. Disk hasil kloning tidak akan ditempatkan di set penyimpanan atau kluster penyimpanan blok khusus.

    • Pembatasan status disk sumber:

      • Status disk sumber adalah In Use, dan status Instansi terkait adalah Running atau Stopped.

      • Status disk sumber adalah Available, dan disk sebelumnya telah disambungkan.

      • Disk yang sedang mengalami perubahan spesifikasi tidak dapat digunakan sebagai disk sumber.

      • Disk yang sedang mengalami ekspansi tidak dapat digunakan sebagai disk sumber.

    • Kloning disk tidak didukung untuk skenario hibernasi instans. Jika disk berada pada instans yang dihibernasi, disk tersebut tidak dapat digunakan sebagai disk sumber.

    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

    ecs:CloneDisks

    create

    *Disk

    acs:ecs:{#regionId}:{#accountId}:disk/{#SourceDiskId}

    *Disk

    acs:ecs:{#regionId}:{#accountId}:disk/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    DryRun

    string

    No

    Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid:

    • true: mengirimkan Paket pemeriksaan tanpa mengkueri status pengajuan. Item pemeriksaan mencakup apakah AccessKey pair valid, apakah pengguna Resource Access Management (RAM) telah diberikan otorisasi yang diperlukan, dan apakah parameter yang diperlukan telah ditentukan. Jika pemeriksaan gagal, pesan error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): mengirimkan permintaan Normal. Setelah pemeriksaan berhasil, kode status HTTP 2XX akan dikembalikan dan status pengajuan langsung dikueri.

    true
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara berbagai permintaan. Nilai ClientToken hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

    123e4567-e89b-12d3-a456-426655440000
    Tag

    array<object>

    No

    Daftar tag untuk disk.

    object

    No

    Daftar tag untuk disk.

    Key

    string

    No

    Kunci tag disk. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag disk. Nilai valid N: 1 hingga 20. Nilai tag boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung http:// atau https://.

    TestValue
    ResourceGroupId

    string

    No

    ID kelompok sumber daya tempat disk berada.

    rg-bp199lyny9b3****
    SourceDiskId

    string

    Yes

    ID disk sumber.

    d-bp1d6tsvznfghy7y****
    DiskName

    string

    No

    Nama disk. Panjang nama harus 2 hingga 128 karakter dan dapat berisi huruf, angka, titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-). Nama harus dimulai dengan huruf.

    Nilai default: kosong.

    MyDiskName
    DiskCategory

    string

    Yes

    Kategori disk baru. Nilai valid:

    • cloud_essd: SSD Perusahaan (ESSD).

    • cloud_auto: Disk ESSD AutoPL.

    • cloud_essd_entry: Disk ESSD Entry.

    • cloud_regional_disk_auto: ESSD regional.

    Catatan

    Pembatasan kategori disk untuk kloning disk:

    • Disk non-regional hanya dapat dikloning ke tipe disk non-regional.

    • Disk regional hanya dapat dikloning ke tipe disk regional.

    cloud_essd
    PerformanceLevel

    string

    No

    Tingkat kinerja (PL) SSD standar baru. Nilai valid:

    • PL0: Satu disk dapat mengirimkan hingga 10.000 IOPS baca/tulis acak.

    • PL1: Satu disk dapat mengirimkan hingga 50.000 IOPS baca/tulis acak.

    • PL2: Satu disk dapat mengirimkan hingga 100.000 IOPS baca/tulis acak.

    • PL3: Satu disk dapat mengirimkan hingga 1.000.000 IOPS baca/tulis acak.

    Catatan

    Jika DiskCategory diatur ke cloud_essd, PerformanceLevel wajib diisi.

    Untuk informasi selengkapnya tentang cara memilih tingkat kinerja ESSD, lihat ESSD.

    PL1
    Size

    integer

    Yes

    Kapasitas disk baru. Unit: GiB. Anda harus menentukan nilai untuk parameter ini. Nilai valid:

    • cloud_essd: Nilai valid bervariasi berdasarkan tingkat kinerja.

      • PL0: 1 hingga 65.536.

      • PL1: 20 hingga 65.536.

      • PL2: 461 hingga 65.536.

      • PL3: 1.261 hingga 65.536.

    • cloud_auto: 1 hingga 65.536.

    • cloud_essd_entry: 10 hingga 32.768.

    • cloud_regional_disk_auto: 10 hingga 65.536.

    60
    MultiAttach

    string

    Yes

    Apakah akan menyambungkan atribut multi-attach untuk disk baru. Nilai valid:

    • Disabled: menonaktifkan atribut multi-attach.

    • Enabled: mengaktifkan atribut multi-attach. Hanya SSD Perusahaan (ESSD) yang mendukung parameter ini diatur ke Enabled.

    Disabled
    ProvisionedIops

    integer

    No

    IOPS baca/tulis yang disediakan untuk disk ESSD AutoPL. Nilai valid:

    • Kapasitas (GiB) <= 3: Performa yang disediakan tidak didukung.

    • Kapasitas (GiB) >= 4: [0, min{(1.000 IOPS/GiB × Kapasitas - IOPS Dasar), 50.000}]

    Kinerja dasar = max{min{1.800 + 50 × Kapasitas, 50.000}, 3.000}.

    Catatan

    Parameter ini hanya didukung ketika DiskCategory diatur ke cloud_auto. Untuk informasi selengkapnya, lihat Disk ESSD AutoPL.

    10
    BurstingEnabled

    boolean

    No

    Apakah akan mengaktifkan fitur lonjakan performa untuk disk baru. Nilai valid:

    • true: mengaktifkan fitur lonjakan performa.

    • false: tidak mengaktifkan fitur lonjakan performa.

    Catatan

    Parameter ini hanya didukung ketika DiskCategory diatur ke cloud_auto. Untuk informasi selengkapnya, lihat Disk ESSD AutoPL.

    true
    Encrypted

    boolean

    No

    Apakah disk baru dienkripsi. Nilai valid:

    • true: Disk baru dienkripsi.

    • false: Disk baru tidak dienkripsi.

    Nilai default: false.

    false
    KmsKeyId

    string

    No

    ID kunci dari kunci KMS yang digunakan oleh disk baru.

    key-szz67b2f696f4wh9yeg5d
    Arn

    array<object>

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    object

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    RoleType

    string

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    null
    Rolearn

    string

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    null
    AssumeRoleFor

    string

    No

    Catatan

    Parameter ini tidak tersedia untuk umum.

    null

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    TaskGroupId

    string

    ID kelompok Tugas untuk Tugas kloning disk. Anda dapat memanggil DescribeTasks untuk mengkueri hasil eksekusi tugas. Lihat Referensi.

    g-2ze2op2grqpclwu7****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TaskGroupId": "g-2ze2op2grqpclwu7****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDiskCategory.SourceDiskCategoryNotSupport The specified target disk category %s does not support cloning from origin disk category %s.
    400 InvalidDisk.NeverAttached The specified disk %s has been never attached to any instance.
    400 InvalidStatus.SourceDiskStatusViolation The specified disk %s has an invalid status. The expected status is Available or In_use; but the current status is %s.
    400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid. Tipe disk sistem dan tipe disk data yang ditentukan tidak didukung.
    400 InvalidDiskName.ValueNotSupported The specified parameter "DiskName" is not valid.
    400 InvalidPerformanceLevel.ValueNotSupported The specified parameter "PerformanceLevel" is not valid.
    400 InvalidMultiAttach.ValueNotSupported The specified parameter "MultiAttach" is not valid.
    400 InvalidBurstingEnabled.DiskCategoryNotSupported The specified disk category does not support bursting enabled.
    400 InvalidProvisionedIops.DiskCategoryNotSupported The specified disk category does not support provisioned IOPS.
    400 InvalidProvisionedIops.LimitExceed The provisioned IOPS exceeds the permitted range for the specified disk category.
    400 InvalidSize.MustGreaterThanSourceDisk The specified size %s(GB) must greater than source disk size %s(GB).
    400 DryRunOperation Request validation has been passed with DryRun flag set. Pemeriksaan DryRun berhasil. Permintaan Anda telah divalidasi.
    400 InvalidSourceDisk.Lazyloading The specified source disk %s is lazyloading.
    400 InvalidOperation.DiskCloneExceedsConcurrencyLimit The source disk %s has reached the maximum number (1) of concurrent clone operations. In-progress cloned disks: %s. Please wait a moment and try again later.
    400 InvalidParameter.Arns The specified Arns is not valid. Parameter Arns tidak valid. Periksa parameter dan coba lagi.
    400 InvalidOperation.DiskTypeUnsupported The specified source disk "%s" does not support cloning. Please select a different source disk.
    401 InvalidOperation.UserNotInWhiteList The specified user %s is not in the CloneDisks whitelist.
    403 OperationDenied.NotInArnsWhitelist The current account is not authorized for this operation. Please check the ARNS whitelist configuration.
    404 InvalidRegionId.NotFound The specified region does not exist. RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini.
    404 InvalidSourceDiskId.NotFound The specified source disk does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.