CreateAutoSnapshotPolicy - - Alibaba Cloud Documentation Center

Membuat kebijakan snapshot otomatis di Wilayah tertentu. Kebijakan snapshot otomatis memungkinkan Elastic Compute Service (ECS) membuat Snapshot dan mencadangkan data disk secara berkala, baik untuk disk sistem maupun disk data.

Description

Saat memanggil operasi ini untuk membuat kebijakan snapshot otomatis, Anda dapat menentukan hari dalam seminggu untuk pembuatan Snapshot otomatis, periode retensi Snapshot tersebut, serta apakah Snapshot dalam kebijakan tersebut direplikasi lintas wilayah guna memenuhi berbagai kebutuhan pencadangan data. Setelah kebijakan dibuat, Anda harus memanggil operasi ApplyAutoSnapshotPolicy untuk menerapkannya pada disk. Untuk mengubah kebijakan snapshot otomatis, panggil operasi ModifyAutoSnapshotPolicyEx.

Perhatikan hal-hal berikut saat memanggil operasi ini:

Anda dapat membuat hingga 100 kebijakan snapshot otomatis di setiap Wilayah untuk satu Akun Alibaba Cloud.
Jika proses pembuatan Snapshot otomatis masih berlangsung saat jadwal Snapshot berikutnya tiba, tugas Snapshot baru tersebut akan dilewati. Hal ini umum terjadi pada disk dengan volume data besar. Misalnya, Anda menjadwalkan pembuatan Snapshot pada pukul 09.00.00, 10.00.00, 11.00.00, dan 12.00.00 untuk sebuah disk. Sistem mulai membuat Snapshot pada pukul 09.00.00, tetapi proses tersebut memerlukan 80 menit karena volume data yang besar dan selesai pada pukul 10.20.00. Akibatnya, sistem melewatkan tugas Snapshot yang dijadwalkan pada pukul 10.00.00 dan melanjutkan dengan Snapshot berikutnya pada pukul 11.00.00.
Untuk informasi tentang cara menyalin Snapshot dari satu Wilayah ke Wilayah lain, lihat bagian "Informasi latar belakang" dalam Copy a snapshot.

Debugging

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

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateAutoSnapshotPolicy	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateAutoSnapshotPolicy.
regionId	String	Yes	cn-hangzhou	ID Wilayah tempat membuat kebijakan snapshot otomatis. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar Wilayah terbaru.
autoSnapshotPolicyName	String	No	TestName	Nama kebijakan snapshot otomatis. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-). Parameter ini kosong secara default.
timePoints	String	Yes	["0", "1", … "23"]	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 pada setiap jam dari pukul 00:00:00 hingga 23:00:00. Nilai 1 merepresentasikan pukul 01:00:00. Anda harus mengatur parameter ini sebagai array dalam format JSON. Contohnya, nilai ["1"] menentukan pembuatan snapshot otomatis pada pukul 01:00:00. Untuk menjadwalkan beberapa snapshot otomatis dalam satu hari, Anda dapat menentukan beberapa nilai. Pisahkan nilai-nilai tersebut dengan koma (,). Anda dapat menentukan maksimal 24 titik waktu. Contohnya, nilai ["1","3","5"] menentukan pembuatan snapshot otomatis pada pukul 01:00:00, 03:00:00, dan 05:00:00.
repeatWeekdays	String	Yes	["1","2"]	Hari dalam seminggu saat snapshot otomatis dibuat. Nilai yang valid: 1 hingga 7, yang masing-masing merepresentasikan Senin hingga Minggu. Angka 1 menunjukkan hari Senin. Atur parameter ini sebagai array dalam format JSON. Contohnya, nilai ["1"] menentukan pembuatan snapshot otomatis setiap hari Senin. Untuk menjadwalkan pembuatan beberapa snapshot otomatis dalam satu minggu, Anda dapat menentukan beberapa nilai. Pisahkan nilai-nilai tersebut dengan koma (,). Anda dapat menentukan maksimal tujuh hari. Contohnya, nilai ["1","3","5"] menentukan pembuatan snapshot otomatis setiap hari Senin, Rabu, dan Jumat.
retentionDays	Integer	Yes	30	Periode retensi untuk Snapshot otomatis. Satuan: hari. Nilai yang valid: -1: Snapshot dipertahankan secara permanen. 1 hingga 65535: Snapshot otomatis dipertahankan selama jumlah hari yang ditentukan. Nilai default: -1.
EnableCrossRegionCopy	Boolean	No	false	Menentukan apakah akan mengaktifkan replikasi cross-region untuk Snapshot. true: mengaktifkan replikasi cross-region untuk Snapshot. false: menonaktifkan replikasi cross-region untuk Snapshot.
TargetCopyRegions	String	No	["cn-hangzhou"]	Wilayah tujuan tempat menyalin Snapshot. Anda hanya dapat menetapkan satu Wilayah tujuan.
CopiedSnapshotsRetentionDays	Integer	No	30	Periode retensi copy Snapshot di wilayah tujuan. Satuan: hari. Nilai yang valid: -1: Copy Snapshot dipertahankan secara permanen. 1 hingga 65535: Copy Snapshot dipertahankan selama jumlah hari yang ditentukan. Nilai default: -1.
ResourceGroupId	String	No	rg-aek2kkmhmhs****	ID kelompok sumber daya tempat kebijakan snapshot otomatis tersebut berada.
Tag.N.Key	String	No	TestKey	Kunci tag N dari kebijakan snapshot otomatis. Nilai N yang valid: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjangnya dapat mencapai 128 karakter dan tidak boleh diawali dengan acs: atau aliyun. Kunci tag juga tidak boleh mengandung http:// atau https://.
Tag.N.Value	String	No	TestValue	Nilai tag N dari kebijakan snapshot otomatis. Nilai N yang valid: 1 hingga 20. Nilai tag dapat berupa string kosong. Panjangnya maksimal 128 karakter. Nilai tersebut tidak boleh diawali dengan acs: atau mengandung http:// maupun https://.

