All Products
Search
Document Center

Elastic Compute Service:ResizeDisk

Last Updated:Jul 28, 2026

Memperluas kapasitas cloud disk, termasuk cloud disk sistem dan cloud disk data.

Deskripsi operasi

Catatan

Sebelum memperluas disk, kueri format partisi disk. Jika disk menggunakan format partisi MBR, Anda tidak dapat memperluas disk hingga lebih dari 2 TiB. Jika tidak, loss data dapat terjadi. Untuk memperluas disk yang dipartisi MBR, buat dan sambungkan cloud disk data baru, gunakan format partisi GPT, lalu salin data yang ada ke cloud disk data baru. Untuk informasi selengkapnya, lihat Memperluas kapasitas disk.

  • Tipe disk yang didukung meliputi disk dasar (cloud), disk ultra (cloud_efficiency), SSD standar (cloud_ssd), SSD Perusahaan (ESSD) (cloud_essd), disk ESSD AutoPL (cloud_auto), elastic ephemeral disk - Jenis Penyimpanan Standar (elastic_ephemeral_disk_standard), elastic ephemeral disk - Premium (elastic_ephemeral_disk_premium), dan regional ESSD (cloud_regional_disk_auto).

  • Disk yang sedang dibuat snapshot-nya tidak dapat diperluas. Tunggu hingga pembuatan snapshot selesai sebelum memperluas disk.

  • Operasi ini tidak memperluas partisi atau sistem file. Setelah memperluas kapasitas disk, Anda harus mengalokasikan partisi dan sistem file secara manual. Untuk informasi selengkapnya, lihat Memperluas partisi dan sistem file (Linux) dan Memperluas partisi dan sistem file (Windows).

  • Disk dengan fitur multi-attach yang diaktifkan mendukung perluasan online dan offline. Pastikan instans tempat disk disambungkan memenuhi kondisi berikut:

    • Untuk scale-out online, status instans harus Running (Running).

    • Untuk scale-out offline, status instans harus Running (Running) atau Stopped (Stopped).

  • Pastikan disk memenuhi kondisi berikut:

    • Disk berada dalam status In Use (In Use) atau Available (Available).

    • (Sangat direkomendasikan) Snapshot telah dibuat untuk disk sebagai cadangan data. Untuk informasi selengkapnya, lihat Membuat snapshot.

    • Jika cloud disk data baru dibeli, inisialisasi disk sebelum memperluasnya. Untuk informasi selengkapnya, lihat Ikhtisar inisialisasi.

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

update

*Disk.

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DiskId

string

Yes

ID disk. Anda dapat memanggil DescribeDisks untuk mengkueri ID disk.

d-bp67acfmxazb4p****

Type

string

No

Metode yang digunakan untuk memperluas disk. Nilai valid:

  • offline (default): perluasan offline. Setelah perluasan, Anda harus memulai ulang instans di Konsol dengan mengikuti instruksi di Memulai ulang instans atau dengan memanggil operasi RebootInstance agar perubahan berlaku.

  • online: perluasan online. Perluasan berlaku tanpa memulai ulang instans. Tipe disk yang didukung meliputi disk ultra, SSD standar, SSD Perusahaan (ESSD), dan elastic ephemeral disk.

offline.

NewSize

integer

Yes

Kapasitas disk baru yang ingin Anda perluas. Unit: GiB. Nilai valid:

  • Disk sistem:

    • Disk dasar: 20 hingga 500.

    • SSD Perusahaan (ESSD):
      • PL0: 1 hingga 2048.

      • PL1: 20 hingga 2048.

      • PL2: 461 hingga 2048.

      • PL3: 1261 hingga 2048.

    • Disk ESSD AutoPL: 1 hingga 2048.

    • Tipe disk lainnya: 20 hingga 2048.

  • Disk data:

    • Disk ultra (cloud_efficiency): 20 hingga 32768.

    • SSD standar (cloud_ssd): 20 hingga 32768.

    • SSD Perusahaan (ESSD) (cloud_essd): Nilai valid bergantung pada nilai PerformanceLevel. Anda dapat memanggil DescribeDisks untuk mengkueri informasi disk lalu memeriksa nilai valid berdasarkan parameter PerformanceLevel dalam tanggapan.
      • PL0: 1 hingga 65536.

      • PL1: 20 hingga 65536.

      • PL2: 461 hingga 65536.

      • PL3: 1261 hingga 65536.

    • Disk dasar (cloud): 5 hingga 2000.

    • Disk ESSD AutoPL (cloud_auto): 1 hingga 65536.

    • Elastic ephemeral disk - Jenis Penyimpanan Standar (elastic_ephemeral_disk_standard): 64 hingga 8.192.

    • Elastic ephemeral disk - Premium (elastic_ephemeral_disk_premium): 64 hingga 8.192.

Catatan

Kapasitas disk baru yang ditentukan harus lebih besar dari kapasitas disk asli. Jika tidak, error akan dikembalikan.

1900

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 dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

123e4567-e89b-12d3-a456-426655440000

Elemen respons

Element

Type

Description

Example

object

OrderId

string

ID pesanan.

Catatan

ID pesanan hanya dikembalikan ketika Anda memperluas disk langganan.

20413515388****

RequestId

string

ID permintaan.

F3CD6886-D8D0-4FEE-B93E-1B732396****

Contoh

Respons sukses

JSONformat

