All Products
Search

This Product

    :AttachDisk

    Document Center

    :AttachDisk

    Last Updated:May 22, 2026

    Menyambungkan disk data pay-as-you-go atau disk sistem ke sebuah instans. Instans dan disk tersebut harus berada di zona yang sama.

    Deskripsi

    Saat memanggil operasi ini, perhatikan hal-hal berikut:

    • Disk harus berada dalam status Unattached (Available).
    • Jika disk disambungkan sebagai disk data, perhatikan hal-hal berikut:
      • Instans harus berada dalam status Running (Running) atau Stopped (Stopped).
      • Jika disk dibeli secara terpisah, metode penagihannya harus berupa pay-as-you-go.
      • Jika disk merupakan disk sistem yang sebelumnya dilepas dari suatu instans, tidak ada batasan terhadap metode penagihannya.
    • Jika disk disambungkan sebagai disk sistem, perhatikan hal-hal berikut:
      • Instans harus merupakan instans asal tempat disk sistem tersebut sebelumnya dilepas.
      • Instans harus berada dalam status Stopped (Stopped).
      • Kredensial logon harus dikonfigurasi.
    • Jika respons kueri informasi instans berisi {"OperationLocks": {"LockReason" : "security"}}, instans tersebut dikunci karena alasan keamanan dan semua operasi tidak dapat diterapkan padanya.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Parameter permintaan

    ParameterTipeDiperlukanContohDeskripsi
    ActionStringYaAttachDisk

    Operasi yang ingin Anda lakukan. Tetapkan nilai ke AttachDisk.

    DiskIdStringYad-bp1j4l5axzdy6ftk****

    ID disk yang akan disambungkan. Disk yang ditentukan oleh parameter DiskId dan instans yang ditentukan oleh parameter InstanceId harus berada di zona yang sama.

    Catatan Untuk informasi lebih lanjut mengenai batasan penyambungan data disk dan sistem disk, lihat bagian "Description".
    InstanceIdStringYai-bp1dq5lozx5f4pmd****

    ID instans yang akan disambungkan dengan disk tersebut.

    DeviceStringTidaktestDeviceName

    Nama disk tersebut.

    Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan Anda menggunakan parameter lain untuk memastikan kompatibilitas di masa depan.
    DeleteWithInstanceBooleanTidakfalse

    Menentukan apakah disk akan dilepas bersamaan dengan instans. Nilai yang valid:

    • true: Disk dilepas bersama instance.
    • false: Disk tidak dilepas bersamaan dengan instans. Disk tetap dipertahankan sebagai data disk pay-as-you-go.

    Nilai default: false.

    Saat menentukan parameter ini, perhatikan hal-hal berikut:

    • Jika OperationLocks untuk suatu instans berisi "LockReason" : "security", instans tersebut dikunci karena alasan keamanan. Meskipun nilai DeleteWithInstance pada disk yang terpasang diatur ke false, parameter DeleteWithInstance akan diabaikan dan disk dilepas bersamaan dengan instans.
    • Parameter ini tidak tersedia untuk disk yang telah mengaktifkan fitur multi-attach.
    BootableBooleanTidakfalse

    Menentukan apakah disk akan disambungkan sebagai sistem disk.

    Nilai default: false.

    Catatan Jika parameter Bootable diatur ke true, instans harus berada dalam status No System Disk.
    PasswordStringTidakEcsV587!

    Password yang ditetapkan saat Anda menyambungkan sistem disk. Password ini hanya berlaku untuk pengguna administrator dan root. Panjang password harus antara 8 hingga 30 karakter dan harus mengandung minimal tiga dari jenis karakter berikut: huruf kapital, huruf kecil, angka, dan karakter khusus. Karakter khusus berikut dapat digunakan:

    
