All Products
Search

This Product

    Elastic Compute Service:AttachDisk

    Document Center

    Elastic Compute Service:AttachDisk

    Last Updated:Sep 15, 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 berada dalam status Available (Available).

    • Saat menyambungkan disk data:

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

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

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

      • Disk elastis sementara yang telah dilepas hanya dapat disambungkan kembali ke instans asalnya.

    • Saat menyambungkan disk sistem:

      • Instans ECS tujuan harus merupakan instans asal tempat disk sistem dilepas.

      • Instans ECS tujuan harus berada dalam status Stopped (Stopped).

      • Anda harus mengonfigurasi kredensial masuk untuk instans.

      • Disk elastis sementara tidak dapat disambungkan sebagai disk sistem.

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

    • Saat mengkueri informasi Instans ECS, jika tanggapan mengandung {"OperationLocks": {"LockReason" : "security"}}, semua operasi pada instans 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 ditinggalkan. Untuk meningkatkan kompatibilitas, gunakan parameter lain untuk mengidentifikasi disk.

    testDeviceName
    DeleteWithInstance

    boolean

    No

    Apakah akan merilis disk saat instans dirilis. Nilai valid:

    • true: Disk dirilis bersama instans.

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

    Nilai default: false.

    Perhatikan hal-hal berikut saat mengonfigurasi parameter ini:

    • Jika Anda mengatur DeleteWithInstance ke false dan Instans ECS terkunci karena alasan keamanan, yang berarti OperationLocks mengandung "LockReason" : "security", parameter ini diabaikan saat Instans ECS dirilis, dan disk dirilis bersama instans.

    • Jika Anda ingin menyambungkan disk elastic ephemeral disk, Anda harus mengatur 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 mengatur Bootable=true, Instans ECS tujuan tidak boleh memiliki disk sistem yang tersambung.

    false
    Password

    string

    No

    Kata sandi yang diatur untuk instans saat Anda menyambungkan disk sistem. Kata sandi hanya berlaku untuk nama pengguna administrator dan root, serta 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 diawali dengan garis miring (/).

    Catatan

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

    EcsV587!
    KeyPairName

    string

    No

    Nama key pair SSH yang diikat ke Instans ECS Linux saat Anda menyambungkan disk sistem.

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

    • Instans Linux: Metode masuk 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 Wilayah (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. Status instans saat ini tidak mendukung operasi ini.
    400 InvalidParameter The input parameter is mandatory for processing this request is empty. Parameter permintaan saat ini tidak valid. Coba lagi.
    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 disambungkan tidak mendukung hot swapping.
    400 DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category. Tipe disk saat ini tidak mendukung operasi ini.
    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 penyambungan paksa.
    400 InvalidParameterForce.PrepaidDiskNotSupported The prepaid disk does not support force attach operation. Disk langganan tidak mendukung operasi penyambungan paksa.
    400 InvalidParameterForce.MultiAttachDiskNotSupported The multi attach disk does not support force attach operation. Disk multi-sambung tidak mendukung operasi penyambungan paksa.
    400 InvalidParameterForce.RegionNotSupported The specified region does not support force attach operation. Wilayah yang ditentukan tidak mendukung operasi penyambungan paksa.
    400 OperationConflict.DisksAttachingParallellyExceed The number of disks attaching parallelly exceeds the limit. Jumlah disk yang disambungkan secara paralel melebihi batas.
    400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the image architecture. InstanceType yang ditentukan tidak didukung.
    400 InvalidOperation.EncryptedDiskUnsupported The specified encrypted disk is not supported for this operation.
    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 tempat disk tersambung terkunci karena alasan 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 Port 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. Disk saat ini tidak mendukung operasi ini. Pastikan disk digunakan secara normal dan tidak ada pembayaran tertunda.
    403 UserNotInTheWhiteList The user is not in disk white list. Pengguna tidak berada dalam daftar putih Shared Block Storage. Ajukan tiket untuk mendaftar ke daftar putih.
    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) tertentu tidak mendukung kategori disk dari instans saat ini. Coba tipe instans yang berbeda. Untuk informasi tentang kategori 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 diaktifkan tidak dapat digunakan sebagai disk sistem.
    403 DeleteWithInstance.Conflict Multi attach disk cannot be set to DeleteWithInstance attribute. Disk yang ditentukan bukan disk yang dapat dilepas dan tidak mendukung rilis bersama dengan instans.
    403 InvalidParameter.DeleteWithInstance The DeleteWithInstance for the elastic ephemeral disk must be set to true. Properti HapusDenganInstans dari 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. Menyambungkan paksa memerlukan 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. Tidak ada parameter yang ditentukan. Tentukan parameter yang diperlukan.
    403 InvalidOperation.DiskQueueNumberNotEnough The number of disk queues on the instance is not enough. Jumlah antrian disk pada instans tidak mencukupi.
    403 InvalidOperation.DiskAttachModeUnsupported The instance type does not support the disk attach mode. Tipe instans saat ini tidak mendukung mode menyambungkan disk.
    403 OperationDenied.HpnZoneMismatch Instance and disk must be in the same HPN zone for restricted HPN zones. Untuk wilayah HPN yang dibatasi sebagian, instans dan disk harus berada di wilayah HPN yang sama sebelum Anda dapat 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. Instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.
    404 InvalidDiskId.NotFound The specified disk does not exist. Disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
    404 InvalidDisk.InUse The specified disk has been occupied.
    404 DiskAttachedNumberExceeded The attaching times of the specified disk exceeded.
    404 InvalidKMSKeyId.NotFound The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.