All Products
Search

This Product

    Elastic Compute Service:CreateSnapshotGroup

    Document Center

    Elastic Compute Service:CreateSnapshotGroup

    Last Updated:Jun 12, 2026

    Membuat grup snapshot konsisten (snapshot-consistent group) untuk disk pada instance ECS tertentu. Grup snapshot konsisten berisi snapshot yang sesuai dengan satu atau beberapa disk.

    Deskripsi operasi

    Anda dapat menentukan InstanceId untuk membuat grup snapshot konsisten bagi disk pada sebuah instance. Anda juga dapat menggunakan hanya DiskId.N untuk membuat grup snapshot konsisten bagi disk yang terpasang pada beberapa instance ECS di zona yang sama.

    Catatan

    DiskId.N tidak dapat ditentukan bersamaan dengan ExcludeDiskId.N. Selain itu, jika InstanceId ditentukan, DiskId.N hanya dapat digunakan untuk menentukan disk yang terpasang pada instance tersebut. Disk dari beberapa instance berbeda tidak dapat ditentukan.

    Saat membuat grup snapshot konsisten, perhatikan hal-hal berikut:

    • Disk yang akan dibuat snapshot-nya harus dalam status In Use (In_use) atau Unattached (Available).

      • Jika disk dalam status In Use (In_use), instance ECS harus dalam status Running (Running) atau Stopped (Stopped).

      • Jika disk dalam status Unattached (Available), disk tersebut harus pernah terpasang pada instance ECS. Snapshot tidak dapat dibuat untuk disk yang belum pernah terpasang pada instance ECS.

    • Grup snapshot konsisten hanya mendukung ESSD (ESSD, ESSD AutoPL disk, dan ESSD Entry disk).

    • Satu grup snapshot konsisten dapat berisi snapshot dari hingga 16 disk (termasuk system disk dan data disk). Ukuran total disk tidak boleh melebihi 32 TiB.

    • Snapshot yang Anda buat akan disimpan hingga Anda menghapusnya. Untuk menghindari penagihan kapasitas snapshot, hapus snapshot yang tidak lagi diperlukan secara tepat waktu.

    • Disk yang mengaktifkan fitur multi-attach tidak mendukung grup snapshot konsisten. Jika instance memiliki disk dengan fitur multi-attach yang terpasang, Anda harus menggunakan parameter ExcludeDiskId.N untuk mengecualikan disk tersebut.

    Untuk informasi tentang fitur dan penagihan grup snapshot konsisten, lihat Snapshot-consistent group.

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

    create

    Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

    Disk

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region instance. Anda dapat memanggil DescribeRegions untuk mendapatkan daftar terbaru region Alibaba Cloud.

    cn-hangzhou
    InstanceId

    string

    No

    ID instance.

    i-j6ca469urv8ei629****
    InstantAccess

    boolean

    No

    Menentukan apakah akan mengaktifkan fitur instant access untuk snapshot. Nilai yang valid:

    • true: mengaktifkan fitur.

    • false: menonaktifkan fitur.

    Nilai default: false.

    Catatan

    Parameter ini sudah deprecated. Standard snapshot ESSD telah ditingkatkan menjadi instant access secara default. Anda tidak perlu melakukan konfigurasi tambahan, dan tidak ada biaya tambahan yang dikenakan.

    false
    InstantAccessRetentionDays

    integer

    No

    Periode retensi fitur instant access. Satuan: hari. Nilai yang valid: 1 hingga 65535.

    Parameter ini hanya berlaku ketika InstantAccess=true. Fitur instant access akan dinonaktifkan secara otomatis setelah periode retensi berakhir.

    Nilai default: kosong, yang menunjukkan bahwa periode retensi sama dengan periode retensi snapshot.

    Catatan

    Parameter ini sudah deprecated. Standard snapshot ESSD telah ditingkatkan menjadi instant access secara default. Anda tidak perlu melakukan konfigurasi tambahan, dan tidak ada biaya tambahan yang dikenakan.

    1
    Name

    string

    No

    Nama grup snapshot konsisten. Nama harus terdiri dari 2 hingga 128 karakter dan dapat berisi huruf, angka, titik (.), garis bawah (_), tanda hubung (-), dan titik dua (:). Nama harus dimulai dengan huruf atau karakter China dan tidak boleh dimulai dengan http:// atau https://.

    testName
    Description

    string

    No

    Deskripsi. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.

    This is description.
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilai tersebut, tetapi Anda harus memastikan bahwa nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

    123e4567-e89b-12d3-a456-426655440000
    StorageLocationArn

    string

    No

    Catatan

    Parameter ini belum tersedia untuk digunakan.

    null
    ExcludeDiskId

    array

    No

    ID disk pada instance yang tidak perlu dibuat snapshot-nya. Setelah Anda menentukan ID disk, grup snapshot konsisten yang dibuat tidak akan berisi snapshot yang sesuai dengan disk tersebut. Nilai yang valid untuk N: 1 hingga 16.

    Nilai default: kosong, yang menunjukkan bahwa snapshot dibuat untuk semua disk pada instance.

    Catatan

    Parameter ini tidak dapat ditentukan bersamaan dengan DiskId.N.

    d-j6cf7l0ewidb78lq****

    string

    No

    ID disk pada instance yang tidak perlu dibuat snapshot-nya. Setelah Anda menentukan ID disk, grup snapshot konsisten yang dibuat tidak akan berisi snapshot yang sesuai dengan disk tersebut. Nilai yang valid untuk N: 1 hingga 16.

    Nilai default: kosong, yang menunjukkan bahwa snapshot dibuat untuk semua disk pada instance.

    Catatan

    Parameter ini tidak dapat ditentukan bersamaan dengan DiskId.N.

    d-j6cf7l0ewidb78lq****
    DiskId

    array

    No

    ID disk yang akan dibuatkan grup snapshot konsisten. Anda dapat menentukan beberapa ID disk lintas instance dalam zona yang sama. Nilai yang valid untuk N: 1 hingga 16. Ini berarti grup snapshot konsisten dapat berisi snapshot dari hingga 16 disk yang ukuran totalnya tidak melebihi 32 TiB.

    Perhatikan hal-hal berikut:

    • Parameter ini tidak dapat ditentukan bersamaan dengan ExcludeDiskId.N.

    • Jika Anda menentukan InstanceId, Anda hanya dapat menentukan ID disk yang terpasang pada instance tersebut. Disk dari beberapa instance berbeda tidak dapat ditentukan.

    string

    No

    ID disk yang akan dibuatkan grup snapshot konsisten. Anda dapat menentukan beberapa ID disk lintas instance dalam zona yang sama. Nilai yang valid untuk N: 1 hingga 16. Ini berarti grup snapshot konsisten dapat berisi snapshot dari hingga 16 disk yang ukuran totalnya tidak melebihi 32 TiB.

    Perhatikan hal-hal berikut:

    • Parameter ini tidak dapat ditentukan bersamaan dengan ExcludeDiskId.N.

    • Jika Anda menentukan InstanceId, Anda hanya dapat menentukan ID disk yang terpasang pada instance tersebut. Disk dari beberapa instance berbeda tidak dapat ditentukan.

    d-bp1bcpqxahucdrcn****
    Tag

    array<object>

    No

    Daftar tag.

    object

    No

    Key

    string

    No

    Kunci tag N dari grup snapshot konsisten. Nilai yang valid untuk N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Kunci tag tidak boleh berisi http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag N dari grup snapshot konsisten. Nilai yang valid untuk N: 1 hingga 20. Nilai tag boleh berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh dimulai dengan acs:. Nilai tag tidak boleh berisi http:// atau https://.

    TestValue
    ResourceGroupId

    string

    No

    ID resource group tempat grup snapshot konsisten berada.

    rg-bp67acfmxazb4p****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    SnapshotGroupId

    string

    ID grup snapshot konsisten.

    ssg-j6ciyh3k52qp7ovm****
    RequestId

    string

    ID permintaan.

    01ABBD93-1ABB-4D92-B496-1A3D20EC0697

    Contoh

    Respons sukses

    JSONformat

    {
  "SnapshotGroupId": "ssg-j6ciyh3k52qp7ovm****",
  "RequestId": "01ABBD93-1ABB-4D92-B496-1A3D20EC0697"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDiskIds.NotInSameZone The specified disks are not in the same availability zone.
    400 MissingParamter.InstanceId The specified InstanceId should not be null.
    400 InvalidParam.ExcludeDiskIdsAndDiskIds.Conflict The use of parameter 'ExcludeDiskIds' and 'DiskIds' at the same time is not supported.
    400 InvalidSnapshotName.Malformed The specified SnapshotName is wrongly formed.
    400 IncorrectInstanceStatus The current status of the resource does not support this operation.
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid.
    400 InvalidRetentionDays.Malformed The specified RetentionDays is not valid.
    400 DiskCategory.OperationNotSupported The special disk is encrypted, not support this operate.
    400 InvalidParameter.Name The specified Name is invalid.
    400 InvalidParameter.Description The specified Description is invalid.
    500 InternalError The request processing has failed due to some unknown error.
    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.
    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.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation.
    403 IncorrectVolumeStatus The current volume status does not support this operation.
    403 IdempotentParameterMismatch The specified clientToken is used.
    403 IncorrectDiskStatus.Invalid The specified device status invalid, restart instance and try again.
    403 IncorrectDiskType.NotSupport The specified device type is not supported.
    403 IncorrectDiskStatus.Transferring The specified device is transferring, you can retry after the process is finished.
    403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS.
    403 IdempotentProcessing The previous idempotent request(s) is still processing.
    403 InvalidSnapshotCategory.Malformed The specified Category is not valid.
    403 InvalidOperation.Unauthorized The specified operation is unauthorized.
    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 IncorrectDiskStatus.TooManyCreatingSnapshots The specified disk has too many unfinished snapshots.
    403 InvalidRegion.NotSupport The specified region does not support creating snapshot group.
    403 UserNotInTheWhiteList The user is not in the white list of creating snapshot group.
    403 InvalidInstance.NoDisk There is no disk mounted on the instance.
    403 NumberExceed.TooManyDisks The number of all disks in the request exceeds.
    403 CapacityExceed.TooManyDisks The capacity of all disks in the request exceeds.
    403 InvalidOperation.MultiAttachDisk Multi attach disk does not support this operation.
    403 InvalidParameter.KMSKeyId.CMKUnauthorized The CMK needs to be added ECS tag.
    403 InvalidDisk.DiskCategoryInconsistent If any specified disk is of a regional disk category, then all disks must also be of that regional disk category.
    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.
    403 InvalidDisk.ShareVolume The specified diskId is invalid. The shared volume does not support creating a snapshot group.
    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.
    403 InvalidOperation.SnapshotStorageLocationUnsupported Snapshots with storage location in CloudBox do not support the current operation.
    403 InvalidStorageLocationArn.Malformed The specified parameter StorageLocationArn is wrongly formed.
    404 InvalidDiskId.NotFound The specified DiskId does not exist.
    404 InvalidDescription.Malformed The specified description is wrongly formed.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    404 InvalidVolumeId.NotFound The specified volume does not exist.
    404 InvalidRegionId.NotFound The specified RegionId does not exist.
    404 InvalidKMSKeyId.NotFound The KMS key used by the disk does not exist.
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.