All Products
Search

This Product

    Elastic Compute Service:AttachDisk

    Document Center

    Elastic Compute Service:AttachDisk

    Last Updated:Jul 14, 2026

    Menyambungkan disk data atau disk sistem ke Instans ECS.

    Deskripsi operasi

    Saat memanggil operasi ini, perhatikan hal-hal berikut:

    • Instans dan disk harus berada di zona yang sama.

    • Disk harus dalam status Tersedia (Available).

    • Saat menyambungkan disk data:

      • Instans ECS tujuan harus dalam status Berjalan (Running) atau Dihentikan (Stopped).

      • Jika disk dibeli secara terpisah, metode penagihan harus pay-as-you-go.

      • Disk sistem yang telah dilepas dari Instans ECS dapat disambungkan sebagai disk data tanpa batasan metode penagihan.

      • Disk ephemeral elastis yang telah dilepas hanya dapat disambungkan kembali ke Instans aslinya.

    • Saat menyambungkan disk sistem:

      • Instance ECS tujuan harus merupakan instans asli tempat disk sistem dilepas.

      • Instance ECS tujuan harus dalam status Dihentikan (Stopped).

      • Anda harus menentukan kredensial logon untuk instans.

      • Disk ephemeral elastis tidak dapat disambungkan sebagai disk sistem.

      • Untuk informasi lebih lanjut tentang penyambungan disk sistem, lihat Melepas atau menyambungkan disk sistem.

    • Saat mengkueri informasi Instans ECS, jika tanggapan berisi {"OperationLocks": {"LockReason" : "security"}}, semua operasi dilarang.

    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:AttachDisk

    update

    *Disk

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

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
    • ecs:LoginAsNonRoot
    • ecs:PasswordCustomized
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    ID Instans ECS tempat Anda ingin menyambungkan disk.

    i-bp1dq5lozx5f4pmd****
    DiskId

    string

    Yes

    ID disk yang akan disambungkan. Disk (DiskId) dan instans (InstanceId) harus berada di zona yang sama.

    Catatan

    Baik disk data maupun disk sistem dapat disambungkan. Untuk batasan terkait, lihat bagian deskripsi operasi di atas.

    d-bp1j4l5axzdy6ftk****
    Device

    string

    No

    Nama perangkat disk.

    Catatan

    Parameter ini akan segera dihentikan. Untuk meningkatkan kompatibilitas, gunakan parameter lain untuk mengidentifikasi disk.

    testDeviceName
    DeleteWithInstance

    boolean

    No

    Apakah akan melepas disk saat instans dilepas. Nilai valid:

    • true: Disk dilepas bersama dengan instans.

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

    Nilai default: false.

    Saat menetapkan parameter ini, perhatikan hal-hal berikut:

    • Jika Anda menetapkan DeleteWithInstance ke false dan Instans ECS terkunci karena alasan keamanan, artinya OperationLocks berisi "LockReason" : "security", parameter ini diabaikan saat instans dilepas, dan disk dilepas bersama dengan instans.

    • Jika disk yang akan disambungkan adalah disk ephemeral elastis, Anda harus menetapkan DeleteWithInstance ke true.

    • Disk dengan fitur multi-attach yang diaktifkan tidak mendukung parameter ini.

    false
    Bootable

    boolean

    No

    Apakah akan menyambungkan disk sebagai disk sistem. Nilai valid:

    • true: Disk disambungkan sebagai disk sistem.

    • false: Disk tidak disambungkan sebagai disk sistem.

    Nilai default: false.

    Catatan

    Jika Anda menetapkan Bootable=true, Instans ECS tujuan tidak boleh memiliki disk sistem yang tersambung.

    false
    Password

    string

    No

    Kata sandi yang ditetapkan untuk instans saat Anda menyambungkan disk sistem. Kata sandi hanya berlaku untuk nama pengguna administrator dan root, dan tidak berlaku untuk nama pengguna lainnya. Panjang kata sandi harus 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Karakter khusus berikut didukung:

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

    Untuk instans Windows, kata sandi tidak boleh dimulai dengan garis miring (/).

    Catatan

    Jika Anda menentukan parameter Password, kirim permintaan melalui HTTPS untuk mencegah kebocoran kata sandi.

    EcsV587!
    KeyPairName

    string

    No

    Nama pasangan kunci SSH yang diikat ke Instans ECS Linux saat Anda menyambungkan disk sistem.

    • Instans Windows Server: Pasangan kunci SSH tidak didukung. Meskipun parameter ini ditentukan, hanya konfigurasi Password yang berlaku.

    • Instans Linux: Metode logon berbasis kata sandi dinonaktifkan secara default.

    KeyPairTestName
    Force

    boolean

    No

    Apakah akan menyambungkan disk secara paksa. Nilai valid:

    • true: Menyambungkan disk secara paksa.

    • false: Tidak menyambungkan disk secara paksa.

    Nilai default: false.

    Catatan

    Saat ini, hanya ESSD regional (cloud_regional_disk_auto) yang mendukung pengaturan parameter ini ke true.

    false

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDevice.Malformed The specified device is not valid.
    400 IncorrectInstanceStatus The current status of the resource does not support this operation. Operasi tidak diizinkan karena status instans tidak mendukungnya.
    400 InvalidParameter The input parameter is mandatory for processing this request is empty. Kombinasi parameter yang ditentukan tidak valid.
    400 InvalidRegionId.MalFormed The specified RegionId is not valid.
    400 InvalidOperation.InstanceTypeNotSupport The instance type of the specified instance does not support hot attach disk. Instans tempat disk menyambungkan tidak mendukung hot swapping disk.
    400 DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category. Disk yang ditentukan tidak mendukung operasi ini karena pembatasan tipe disk.
    400 InvalidDisk.DiskNotBootable The specified disk is not a bootable disk. It cannot be attached as a system disk.
    400 InvalidInstance.NotOriginInstance The specified disk can not attached to other instance as system disk.
    400 InvalidParameterForce.DiskCategoryNotSupported The specified disk category does not support force attach operation. Tipe disk yang ditentukan tidak mendukung operasi menyambungkan paksa.
    400 InvalidParameterForce.PrepaidDiskNotSupported The prepaid disk does not support force attach operation. Disk langganan tidak mendukung operasi menyambungkan paksa.
    400 InvalidParameterForce.MultiAttachDiskNotSupported The multi attach disk does not support force attach operation. Disk multi-attach tidak mendukung operasi menyambungkan paksa.
    400 InvalidParameterForce.RegionNotSupported The specified region does not support force attach operation. Wilayah ini tidak mendukung operasi menyambungkan paksa.
    400 OperationConflict.DisksAttachingParallellyExceed The number of disks attaching parallelly exceeds the limit. Jumlah disk yang menyambungkan secara paralel melebihi batas.
    400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the image architecture. Arsitektur image yang ditentukan tidak mendukung tipe instans ini.
    500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
    403 InstanceDiskLimitExceeded The number of disks attached to the instance has exceeded the limit.
    403 InvalidDevice.InUse The specified device has been occupied.
    403 DiskNotPortable The specified disk is not a portable disk.
    403 InstanceLockedForSecurity The instance is locked due to security. Instans terkunci karena alasan keamanan. Hubungi dukungan teknis keamanan.
    403 ResourcesNotInSameZone The specified instance and disk are not in the same zone.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
    403 DiskInArrears The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
    403 DiskError IncorrectDiskStatus.
    403 DiskId.ValueNotSupported The specified parameter diskid is not supported. Tipe penyimpanan blok yang ditentukan tidak mendukung operasi ini.
    403 DiskId.StatusNotSupported The specified disk status is not supported. Status disk saat ini tidak mendukung operasi ini.
    403 IncorrectInstanceStatus.NotSupportESSD The operation is not supported in this status. Please reboot the instance.
    403 IncorrectDiskStatus The operation is not supported in this status. Status disk tidak mendukung operasi ini. Disk harus berada dalam status InUse atau Available untuk melanjutkan.
    403 UserNotInTheWhiteList The user is not in disk white list. Pengguna tidak berada dalam daftar operasi parameter terkait ARN.
    403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled.
    403 InvalidParameter.KMSKeyId.CMKUnauthorized The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
    403 DependencyViolation.WindowsInstance The instance image is Windows. SSH key pair login is not supported.
    403 InvalidInstanceType.NotSupportDiskCategory The instanceType of the specified instance does not support this disk category. Tipe instans (InstanceType) yang ditentukan tidak mendukung kategori disk dari instans saat ini. Coba gunakan tipe instans lain. Untuk informasi tentang Tipe disk yang didukung oleh setiap tipe instans, lihat dokumentasi keluarga instans.
    403 InvalidInstanceType.NotSupportPL0 The instanceType of the specified instance does not support PL0 of cloud_essd.
    403 InvalidInstanceType.NvmeRequired The instanceType of the specified instance requires nvme protocol. Tipe instans yang ditentukan memerlukan protokol NVMe.
    403 InvalidInstanceType.NvmeUnsupported The instanceType of the specified instance does not support nvme protocol. Tipe instans yang ditentukan tidak mendukung protokol NVMe.
    403 InvalidInstanceType.NotSupportMultiAttachDisk The instanceType of the specified instance does not support multi attach disk. Tipe instans yang ditentukan tidak mendukung menyambungkan disk dengan fitur multi-attach diaktifkan.
    403 DiskAttachedNumberExceeded The attaching times of the specified disk exceeded. Jumlah instans tempat disk yang ditentukan menyambungkan telah mencapai batas atas.
    403 InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk Multi attach disk can not be attached as system disk. Disk dengan fitur multi-attach yang diaktifkan tidak dapat digunakan sebagai disk sistem.
    403 DeleteWithInstance.Conflict Multi attach disk cannot be set to DeleteWithInstance attribute. Gambar yang ditentukan berasal dari Alibaba Cloud Marketplace dan tidak mendukung penonaktifan rilis bersama instans.
    403 InvalidParameter.DeleteWithInstance The DeleteWithInstance for the elastic ephemeral disk must be set to true. Atribut DeleteWithInstance untuk disk ephemeral elastis harus diatur ke true.
    403 InvalidOperation.OtherInstanceUnsupported The elastic ephemeral disk can only be attached to the instance it was last mounted on. Please check the disk system tag to get the last associated instance.
    403 InvalidInstance.ZoneConflict The force attach operation is not supported when both the current and target instances are in the same zone. Penyambungan paksa mengharuskan instans saat ini dan instans target berada di zona yang berbeda.
    403 InvalidParameter.AllEmpty The current operation requires either a password or a keyPairName to must be provided. Please ensure that at least one of them is not empty. password dan keyPairName tidak boleh kosong untuk operasi ini. Pastikan setidaknya satu dari password atau keyPairName ditentukan.
    403 InvalidOperation.DiskQueueNumberNotEnough The number of disk queues on the instance is not enough. Instans tidak memiliki kapasitas Antrian disk yang cukup.
    403 InvalidOperation.DiskAttachModeUnsupported The instance type does not support the disk attach mode. Tipe instans saat ini tidak mendukung mode Port disk.
    403 OperationDenied.HpnZoneMismatch Instance and disk must be in the same HPN zone for restricted HPN zones. Untuk zona HPN yang dibatasi sebagian, instans dan disk harus berada di zona HPN yang sama untuk melakukan operasi menyambungkan.
    403 OperationDenied.UnsupportedEncryptedDisk The instance type does not support attaching encrypted disks. Tipe instans tidak mendukung menyambungkan disk terenkripsi.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist. ID instans yang ditentukan tidak valid.
    404 InvalidDiskId.NotFound The specified disk does not exist. Disk tertentu tidak ada.
    404 InvalidDisk.InUse The specified disk has been occupied.
    404 DiskAttachedNumberExceeded The attaching times of the specified disk exceeded.
    404 InvalidKMSKeyId.NotFound The KMS key used by the disk does not exist. ID kunci KMS yang ditentukan tidak ada.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.