{
  "OrderId": "20413515388****",
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidDataDiskSize.ValueNotSupported The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the snapshot exceeds the size limit of the specified disk category.
400 InvalidParameter.Conflict %s Operasi saat ini tidak mengizinkan diskId dan imageId ditentukan pada waktu yang sama. Pastikan diskId atau imageId tidak kosong.
400 IncompleteParamter Some fields can not be null in this request. Parameter yang diperlukan hilang dari permintaan.
400 InvalidRegionId.MalFormed The specified RegionId is not valid.
400 InvalidParam.Type The specified type is not supported. Parameter Type yang ditentukan tidak valid.
400 LastOrderProcessing The previous order is still processing. Please try again later.
400 InvalidStatus.Upgrading The instance which the disk attachs is upgrading; please try again later.
400 InvalidSystemDiskSize.ImageNotSupportResize The image of the instance does not support resize.
400 InvalidDisk.DetachedSystemDisk The specified disk is a detached system disk. This operation is not supported.
400 OperationDenied.NotEnoughCapacity The capacity of the current dedicated block storage cluster is not enough to expand.
400 IncorrectDiskStatus.ReplicationStatusNotFound Disk replication status not found.
400 IncorrectDiskStatus.InReplication Disk already in replication.
400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s. Kapasitas yang digunakan dari Tipe disk yang ditentukan telah melebihi batas kuota zona aktif. Anda dapat pergi ke Pusat Kuota untuk kueri dan meminta peningkatan kuota kapasitas disk.
400 NoPermission.Price The operation requires price permission. Please either apply for permission from your main account or set the parameter AutoPay to true.
400 NoPermission.Refund The operation requires refund permission. Please apply for permission from your main account. Akun anggota tidak memiliki izin untuk memproses pengembalian dana. Akun utama harus memberikan izin terkait pengembalian dana.
400 InvalidOperation.InstanceRenewWithDowngradeInPlan The operation is denied due to the specified instance has renew with downgrade record in plan. Terdapat pesanan perpanjangan dan menurunkan spesifikasi yang belum berlaku. Operasi ini tidak diizinkan sebelum pesanan berlaku.
400 InvalidSystemDiskSize.ValueNotSupported The specified system disk size is invalid. SystemDisk.Size yang ditentukan tidak valid.
400 OperationDenied.UnfinishedOrder The current instance has an unfinished refund order. This operation is denied.
400 AccountForbidden.CreateOrder Order cannot be created due to abnormal account. Akun saat ini tidak diizinkan membuat pesanan.
500 InternalError The request processing has failed due to some unknown error.
403 InvalidDataDiskSize.ValueNotSupported The specified DataDisk.n.Size is beyond the permitted range; or the capacity of the snapshot exceeds the size limit of the specified disk category.
403 OperationDenied The type of the disk does not support the operation. EIP yang ditentukan tidak tersedia atau tidak diotorisasi.
403 InvalidDiskSize.TooSmall Specified new disk size is less than the original disk size.
403 InvalidDiskSize.TooLarge Specified new disk size is beyond the permitted range.
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403 DiskError Incorrect disk status.
403 DiskInArrears The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet.
403 InvalidDiskSize Specified new disk size is less than or equal the original disk size. Ukuran disk baru yang ditentukan harus lebih besar dari ukuran disk asli.
403 Operation.Conflict The operation may conflict with others. Please retry later.
403 InstanceLockedForSecurity The instance is locked due to security. Instans terkunci karena alasan keamanan. Hubungi dukungan teknis keamanan.
403 IncorrectDiskStatus The current disk status does not support this operation.
403 UserNotInTheWhiteList The user is not in disk white list. Pengguna tidak berada dalam daftar operasi parameter terkait ARN.
403 InvalidDiskCategory.NotSupported The specified disk category is not supported. Tipe disk yang ditentukan tidak didukung di zona saat ini. Ubah tipe disk atau ganti zona, lalu coba lagi.
403 InvalidRegion.NotSupport The specified region does not support resize online. Wilayah tidak mendukung Bring Your Own Key (BYOK).
403 InvalidInstanceStatus.NotRunning The status of instance to which the disk attachs must be running when resizing online. Saat mengubah ukuran disk secara online, instans tempat disk disambungkan harus dalam status Running.
403 InvalidOperation.InstanceTypeNotSupportOnlineResize The instance type of the specified instance does not support resize online.
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.CMKNotEnabled The CMK needs to be enabled.
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 InstanceSpecModification.NotEffective The instance which the disk attachs has been reserved for making a spec modification and not taken effective in the current contract period.
403 InvalidDiskSize.NotSupportResizeOnline The current size of the resource does not support resize online.
403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. Risiko keamanan terdeteksi pada kartu kredit atau debit default Anda. Verifikasi identitas Anda menggunakan tautan dalam email.
403 QuotaExceeded.PostpaidDataDiskCapacity The quota of postpaid data disk capacity exceeds. Kapasitas disk data pay-as-you-go melebihi kuota.
403 InvalidOperation.MultiAttachDiskNotSupportResizeOnline Multi attach disk does not support resize online. Ekspansi online tidak didukung untuk disk dengan fitur multi-attach yang menyambungkan.
403 InvalidDataDiskCategory.ValueNotSupported The specified Category of Data Disk is not valid. Parameter DataDisk.Category yang ditentukan tidak valid.
403 InvalidDiskSize.NotSupportMultiAttachDisk The specified disk size exceeds the maximum limit 65536 for enabling multi-attach. Disk yang lebih besar dari 64 TB tidak mendukung multi-menyambungkan.
404 InvalidDiskId.NotFound The specified disk does not exist. Disk tertentu tidak ada.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. ID instans yang ditentukan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.