All Products
Search

This Product

    :ModifyAutoSnapshotPolicyEx

    Document Center

    :ModifyAutoSnapshotPolicyEx

    Last Updated:May 22, 2026

    Memodifikasi kebijakan snapshot otomatis. Setelah Anda memodifikasi kebijakan snapshot otomatis yang diterapkan pada disk tertentu, perubahan tersebut langsung berlaku untuk disk tersebut.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

    Parameter permintaan

    ParameterTypeRequiredExampleDescription
    ActionStringYesModifyAutoSnapshotPolicyEx

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyAutoSnapshotPolicyEx.

    regionIdStringYescn-hangzhou

    ID Wilayah dari kebijakan snapshot otomatis yang akan dimodifikasi. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    autoSnapshotPolicyIdStringYessp-bp12m37ccmxvbmi5****

    ID kebijakan snapshot otomatis. Anda dapat memanggil operasi DescribeAutoSnapshotPolicyEx untuk mengkueri kebijakan snapshot otomatis yang tersedia.

    autoSnapshotPolicyNameStringNoSPTestName

    Nama kebijakan snapshot otomatis. Jika parameter ini tidak ditentukan, nama asli kebijakan snapshot otomatis akan dipertahankan.

    timePointsStringNo["0", "1"]

    Titik waktu dalam sehari saat snapshot otomatis dibuat. Waktu harus dalam UTC+8. Satuan: jam. Nilai yang valid adalah 0 hingga 23, yang masing-masing merepresentasikan 24 titik waktu tepat setiap jam dari pukul 00:00:00 hingga 23:00:00. Misalnya, nilai 1 menunjukkan pukul 01:00:00.

    Untuk menjadwalkan pembuatan beberapa snapshot otomatis dalam satu hari, Anda dapat menentukan beberapa jam.

    • Anda dapat menentukan hingga 24 titik waktu.
    • Anda harus menetapkan parameter ini sebagai array JSON seperti ["0", "1", ... "23"]. Pisahkan titik waktu dengan koma (,).
    repeatWeekdaysStringNo["1", "7"]

    Hari dalam seminggu saat snapshot otomatis dibuat. Nilai yang valid adalah 1 hingga 7, yang masing-masing merepresentasikan hari dalam seminggu. Misalnya, nilai 1 menunjukkan Senin.

    Untuk menjadwalkan pembuatan beberapa snapshot otomatis dalam satu minggu, Anda dapat menentukan beberapa hari.

    • Anda dapat menentukan hingga tujuh hari dalam periode satu minggu.
    • Anda harus menetapkan parameter ini sebagai array JSON seperti ["1", "2" ... "7"]. Pisahkan nilai dalam array dengan koma (,).
    retentionDaysIntegerNo30

    Periode retensi snapshot otomatis. Satuan: hari. Nilai yang valid:

    • -1: Snapshot otomatis disimpan secara permanen.
    • 1 hingga 65536: Snapshot otomatis disimpan selama jumlah hari yang ditentukan.

    Nilai default: -1.

    EnableCrossRegionCopyBooleanNofalse

    Menentukan apakah replikasi cross-region untuk snapshot otomatis diaktifkan.

    • true: mengaktifkan replikasi cross-region untuk snapshot otomatis.
    • false: menonaktifkan replikasi cross-region untuk snapshot otomatis.
    TargetCopyRegionsStringNo["cn-hangzhou"]

    Wilayah tujuan tempat snapshot disalin. Anda hanya dapat menentukan satu wilayah tujuan.

    CopiedSnapshotsRetentionDaysIntegerNo30

    Periode retensi salinan snapshot di wilayah tujuan. Satuan: hari. Nilai yang valid:

    • -1: Snapshot disimpan secara permanen.
    • 1 hingga 65535: Snapshot otomatis disimpan selama jumlah hari yang ditentukan.

    Nilai default: -1.

    Parameter respons

    ParameterTypeExampleDescription
    RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID permintaan.

    Contoh

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=ModifyAutoSnapshotPolicyEx
&autoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&regionId=cn-hangzhou
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ModifyAutoSnapshotPolicyResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

    Kode kesalahan

    Kode status HTTPKode kesalahanPesan kesalahanDescription
    403ParameterInvalidThe specified RegionId parameter is invalid.Pesan kesalahan yang dikembalikan karena parameter regionId yang ditentukan tidak valid.
    403ParameterInvalidThe specified RepeatWeekDays parameter is invalid.Pesan kesalahan yang dikembalikan karena parameter repeatWeekdays yang ditentukan tidak valid.
    403ParameterInvalidThe specified TimePoints parameter is invalid.Pesan kesalahan yang dikembalikan karena parameter timePoints yang ditentukan tidak valid.
    403ParameterInvalidThe specified AutoSnapshotPolicyId is invalid.Pesan kesalahan yang dikembalikan karena parameter autoSnapshotPolicyId yang ditentukan tidak valid.
    403ParameterInvalidThe specified RetentionDays parameter is invalid.Pesan kesalahan yang dikembalikan karena parameter retentionDays yang ditentukan tidak valid.
    404ParameterInvalidThe specified automatic snapshot policy does not exist.Pesan kesalahan yang dikembalikan karena parameter autoSnapshotPolicyId yang ditentukan tidak ada.
    404ParameterInvalidThe specified automatic snapshot policy does not exist in the region.Pesan kesalahan yang dikembalikan karena parameter autoSnapshotPolicyId yang ditentukan tidak ada.

    Untuk daftar kode kesalahan, kunjungi API Error Center.