All Products
Search
Document Center

File Storage NAS:CreateAutoSnapshotPolicy

Last Updated:Jun 25, 2026

Membuat kebijakan snapshot otomatis.

Deskripsi operasi

  • Fitur ini berada dalam pratinjau publik gratis. Selama pratinjau publik, Perjanjian Tingkat Layanan (SLA) File Storage NAS tidak dijamin.

  • Hanya Advanced Extreme NAS yang mendukung fitur ini.

  • Anda dapat membuat maksimal 100 kebijakan snapshot otomatis per akun Alibaba Cloud di setiap wilayah.

  • Jika sistem file berisi data Tingkat Tinggi dan waktu yang diperlukan untuk membuat snapshot otomatis melebihi interval antara dua pengatur waktu yang dijadwalkan, pengatur waktu berikutnya akan dilewati secara otomatis. Misalnya, Anda menetapkan 09:00, 10:00, 11:00, dan 12:00 sebagai pengatur waktu snapshot otomatis. Karena sistem file berisi data Tingkat Tinggi, pembuatan snapshot dimulai pada pukul 09:00 dan selesai pada pukul 10:20, memakan waktu 80 menit. Sistem melewati pengatur waktu 10:00 dan membuat snapshot otomatis berikutnya pada pukul 11:00.

  • Setiap sistem file mendukung maksimal 128 snapshot otomatis. Setelah Kuota snapshot tercapai, sistem secara otomatis menghapus snapshot otomatis yang paling awal. Snapshot manual tidak terpengaruh.

  • Saat Anda mengubah periode retensi kebijakan snapshot otomatis, perubahan hanya berlaku untuk snapshot baru. Snapshot yang ada mempertahankan periode retensi aslinya.

  • Jika snapshot otomatis sedang dibuat untuk sistem file, Anda harus menunggu hingga snapshot otomatis selesai sebelum dapat membuat snapshot secara manual.

  • Kebijakan snapshot otomatis tidak dapat dijalankan pada sistem file yang tidak dalam status Normal.

  • Snapshot otomatis mengikuti format penamaan terpadu: auto_yyyyMMdd_X. Dalam format ini, auto menunjukkan snapshot otomatis, membedakannya dari snapshot manual. yyyyMMdd menunjukkan tanggal pembuatan snapshot, di mana y mewakili tahun, M mewakili bulan, dan d mewakili hari. X menunjukkan nomor urut snapshot otomatis yang dibuat pada hari tersebut. Misalnya, auto_20201018_1 menunjukkan snapshot otomatis pertama yang dibuat pada 18 Oktober 2020.

  • Kebijakan snapshot otomatis yang telah dibuat dapat diterapkan ke sistem file apa pun dengan memanggil ApplyAutoSnapshotPolicy, dan konten kebijakan dapat diubah dengan memanggil ModifyAutoSnapshotPolicy..

