ModifyAutoSnapshotPolicyEx - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengubah kebijakan snapshot otomatis, seperti pengatur waktu pembuatan snapshot, tanggal pengulangan, dan periode retensi.

Deskripsi operasi

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Kebijakan sistem tidak dapat diubah.
Setelah Anda mengubah kebijakan snapshot otomatis, disk yang telah menerapkan kebijakan tersebut akan langsung menjalankan kebijakan snapshot otomatis yang telah dimodifikasi.
Jika replikasi snapshot lintas wilayah diaktifkan dan tidak ada parameter enkripsi yang dikonfigurasi, snapshot terenkripsi akan dienkripsi secara default menggunakan kunci layanan wilayah tujuan.

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

update

*Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshotpolicy/{#autoSnapshotPolicyId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
regionId	string	Yes	ID wilayah kebijakan snapshot otomatis. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
autoSnapshotPolicyId	string	Yes	ID kebijakan snapshot otomatis. Anda dapat memanggil DescribeAutoSnapshotPolicyEx untuk mengkueri kebijakan snapshot otomatis yang tersedia.	sp-bp12m37ccmxvbmi5****
autoSnapshotPolicyName	string	No	Nama kebijakan snapshot otomatis. Jika parameter ini dikosongkan, nama tidak akan diubah.	SPTestName
timePoints	string	No	Waktu pembuatan snapshot otomatis. Waktu ditampilkan dalam UTC+8. Unit: hours. Nilai valid: 0 hingga 23, yang sesuai dengan 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: Anda dapat menentukan hingga 24 pengatur waktu. Tentukan beberapa pengatur waktu dalam array JSON, seperti `"0", "1", … "23"`. Pisahkan pengatur waktu dengan koma (,).	["0", "1"]
repeatWeekdays	string	No	Hari dalam seminggu saat snapshot otomatis dibuat. Unit: days. Siklusnya mingguan. Nilai valid: 1 hingga 7. Misalnya, 1 menunjukkan Senin. Untuk membuat beberapa snapshot otomatis dalam satu minggu, tentukan beberapa hari: Anda dapat menentukan hingga 7 hari. Tentukan beberapa hari dalam array JSON, seperti `"1", "2", … "7"`. Pisahkan hari dengan koma (,).	["1", "7"]
retentionDays	integer	No	Periode retensi snapshot otomatis. Unit: days. Nilai valid: -1: Snapshot otomatis disimpan secara permanen. 1 hingga 65536: Snapshot otomatis disimpan selama jumlah hari yang ditentukan. Nilai default: -1.	30
EnableCrossRegionCopy	boolean	No	Apakah akan mengizinkan replikasi lintas wilayah secara otomatis. true: Diizinkan. false: Tidak diizinkan.	false
TargetCopyRegions	string	No	Wilayah tujuan tempat snapshot direplikasi lintas wilayah. Saat ini, Anda hanya dapat mengatur satu wilayah tujuan.	["cn-hangzhou"]
CopiedSnapshotsRetentionDays	integer	No	Periode retensi replika snapshot lintas wilayah. Unit: days. Nilai valid: -1: Replika snapshot disimpan secara permanen. 1 hingga 65535: Replika snapshot disimpan selama jumlah hari yang ditentukan. Nilai default: -1.	30
CopyEncryptionConfiguration	object	No	Objek parameter enkripsi untuk replikasi snapshot lintas wilayah.
Arn	array<object>	No	Parameter ini tidak tersedia untuk publik.
	object	No
AssumeRoleFor	integer	No	Parameter ini tidak tersedia untuk publik.	1000000000
RoleType	string	No	Parameter ini tidak tersedia untuk publik.	hide
Rolearn	string	No	Parameter ini tidak tersedia untuk publik.	hide
Encrypted	boolean	No	Apakah akan mengaktifkan enkripsi untuk replikasi snapshot lintas wilayah. Nilai valid: true: Diaktifkan. false: Dinonaktifkan. Nilai default: false.	false
KMSKeyId	string	No	ID kunci KMS yang digunakan untuk replikasi snapshot lintas wilayah terenkripsi.	0e478b7a-4262-4802-b8cb-00d3fb40826X
TargetTags	array<object>	No	Daftar tag Sumber daya target. Kebijakan snapshot otomatis mencocokkan Sumber daya target berdasarkan tag.
	object	No	Tag Sumber daya target.
Key	string	No	Kunci tag. Nilai valid N: 1 hingga 5. Kunci tag tidak boleh berupa string kosong. Kunci tag dapat memiliki panjang hingga 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.
Value	string	No	Nilai tag. Nilai valid N: 1 hingga 5. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh mengandung `http://` atau `https://`. Catatan Jika Anda memasukkan nilai kosong atau string kosong, nilai tag akan mencocokkan nilai apa pun.

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameter.EncryptedIllegal	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
400	InvalidParameter.KmsNotEnabled	The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
400	InvalidParameter.Encrypted.KmsNotEnable	The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
400	InvalidParam.EncryptedMismatch	Creating a disk from a shared encrypted image requires encryption with your own KMS key. Please set the Encrypted parameter to true.
400	InvalidTargetTags.NotSupported	When the parameter AssociationType is set to AssociatedWithDisk, the TargetTags parameter is not supported.
400	InvalidTargetTagKey.Malformed	The specified TargetTag.n.Key [%s] is not valid.
400	InvalidTargetTagValue.Malformed	The specified TargetTag.n.Value [%s] is not valid.
400	Duplicate.TargetTagKey	Duplicate keys exist in the specified parameter TargetTags. Please ensure key uniqueness.
400	InvalidTargetTag.LimitExceed	The number [%s] of the specified parameter TargetTag exceeds the limit [%s].
403	ParameterInvalid	The specified RegionId parameter is invalid.	Kebijakan snapshot otomatis yang ditentukan tidak ada. Periksa apakah kebijakan snapshot otomatis benar.
403	InvalidParameter.TargetCopyRegions	The specified TargetCopyRegions is invalid.
403	InvalidParameter.CopiedSnapshotsRetentionDays	The specified CopiedSnapshotsRetentionDays is invalid.
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	Abs.InvalidAction.RegionNotSupport	This region does not support this action.	Wilayah ini tidak mendukung operasi ini.
403	InvalidOperation.PolicyTypeUnsupported	The current policy type does not support this operation. Only custom policies are permitted.	Jenis kebijakan saat ini tidak mendukung operasi ini. Hanya kebijakan kustom yang mengizinkan operasi ini.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InvalidOperation.CopyingDataToThisRegionUnsupported	Data transfer to the current region from other regions is not supported.	Hanya wilayah tertentu yang dapat mereplikasi data ke wilayah saat ini.
404	ParameterInvalid	The specified automatic snapshot policy does not exist.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.