CreateAutoSnapshotPolicy - - Alibaba Cloud Dokümantasyon Merkezi

Belirtilen bir bölgede otomatik anlık görüntü ilkesi oluşturur. Sistem diskleri veya veri diskleri için anlık görüntü yedekleri oluşturmak üzere tekrar döngüsünü, saklama süresini ve bölgeler arası yedekleme ayarlarını belirtebilirsiniz.

Operation description

Bu işlemi çağırmadan önce Otomatik anlık görüntü ilkesi oluşturma belgesini dikkatlice okuyun.

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

Bir Alibaba Cloud hesabı, bir bölgede en fazla 100 otomatik anlık görüntü ilkesi oluşturabilir. Bir disk için otomatik anlık görüntü sayısı kota sınırına ulaştığında, sistem yeni bir anlık görüntü görevi oluştururken otomatik anlık görüntü ilkesi tarafından oluşturulan en eski otomatik anlık görüntüyü siler.
Bir ECS örneğinde durdurma veya yeniden başlatma görevi olduğunda sistem otomatik anlık görüntü ilkesini yürütmez.
Bölgeler arası anlık görüntü çoğaltması etkinleştirilmiş ve şifreleme parametreleri yapılandırılmamışsa, şifrelenmiş anlık görüntüler varsayılan olarak hedef hizmet anahtarı kullanılarak kopyalanır ve şifrelenir. Bölgeler arası anlık görüntü çoğaltmasıyla ilgili önlemler için Anlık görüntü kopyalama konusuna bakın.

Otomatik anlık görüntü ilkesi oluşturduktan sonra, ilkeyi hedef diske uygulamak için ApplyAutoSnapshotPolicy işlemini çağırmalısınız. Otomatik anlık görüntü ilkesini değiştirmek için ModifyAutoSnapshotPolicyEx işlemini çağırın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ecs:CreateAutoSnapshotPolicy

create

*Otomatik Anlık Görüntü Politikası.

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

None

Request parameters

Parameter	Type	Required	Description	Example
regionId	string	Yes	Otomatik anlık görüntü ilkesinin ait olduğu bölge. En son bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.	cn-hangzhou
autoSnapshotPolicyName	string	No	Otomatik anlık görüntü ilkesinin adı. Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harf veya Çince karakterle başlamalıdır ve http:// veya https:// ile başlayamaz. Rakamlar, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir. Varsayılan değer: null.	TestName
timePoints	string	Yes	Otomatik anlık görüntülerin oluşturulduğu zaman noktaları. Saat UTC+8 dilimindedir ve saat cinsinden ölçülür. Geçerli değerler: 00:00'dan 23:00'e kadar olan 24 zaman noktasını temsil eden 0 ila 23. Örneğin, 1 değeri 01:00'ı belirtir. Biçim açıklaması: Parametre JSON dizisi biçiminde olmalıdır. Örneğin, ["1"] otomatik anlık görüntülerin 01:00'da oluşturulduğunu belirtir. Bir gün içinde birden fazla otomatik anlık görüntü oluşturmak istiyorsanız, virgülle (,) ayrılmış birden fazla zaman noktası belirtebilirsiniz. En fazla 24 zaman noktası belirtebilirsiniz. Örneğin, ["1","3","5"] otomatik anlık görüntülerin 01:00, 03:00 ve 05:00 saatlerinde oluşturulduğunu belirtir. Not Disk büyük miktarda veri içeriyorsa ve tek bir otomatik anlık görüntü oluşturma süresi iki zaman noktası arasındaki aralığı aşıyorsa, sistem bir sonraki zaman noktasını atlar. Örneğin, zaman noktalarını 09:00, 10:00, 11:00 ve 12:00 olarak ayarlarsanız ve oluşturma işlemi 09:00'da başlayıp 80 dakika sürerek 10:20'de biterse, sistem 10:00'ı atlar ve bir sonraki otomatik anlık görüntüyü 11:00'da oluşturur.	["0", "1", … "23"]
repeatWeekdays	string	Yes	Otomatik anlık görüntülerin oluşturulduğu haftanın günleri. Geçerli değerler: Pazartesiden Pazarı temsil eden 1 ila 7. Örneğin, 1 değeri Pazartesi gününü belirtir. Biçim açıklaması: Parametre JSON dizisi biçiminde olmalıdır. Örneğin, ["1"] otomatik anlık görüntülerin her Pazartesi oluşturulduğunu belirtir. Haftada birden fazla kez otomatik anlık görüntü oluşturmak istiyorsanız, virgülle (,) ayrılmış birden fazla gün belirtebilirsiniz. En fazla 7 gün belirtebilirsiniz. Örneğin, ["1","3","5"] otomatik anlık görüntülerin her Pazartesi, Çarşamba ve Cuma günleri oluşturulduğunu belirtir.	["1","2"]
retentionDays	integer	Yes	Otomatik anlık görüntülerin saklama süresi. Birim: gün. Geçerli değerler: -1: Anlık görüntüler kalıcı olarak saklanır. 1 ila 65535: Anlık görüntüler belirtilen gün sayısı kadar saklanır. Varsayılan değer: -1.	30
EnableCrossRegionCopy	boolean	No	Otomatik bölgeler arası çoğaltmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true: Evet. false: Hayır.	false
TargetCopyRegions	string	No	Bölgeler arası anlık görüntü çoğaltması için hedef bölge. Yalnızca bir hedef bölge belirtebilirsiniz.	["cn-hangzhou"]
StorageLocationArn	string	No	Not Bu parametre kullanılamaz.	null
CopiedSnapshotsRetentionDays	integer	No	Bölgeler arası çoğaltılan anlık görüntülerin saklama süresi. Birim: gün. Geçerli değerler: -1: Anlık görüntüler kalıcı olarak saklanır. 1 ila 65535: Anlık görüntüler belirtilen gün sayısı kadar saklanır. Varsayılan değer: -1.	30
CopyEncryptionConfiguration	object	No	Anlık görüntü coğrafi yedekliliği için yedekleme şifreleme parametresi nesnesi.
Arn	array<object>	No	Not Bu parametre kullanılamaz.
	object	No
