All Products
Search
Document Center

Elastic Compute Service:CreateSnapshot

Last Updated:Jul 14, 2026

Membuat snapshot untuk sebuah disk.

Deskripsi operasi

Fitur snapshot lokal telah digantikan oleh fitur akses instan snapshot. Deskripsi metrik adalah sebagai berikut:

  • Jika Anda menggunakan snapshot lokal sebelum 14 Desember 2020, Anda dapat menggunakan parameter Category sebagai Normal.

  • Jika Anda tidak menggunakan snapshot lokal sebelum 14 Desember 2020, tidak diperlukan konfigurasi tambahan. Snapshot baru yang dibuat untuk disk seri ESSD (ESSD, ESSD AutoPL, ESSD Entry, dan ESSD regional) aktif secara instan secara default, dan mendukung snapshot manual maupun snapshot otomatis. Tiga parameter terkait akses instan snapshot, yaitu InstantAccess, InstantAccessRetentionDays, dan DisableInstantAccess dalam operasi API, tidak lagi berlaku. Operasi API DescribeSnapshots dan DescribeSnapshotGroups akan menyertakan parameter respons baru bernama Available untuk menjelaskan status aktif snapshot.

Sebelum memulai:

  • Aktifkan fitur snapshot. Untuk informasi lebih lanjut, lihat Mengaktifkan snapshot.

  • Disk harus berada dalam status In Use atau Unattached. Perhatikan hal-hal berikut untuk status yang berbeda:

    • Jika disk berada dalam status In Use, Instans harus berada dalam status Running atau Stopped.

    • Jika disk berada dalam status Unattached, disk harus pernah dilampirkan ke Instance ECS sebelumnya. Snapshot tidak dapat dibuat untuk disk yang belum pernah dilampirkan ke Instance ECS.

    • Saat disk digunakan untuk membuat volume extended dinamis atau array RAID, gunakan kelompok konsisten snapshot dan aktifkan snapshot konsisten aplikasi untuk mencadangkan data. Kelompok konsisten snapshot memastikan konsistensi urutan tulis dan konsistensi crash untuk data yang ditulis ke beberapa disk dalam sistem bisnis. Untuk informasi lebih lanjut, lihat Membuat kelompok konsisten snapshot dan Membuat snapshot konsisten aplikasi.

Saat membuat snapshot, perhatikan hal-hal berikut:

  • Hindari membuat snapshot selama jam sibuk bisnis. Saat snapshot sedang dibuat, kinerja I/O disk menurun hingga 10%, dan kinerja baca serta tulis mungkin terpengaruh sebentar.

  • Jika snapshot belum dibuat, snapshot tersebut tidak dapat digunakan untuk membuat gambar kustom (CreateImage).

  • Data inkremental yang dihasilkan oleh operasi disk selama pembuatan snapshot tidak dicadangkan ke snapshot.

  • Jika disk dilampirkan ke Instance ECS, jangan mengubah status instans selama pembuatan snapshot, seperti menghentikan atau memulai ulang Instance ECS. Jika tidak, pembuatan snapshot akan gagal.

  • Disk yang sedang dibuat snapshotnya tidak mendukung penskalaan keluar. Tunggu hingga snapshot selesai dibuat sebelum Anda menjalankan operasi penskalaan keluar.

  • Anda dapat membuat snapshot untuk disk dalam status Expired (Expired). Jika disk mencapai waktu pelepasan kedaluwarsa selama pembuatan snapshot, disk akan dilepaskan dan snapshot dalam status Creating (Creating) juga dihapus.

  • Setelah snapshot dibuat, sistem menghitung biaya berdasarkan ukuran snapshot di setiap wilayah secara terpisah. Untuk informasi lebih lanjut, lihat Penagihan snapshot.

  • Dalam skenario berikut, Anda tidak dapat membuat snapshot untuk disk yang ditentukan:

    • Jumlah snapshot manual yang dipertahankan untuk disk telah mencapai batas atas. Untuk informasi lebih lanjut, lihat Batas snapshot.

    • Pembuatan snapshot memiliki batas konkurensi. Melebihi batas menyebabkan kegagalan pembuatan. Untuk informasi lebih lanjut, lihat Batas snapshot.

    • Saat Anda mengkueri informasi Instans ECS, jika data yang dikembalikan 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:CreateSnapshot

create

*Disk

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

*Snapshot

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DiskId

string

Yes

ID disk.

d-bp1s5fnvk4gn2tws0****

SnapshotName

string

No

Nama snapshot. Panjang nama harus 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi karakter Unicode dalam kategori huruf (termasuk huruf dalam bahasa Inggris dan Tiongkok), digit ASCII (0-9), titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-).

Catatan

Nama tidak boleh dimulai dengan auto untuk menghindari konflik dengan nama snapshot otomatis.

testSnapshotName

Description

string

No

Deskripsi snapshot. Panjang deskripsi harus 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.

Nilai default: null.

testDescription

RetentionDays

integer

No