Response parameters

Parameter	Type	Example	Description
AutoSnapshotPolicyId	String	sp-bp12m37ccmxvbmi5****	ID kebijakan snapshot otomatis.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=CreateAutoSnapshotPolicy
&regionId=cn-hangzhou
&repeatWeekdays=["1"]
&retentionDays=30
&timePoints=["0", "19"]
&autoSnapshotPolicyName=TestName
&<Common request parameters>

Contoh respons sukses

XML format

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

<CreateAutoSnapshotPolicyResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
    <AutoSnapshotPolicyId>sp-bp12m37ccmxvbmi5****</AutoSnapshotPolicyId>
</CreateAutoSnapshotPolicyResponse>

JSON format

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

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B73239673DE",
  "AutoSnapshotPolicyId" : "sp-bp12m37ccmxvbmi5****"
}

Error codes

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Description
400	DiskCategory.OperationNotSupported	The type of the specified disk does not support creating a snapshot.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh kategori disk saat ini.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Pesan kesalahan yang dikembalikan karena kunci tag yang ditentukan sudah ada. Kunci tag harus unik.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Pesan kesalahan yang dikembalikan karena parameter Tag.N.Key yang ditentukan tidak valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Pesan kesalahan yang dikembalikan karena parameter Tag.N.Value yang ditentukan tidak valid.
403	ParameterInvalid	The specified RegionId parameter is invalid.	Pesan kesalahan yang dikembalikan karena parameter regionId yang ditentukan tidak valid.
403	ParameterInvalid	The specified RepeatWeekDays parameter is invalid.	Pesan kesalahan yang dikembalikan karena parameter repeatWeekDays yang ditentukan tidak valid.
403	ParameterInvalid	The specified TimePoints parameter is invalid.	Pesan kesalahan yang dikembalikan karena parameter timePoints yang ditentukan tidak valid.
403	ParameterInvalid	The specified RetentionDays parameter is invalid.	Pesan kesalahan yang dikembalikan karena parameter retentionDays yang ditentukan tidak valid.
403	AutoSnapshotPolicy.QuotaExceed	The maximum number of automatic snapshot policy has been reached.	Pesan kesalahan yang dikembalikan karena jumlah maksimum kebijakan snapshot otomatis telah tercapai.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Pesan kesalahan yang dikembalikan karena saldo akun Anda tidak mencukupi. Tambahkan dana ke akun Anda dan coba lagi.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung selama layanan snapshot belum diaktifkan.

Untuk daftar kode kesalahan, kunjungi API Error Center.