AssumeRoleFor	integer	No	Not Bu parametre kullanılamaz.	1000000000
RoleType	string	No	Not Bu parametre kullanılamaz.	hide
Rolearn	string	No	Not Bu parametre kullanılamaz.	hide
Encrypted	boolean	No	Bölgeler arası anlık görüntü yedeklemesi için şifrelemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true: Evet. false: Hayır. Varsayılan değer: false.	false
KMSKeyId	string	No	Anlık görüntü coğrafi yedekliliğinin yedekleme şifrelemesi için kullanılan KMS anahtar kimliği.	0e478b7a-4262-4802-b8cb-00d3fb40826X
ResourceGroupId	string	No	Kaynak grubunun kimliği.	rg-aek2kkmhmhs****
Tag	array<object>	No	Otomatik anlık görüntü ilkesinin etiket listesi.
	object	No
Key	string	No	Otomatik anlık görüntü ilkesinin etiket anahtarı. N için geçerli değerler: 1 ila 20. Bu parametreyi belirtirseniz boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz ya da http:// veya https:// içeremez.	TestKey
Value	string	No	Otomatik anlık görüntü ilkesinin etiket değeri. N için geçerli değerler: 1 ila 20. Bu parametreyi belirtirseniz boş bir dize olabilir. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve acs: ile başlayamaz ya da http:// veya https:// içeremez.	TestValue
AssociationType	string	No	Otomatik anlık görüntü ilkesi ile hedef kaynaklar arasındaki ilişkilendirme türü. Geçerli değerler: AssociatedWithDisk: Disklerle ilişkilendirir. AssociatedWithInstanceTag: Örnek etiketleriyle ilişkilendirir. Varsayılan değer: AssociatedWithDisk.	AssociatedWithDisk
TargetTags	array<object>	No	Hedef kaynak etiketlerinin listesi. Otomatik anlık görüntü ilkesi, hedef kaynakları etiketlere göre eşleştirir. `AssociationType`, `AssociatedWithInstanceTag` olarak ayarlandığında bu parametre gereklidir.
	object	No	Hedef kaynak etiketi.
Key	string	No	Etiket anahtarı. N için geçerli değerler: 1 ila 5. Bu parametreyi belirtirseniz boş bir dize olamaz. Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir ve aliyun veya acs: ile başlayamaz ya da http:// veya https:// içeremez.	TestKey
Value	string	No	Etiket değeri. N için geçerli değerler: 1 ila 5. Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve `http://` veya `https://` içeremez. Not Bu parametreyi boş bırakırsanız veya boş bir dize belirtirseniz, bu herhangi bir değeri gösterir.	TestValue

Response elements

Element	Type	Description	Example
	object
AutoSnapshotPolicyId	string	Otomatik anlık görüntü ilkesinin kimliği.	sp-bp12m37ccmxvbmi5****
RequestId	string	İstek kimliği.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Examples

Success response

JSON format

{
  "AutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HTTP status code	Error code	Error message	Description
400	DiskCategory.OperationNotSupported	The type of the specified disk does not support creating a snapshot.	Mevcut disk türü bu işlemi desteklemiyor.
400	InvalidSnapshotPolicyName.Malformed	The specified autoSnapshotPolicyName is malformed.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Etiketlerde yinelenen anahtarlar mevcut. Tüm anahtarların benzersiz olduğundan emin olun.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Belirtilen etiket anahtarı parametresi geçersiz.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Belirtilen etiket değeri parametresi geçersiz.
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	InvalidAssociationType.Malformed	The specified parameter AssociationType is invalid. Please check the valid range for this parameter.
400	MissingParameter.TargetTags	When the parameter AssociationType is set to AssociatedWithInstanceTag, the TargetTags parameter is required.
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.	Belirtilen otomatik anlık görüntü politikası mevcut değil. Otomatik anlık görüntü politikasının doğru olup olmadığını kontrol edin.
403	AutoSnapshotPolicy.QuotaExceed	The maximum number of automatic snapshot policy has been reached.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Anlık görüntü hizmeti etkinleştirilmemiştir. İşlem gerçekleştirilemez.
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	InvalidOperation.KMSKeyIdNotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
403	Abs.InvalidAction.RegionNotSupport	This region does not support this action.	Bölge bu işlemi desteklememektedir.
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	InvalidStorageLocationArn.Malformed	The specified parameter StorageLocationArn is malformed.
403	InvalidOperation.UserNotInWhiteList	The current user is temporarily unable to use this feature. Please submit a ticket for assistance.
403	InvalidOperation.CopyingDataToThisRegionUnsupported	Data transfer to the current region from other regions is not supported.	Yalnızca belirli bölgelerden mevcut bölgeye veri çoğaltılabilir.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kaynak grubu kayıtlarda bulunmamaktadır.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.