Pengaturan periode retensi snapshot. Unit: hari. Nilai valid: 1 hingga 65536. Snapshot akan subjected to pelepasan otomatis ketika periode retensi berakhir.

Nilai default: null, yang menunjukkan bahwa snapshot tidak subjected to pelepasan otomatis.

30

Category

string

No

Tipe snapshot. Nilai valid:

  • Standard: snapshot Jenis Penyimpanan Standar.

  • Flash: snapshot lokal.

Catatan

Parameter ini akan dihentikan. Snapshot Jenis Penyimpanan Standar SSD enterprise telah ditingkatkan menjadi akses instan secara default. Tidak diperlukan konfigurasi atau biaya tambahan. Ini berlaku untuk SSD enterprise, disk ESSD AutoPL, disk ESSD Entry, dan SSD enterprise regional. Snapshot Jenis Penyimpanan Standar SSD standar juga aktif secara default.

Standard

ClientToken

string

No

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

123e4567-e89b-12d3-a456-426655440000

ResourceGroupId

string

No

ID kelompok sumber daya tempat snapshot berada.

rg-bp67acfmxazb4p****

InstantAccess

boolean

No

Apakah akan mengaktifkan fitur akses instan snapshot. Nilai valid:

  • true: mengaktifkan fitur. Hanya SSD enterprise yang mendukung fitur ini.

  • false: menonaktifkan. Snapshot Jenis Penyimpanan Standar dibuat.

Nilai default: false.

Catatan

Parameter ini sudah tidak digunakan lagi. Snapshot Jenis Penyimpanan Standar SSD enterprise telah ditingkatkan menjadi akses instan secara default. Tidak diperlukan konfigurasi atau biaya tambahan. Ini berlaku untuk SSD enterprise, disk ESSD AutoPL, disk ESSD Entry, dan SSD enterprise regional. Snapshot Jenis Penyimpanan Standar SSD standar juga aktif secara default.

false

InstantAccessRetentionDays

integer

No

Pengaturan periode retensi fitur akses instan snapshot. Setelah periode retensi berakhir, snapshot akan subjected to pelepasan otomatis. Parameter ini hanya berlaku ketika InstantAccess=true. Unit: hari. Nilai valid: 1 hingga 65535.

Nilai default: sama dengan nilai parameter RetentionDays.

Catatan

Parameter ini sudah tidak digunakan lagi. Snapshot Jenis Penyimpanan Standar SSD enterprise telah ditingkatkan menjadi akses instan secara default. Tidak diperlukan konfigurasi atau biaya tambahan. Ini berlaku untuk SSD enterprise, disk ESSD AutoPL, disk ESSD Entry, dan SSD enterprise regional. Snapshot Jenis Penyimpanan Standar SSD standar juga aktif secara default.

1

Tag

array<object>

No

Tag.

object

No

Tag.

key

string

No

Kunci tag snapshot.

Catatan

Untuk tujuan kompatibilitas, gunakan parameter Tag.N.Key.

null

Key

string

No

Kunci tag snapshot. 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 snapshot. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung http:// atau https://.

TestValue

value

string

No

Nilai tag snapshot.

Catatan

Untuk tujuan kompatibilitas, gunakan parameter Tag.N.Value.

null

StorageLocationArn

string

No

Catatan

Parameter ini tidak tersedia untuk umum.

null

Elemen respons

Element

Type

Description

Example

object

SnapshotId

string

ID snapshot.