()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

    Untuk Instans Windows, password tidak boleh diawali dengan garis miring (/).

    Catatan Jika parameter Password ditentukan, kami menyarankan agar Anda mengirim permintaan melalui HTTPS untuk menghindari kebocoran password.
    KeyPairNameStringTidakKeyPairTestName

    Nama pasangan kunci SSH yang Anda bind ke instans Linux saat menyambungkan disk sistem.

    • Instans Windows tidak mendukung login berbasis pasangan kunci SSH. Parameter Password tetap berlaku meskipun parameter KeyPairName ditentukan.
    • Untuk instans Linux, metode login berbasis password dinonaktifkan secara default.

    Parameter respons

    ParameterTipeContohDeskripsi
    RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID permintaan.

    Contoh

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=AttachDisk
&DiskId=d-bp1j4l5axzdy6ftk****
&InstanceId=i-bp1dq5lozx5f4pmd****
&DeleteWithInstance=false
&<Common request parameters>

    Contoh respons sukses

    XML format

    <AttachDiskResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</AttachDiskResponse>

    JSON format

    {
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    Kode kesalahan

    Kode status HTTPKode kesalahanPesan kesalahanDeskripsi
    400InvalidDevice.MalformedThe specified device is not valid.Pesan kesalahan yang dikembalikan karena parameter Device yang ditentukan tidak ada.
    400IncorrectInstanceStatusThe current status of the resource does not support this operation.Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat resource berada dalam status saat ini.
    400InvalidParameterThe input parameter is mandatory for processing this request is empty.Pesan kesalahan yang dikembalikan karena parameter yang diperlukan tidak ditentukan.
    400InvalidRegionId.MalFormedThe specified RegionId is not validPesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak valid.
    400InvalidOperation.InstanceTypeNotSupportThe instance type of the specified instance does not support hot attach disk.Pesan kesalahan yang dikembalikan karena instans tempat disk disambungkan tidak mendukung hot swap disk.
    400DiskCategory.OperationNotSupportedThe operation is not supported to the specified disk due to its disk categoryPesan kesalahan yang dikembalikan karena kategori disk yang ditentukan tidak mendukung operasi ini.
    400InvalidOperation.InstanceTypeNotSupportThe specified disk which has kms key should only attach to ioOptimized instance.Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak didukung. Anda hanya dapat menetapkan kunci Key Management Service (KMS) untuk instans I/O teroptimasi.
    400InvalidParameter.AllEmpty%sPesan kesalahan yang dikembalikan karena parameter yang diperlukan tidak ditentukan.
    403InstanceDiskLimitExceededThe amount of the disk on instance in question reach its limits.Pesan kesalahan yang dikembalikan karena jumlah maksimum disk yang dapat disambungkan ke instans yang ditentukan telah tercapai.
    403InvalidDevice.InUseThe specified device has been occupied.Pesan kesalahan yang dikembalikan karena perangkat yang ditentukan sudah memiliki disk yang disambungkan.
    403DiskNotPortableThe specified disk is not a portable disk.Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak dapat dilepas.
    403InstanceLockedForSecurityThe instance is locked due to security.Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat resource dikunci karena alasan keamanan.
    403ResourcesNotInSameZoneThe specified instance and disk are not in the same zone.Pesan kesalahan yang dikembalikan karena instans dan disk yang ditentukan tidak berada di zona yang sama.
    403InstanceExpiredOrInArrearsThe specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).Pesan kesalahan yang dikembalikan karena instans langganan telah kedaluwarsa. Perbarui instans tersebut dan coba lagi.
    403DiskInArrearsThe specified operation is denied as your disk owing fee.Pesan kesalahan yang dikembalikan karena Anda memiliki pembayaran tertunda untuk disk tersebut.
    403DiskErrorIncorrectDiskStatus.Pesan kesalahan yang dikembalikan karena status disk yang ditentukan tidak valid.
    403DiskId.ValueNotSupportedThe specified parameter diskid is not supported.Pesan kesalahan yang dikembalikan karena kategori perangkat Elastic Block Storage (EBS) yang ditentukan tidak mendukung operasi ini.
    403DiskId.StatusNotSupportedThe specified disk status is not supported.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat disk berada dalam status saat ini.
    403IncorrectDiskStatusThe operation is not supported in this status.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat disk berada dalam status saat ini. Pastikan disk tersedia dan Anda tidak memiliki pembayaran tertunda untuk disk tersebut.
    403UserNotInTheWhiteListThe user is not in disk white list.Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk mengelola disk tersebut. Coba lagi setelah Anda mendapatkan otorisasi.
    403InvalidParameter.KMSKeyId.CMKNotEnabledThe CMK needs to be enabled.Pesan kesalahan yang dikembalikan karena kunci master pelanggan (CMK) tidak diaktifkan saat ID kunci KMS ditentukan untuk disk. Anda dapat memanggil operasi DescribeKey dari KMS untuk mengkueri informasi tentang CMK yang ditentukan.
    403InvalidParameter.KMSKeyId.KMSUnauthorizedECS service have no right to access your KMS.Pesan kesalahan yang dikembalikan karena Elastic Compute Service (ECS) tidak memiliki otorisasi untuk mengakses resource KMS Anda.
    403InvalidInstanceType.NotSupportDiskCategoryThe instanceType of the specified instance does not support this disk category.Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan oleh parameter InstanceType tidak mendukung kategori disk dari instans tersebut. Coba gunakan tipe instans lain. Untuk informasi mengenai kategori disk yang didukung oleh tipe instans, lihat dokumentasi keluarga instans.
    403InvalidInstanceType.NvmeRequiredThe instanceType of the specified instance requires nvme protocol.Pesan kesalahan yang dikembalikan karena tipe instans dari instans yang ditentukan tidak menggunakan protokol NVMe.
    403InvalidInstanceType.NvmeUnsupportedThe instanceType of the specified instance does not support nvme protocol.Pesan kesalahan yang dikembalikan karena tipe instans dari instans yang ditentukan tidak mendukung protokol NVMe.
    403InvalidInstanceType.NotSupportMultiAttachDiskThe instanceType of the specified instance does not support multi attach disk.Pesan kesalahan yang dikembalikan karena disk yang telah diaktifkan fitur multi-attach tidak dapat disambungkan ke instans dengan tipe instans yang ditentukan.
    403DiskAttachedNumberExceededThe attaching times of the specified disk exceeded.Pesan kesalahan yang dikembalikan karena jumlah maksimum instans tempat disk yang ditentukan dapat disambungkan telah tercapai.
    403InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDiskMulti attach disk can not be attached as system disk.Pesan kesalahan yang dikembalikan karena disk yang telah diaktifkan fitur multi-attach tidak dapat disambungkan sebagai sistem disk.
    403DeleteWithInstance.ConflictMulti attach disk cannot be set to DeleteWithInstance attribute.Pesan kesalahan yang dikembalikan karena atribut DeleteWithInstance tidak valid untuk disk yang telah diaktifkan fitur multi-attach.
    404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.
    404InvalidDiskId.NotFoundThe specified disk does not exist.Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
    404InvalidDisk.InUseThe specified disk has been occupied.Pesan kesalahan yang dikembalikan karena disk yang ditentukan sedang digunakan.
    500InternalErrorThe request processing has failed due to some unknown error.Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
    500InternalErrorThe request processing has failed due to some unknown error, exception or failure.Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

    Untuk daftar kode kesalahan, kunjungi API Error Center.