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
Categorysebagai 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, danDisableInstantAccessdalam operasi API, tidak lagi berlaku. Operasi APIDescribeSnapshotsdanDescribeSnapshotGroupsakan 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
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:CreateSnapshot |
create |
*Disk
*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 Catatan
Nama tidak boleh dimulai dengan |
testSnapshotName |
| Description |
string |
No |
Deskripsi snapshot. Panjang deskripsi harus 2 hingga 256 karakter dan tidak boleh dimulai dengan 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:
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:
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 Nilai default: sama dengan nilai parameter 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.