s-bp17441ohwka0yuh****

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "SnapshotId": "s-bp17441ohwka0yuh****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist.
400 InvalidSnapshotName.Malformed The specified SnapshotName is malformed.
400 IncorrectInstanceStatus The current status of the resource does not support this operation. Operasi tidak diizinkan karena status instans tidak mendukungnya.
400 DiskCategory.OperationNotSupported The type of the specified disk does not support creating a snapshot. Disk yang ditentukan tidak mendukung operasi ini karena pembatasan tipe disk.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Terdapat kunci duplikat dalam tag. Pastikan kunci unik.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. Kunci tag yang ditentukan tidak valid. Kunci tag tidak boleh kosong atau null, dapat berisi hingga 128 karakter, dan tidak boleh dimulai dengan "aliyun" atau "acs:" atau mengandung "http://" atau "https://".
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Nilai tag yang ditentukan tidak valid. Nilai tag dapat berisi hingga 128 karakter dan tidak boleh mengandung "http://" atau "https://".
400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid. Hari retensi yang ditentukan tidak valid. Pastikan nilai parameter RetentionDays benar.
400 CreateSnapshot.Failed The process of creating snapshot is failed. Terjadi kesalahan saat memproses permintaan. Coba lagi nanti. Jika permintaan Anda menggunakan idempotensi, buat ulang token idempotensi dan coba lagi.
500 InternalError The request processing has failed due to some unknown error.
403 Throttling Request was denied due to user flow control. Permintaan mengalami pembatasan kecepatan. Gunakan metode paginasi berbasis NextToken, bukan metode paginasi berbasis PageNumber.
403 IncorrectDiskStatus.CreatingSnapshot A previous snapshot creation is in process.
403 InstanceLockedForSecurity The disk attached instance is locked due to security.
403 IncorrectDiskStatus.NeverAttached The specified disk has never been attached to any instance.
403 QuotaExceed.Snapshot The snapshot quota exceeds.
403 IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating.
403 CreateSnapshot.Failed The process of creating snapshot is failed.
403 DiskInArrears The specified operation is denied as your disk has expired.
403 DiskId.ValueNotSupported The specified parameter diskid is not supported. Tipe penyimpanan blok yang ditentukan tidak mendukung operasi ini.
403 IncorrectDiskStatus The current disk status does not support this operation.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. Layanan snapshot tidak diaktifkan. Operasi tidak dapat dilakukan.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 IncorrectVolumeStatus The current volume status does not support this operation. Status saat ini dari perangkat Shared Block Storage tidak mendukung operasi ini.
403 IdempotentParameterMismatch The specified clientToken is used. Token klien yang ditentukan sudah digunakan.
403 IncorrectDiskStatus.Invalid The specified disk status is invalid. Restart the instance and try again.
403 IncorrectDiskType.NotSupport The specified device type is not supported. Tipe penyimpanan dari disk yang ditentukan tidak mendukung operasi ini.
403 IncorrectDiskStatus.Transferring The specified device is transferring. You can retry after the process is finished.
403 InvalidParameter.KMSKeyId.CMKUnauthorized ECS tags must be added to the CMK. ECS tidak memiliki izin untuk mengenkripsi atau mendekripsi CMK Anda.
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 IdempotentProcessing The previous idempotent request(s) is still processing. Permintaan idempoten sebelumnya masih sedang diproses. Coba lagi nanti.
403 InvalidSnapshotCategory.Malformed The specified Category is not valid. Jenis snapshot yang ditentukan tidak valid. Periksa apakah nilai parameter Category benar.
403 InvalidAction.Unauthorized The specified action is not valid. Operasi yang ditentukan tidak valid.
403 InvalidRegion.NotSupportSnapshotInstantAccessRegion The snapshot InstantAccess is not supported for this region.
403 InvalidCategoryAndInstantAccess.Malformed The snapshot Category and InstantAccess can't be used together.
403 DISK_HAS_CREATING_SNAPSHOT The operation cannot be performed while a snapshot is being created for the disk.
403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. Operasi tidak diizinkan karena instans tidak memenuhi persyaratan untuk mengaktifkan opsi hibernasi.
403 QuotaExceed.SnapshotQuota The quota is insufficient. Please contact your channel partner to increase the quota.
403 InvalidInstantAccessRetentionDays.Malformed The specified InstantAccessRetentionDays is not valid. Parameter InstantAccessRetentionDays yang ditentukan memiliki format tidak valid.
403 CloudBoxNotSupportSnapshotWithInstantAccess The specified disk in CloudBox does not support to create a snapshot with InstantAccess. Disk di CloudBox tidak mendukung pembuatan snapshot dengan fitur akses instan.
403 InvalidOperation.UnfinishedEncryptedSnapshotCopy This disk has unfinished encrypted copy snapshots in the target region. Disk memiliki tugas salin snapshot terenkripsi yang sedang berlangsung.
403 QuotaExceed.ConcurrentSnapshotQuota The number of snapshots being created for the disk %s has exceeded the concurrent quota (%s). Please wait for the previous snapshots to complete before trying again. Jumlah snapshot yang sedang dibuat untuk disk ini telah melebihi kuota konkurensi. Tunggu hingga snapshot sebelumnya selesai dan coba lagi.
403 InvalidClientToken.Malformed The specified clientToken is improperly formatted. It must contain only ASCII characters and must not exceed 64 characters in length. Parameter ClientToken yang ditentukan tidak memenuhi persyaratan format. Parameter hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.
403 InvalidParameter.UnauthorizedStorageLocationArn The operation has failed due to lack of permission for the specified "StorageLocationArn". Please use a resource with appropriate permission for the operation. Operasi gagal karena StorageLocationArn yang ditentukan tidak memiliki izin yang cukup. Hubungi administrator Sumber daya untuk mendapatkan izin yang diperlukan.
403 InvalidStorageLocationArn.Malformed The specified parameter StorageLocationArn is malformed.
403 InvalidStatus.ResourceGroup You cannot perform an operation on a resource group that is being created or deleted. Operasi tidak diizinkan saat kelompok sumber daya sedang dibuat atau dihapus.
403 OperationDenied.QuotaExceed The quota of tags on resource is beyond permitted range. Jumlah maksimum tag Sumber daya telah tercapai.
404 InvalidDiskId.NotFound The specified DiskId does not exist. Disk tertentu tidak ada.
404 InvalidDescription.Malformed The specified description is malformed.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. ID instans yang ditentukan tidak valid.
404 InvalidVolumeId.NotFound The specified volume does not exist.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. Kelompok sumber daya yang ditentukan tidak ditemukan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.