.

  • Fitur ini berada dalam pratinjau publik gratis. Selama pratinjau publik, Perjanjian Tingkat Layanan (SLA) File Storage NAS tidak dijamin.

  • Hanya Advanced Extreme NAS yang mendukung fitur ini.

  • Anda dapat membuat maksimal 100 kebijakan snapshot otomatis per akun Alibaba Cloud di setiap wilayah.

  • Jika sistem file berisi data Tingkat Tinggi dan waktu yang diperlukan untuk membuat snapshot otomatis melebihi interval antara dua pengatur waktu yang dijadwalkan, pengatur waktu berikutnya akan dilewati secara otomatis. Misalnya, Anda menetapkan 09:00, 10:00, 11:00, dan 12:00 sebagai pengatur waktu snapshot otomatis. Karena sistem file berisi data Tingkat Tinggi, pembuatan snapshot dimulai pada pukul 09:00 dan selesai pada pukul 10:20, memakan waktu 80 menit. Sistem melewati pengatur waktu 10:00 dan membuat snapshot otomatis berikutnya pada pukul 11:00.

  • Setiap sistem file mendukung maksimal 128 snapshot otomatis. Setelah Kuota snapshot tercapai, sistem secara otomatis menghapus snapshot otomatis yang paling awal. Snapshot manual tidak terpengaruh.

  • Saat Anda mengubah periode retensi kebijakan snapshot otomatis, perubahan hanya berlaku untuk snapshot baru. Snapshot yang ada mempertahankan periode retensi aslinya.

  • Jika snapshot otomatis sedang dibuat untuk sistem file, Anda harus menunggu hingga snapshot otomatis selesai sebelum dapat membuat snapshot secara manual.

  • Kebijakan snapshot otomatis tidak dapat dijalankan pada sistem file yang tidak dalam status Normal.

  • Snapshot otomatis mengikuti format penamaan terpadu: auto_yyyyMMdd_X. Dalam format ini, auto menunjukkan snapshot otomatis, membedakannya dari snapshot manual. yyyyMMdd menunjukkan tanggal pembuatan snapshot, di mana y mewakili tahun, M mewakili bulan, dan d mewakili hari. X menunjukkan nomor urut snapshot otomatis yang dibuat pada hari tersebut. Misalnya, auto_20201018_1 menunjukkan snapshot otomatis pertama yang dibuat pada 18 Oktober 2020.

  • Kebijakan snapshot otomatis yang telah dibuat dapat diterapkan ke sistem file apa pun dengan memanggil ApplyAutoSnapshotPolicy, dan konten kebijakan dapat diubah dengan memanggil ModifyAutoSnapshotPolicy..

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

nas:CreateAutoSnapshotPolicy

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

RepeatWeekdays

string

Yes

Hari dalam seminggu saat snapshot otomatis dibuat.

Siklus: minggu.

Nilai valid: 1 hingga 7, yang mewakili Senin hingga Minggu.

Untuk membuat snapshot otomatis pada beberapa hari dalam seminggu, tentukan beberapa nilai yang dipisahkan dengan koma (,). Anda dapat menentukan maksimal 7 nilai.

1,2,3

TimePoints

string

Yes

Pengatur waktu saat snapshot otomatis dibuat.

Unit: hours.

Nilai valid: 0 hingga 23, yang mewakili 24 pengatur waktu dari 00:00 hingga 23:00. Misalnya, 1 menunjukkan 01:00.

Untuk membuat beberapa snapshot otomatis dalam satu hari, tentukan beberapa pengatur waktu yang dipisahkan dengan koma (,). Anda dapat menentukan maksimal 24 pengatur waktu.

0,1,…,23

RetentionDays

integer

No

Periode retensi snapshot otomatis.

Unit: days.

Nilai valid:

  • -1 (default): Snapshot otomatis dipertahankan secara permanen. Ketika Kuota snapshot tercapai, snapshot otomatis yang paling awal akan dihapus secara otomatis.

  • 1 hingga 65536: Snapshot otomatis dipertahankan selama jumlah hari yang ditentukan. Snapshot akan mengalami pelepasan otomatis setelah periode retensi berakhir.

30

AutoSnapshotPolicyName

string

No

Nama kebijakan snapshot otomatis.

Batasan:

  • Nama harus memiliki panjang 2 hingga 128 karakter.

  • Nama harus dimulai dengan huruf atau karakter Tionghoa.

  • Nama dapat berisi angka, titik dua (:), garis bawah (_), atau tanda hubung (-). Nama tidak dapat dimulai dengan http:// atau https://.

  • Nilai default: kosong.

FinanceJoshua

FileSystemType

string

Yes

Tipe sistem file.

Nilai valid: extreme (Extreme NAS).

Valid values:

  • extreme :

    Extreme NAS.

extreme

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

AutoSnapshotPolicyId

string

ID kebijakan snapshot otomatis.

sp-extreme-233e6****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "AutoSnapshotPolicyId": "sp-extreme-233e6****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.